Desarrolle integraciones seguras sobre los datos utilizados por las aplicaciones de Eniris. Descubra las empresas y los dispositivos accesibles, gestione las relaciones de metadatos y consulte la telemetría de series temporales de los activos energéticos conectados.
Utilice su cuenta existente. Inicie sesión en la API de autenticación con la misma dirección de correo electrónico y contraseña que utiliza para SmartgridX o la aplicación Eniris. No necesita credenciales de API independientes.
Cada solicitud de API requiere un token de acceso JWT. Obtenga un token a través de la API de autenticación de Eniris utilizando esas credenciales y envíelo con cada solicitud:
Authorization: Bearer <access-token>
La API utiliza HTTPS y JSON. Eniris también proporciona paquetes cliente para Python y npm que implementan el flujo de autenticación y simplifican la comunicación con la API.
Para consultar los esquemas de solicitud, los modelos de respuesta y el explorador interactivo de endpoints actuales, utilice la referencia oficial de la API de Eniris. Prefiera los endpoints nuevos POST .../query en los casos en que la referencia marque un endpoint GET antiguo como reemplazado.
El acceso a la API está destinado a integraciones y exportación de datos y puede estar sujeto a tarifas comerciales. Solicite acceso a la API o información sobre precios.
La siguiente tabla enumera los campos disponibles cuyos datos pueden recuperarse mediante la API de consultas de metadatos y telemetría de Eniris.
Los datos de un campo específico solo están disponibles para las mediciones y políticas de retención indicadas.
| Nombre del campo | Descripción | Unidad de medida | Medición | Política de retención |
|---|---|---|---|---|
| (Float): El punto de ajuste total actual de potencia, en vatios. Es la suma de | Potencia activa total en el momento actual. | Vatio (W) |
⚠️ Para las mediciones anteriores: Los valores positivos indican carga, consumo o importación. Los valores negativos indican descarga o exportación.
⚠️ Para estas mediciones, los valores indican producción.
⚠️ Para estas mediciones, los valores indican consumo. |
|
| childrenStoragePower_W | Potencia total de carga o descarga en tiempo real de todas las baterías conectadas en un sitio determinado. | Vatio (W) | submeteringMetrics |
|
| childrenProducedPower_W | Producción total de potencia en tiempo real de todos los dispositivos conectados que producen potencia en un sitio determinado. | Vatio (W) | submeteringMetrics |
|
| childrenEVPower_W | Consumo total de potencia en tiempo real de todos los cargadores de vehículos eléctricos conectados en un sitio determinado. | Vatio (W) | submeteringMetrics |
|
| childrenConsumedPower_W | Demanda total de potencia en tiempo real de todos los dispositivos conectados que consumen energía en un sitio determinado. | Vatio (W) | submeteringMetrics | rp_one_m |
| childrenOtherPower_W | Consumo total de potencia en tiempo real de los dispositivos que no son cargadores de vehículos eléctricos ni bombas de calor en un sitio determinado. | Vatio (W) | submeteringMetrics |
|
| Nombre del campo | Descripción | Unidad de medida | Medición | Política de retención |
|---|---|---|---|---|
| importedAbsEnergyTot_Wh | Energía total importada | Vatio-hora (Wh) |
|
|
| exportedAbsEnergyTot_Wh | Energía total exportada | Vatio-hora (Wh) |
|
|
| producedAbsEnergyTot_Wh | Energía total producida | Vatio-hora (Wh) |
|
|
| consumedAbsEnergyTot_Wh | Energía total consumida | Vatio-hora (Wh) |
|
|
| chargedAbsEnergyTot_Wh | Energía total cargada | Vatio-hora (Wh) |
|
|
| dischargedAbsEnergyTot_Wh | Energía total descargada | Vatio-hora (Wh) |
|
|
| importedEnergyDeltaTot_Wh | Diferencia de energía importada entre dos momentos | Vatio-hora (Wh) |
|
|
| exportedEnergyDeltaTot_Wh | Diferencia de energía exportada entre dos momentos | Vatio-hora (Wh) |
|
|
| childrenStorageChargedEnergyDeltaTot_Wh | Diferencia de energía total cargada entre dos momentos para todas las baterías conectadas en un sitio determinado. | Vatio-hora (Wh) | submeteringMetrics |
|
| childrenStorageDischargedEnergyDeltaTot_Wh | Diferencia de energía total descargada entre dos momentos para todas las baterías conectadas en un sitio determinado. | Vatio-hora (Wh) | submeteringMetrics |
|
| producedEnergyDeltaTot_Wh | Diferencia de energía total producida entre dos momentos | Vatio-hora (Wh) |
|
|
| chargedEnergyDeltaTot_Wh | Diferencia de energía cargada entre dos momentos | Vatio-hora (Wh) |
|
|
| dischargedEnergyDeltaTot_Wh | Delta de energía descargada entre dos instantes | Vatio-hora (Wh) |
|
|
| Nombre del campo | Descripción | Unidad de medida | Medición | Política de retención |
|---|---|---|---|---|
| powerSetpoint_W | Punto de ajuste de potencia de comando | Vatio (W) | planning |
|
| policy | Política de comando | - | planning |
|
| constraint_ph0_label | Etiqueta de restricción | - | planning |
|
| reactivePowerSetpoint_VAr | Punto de ajuste de potencia reactiva | Voltio-amperio reactivo (VAr) | planning |
|
| Nombre del campo | Descripción | Unidad de medida | Medición | Política de retención |
|---|---|---|---|---|
| currentL1_A | Corriente de la fase 1 (línea 1) | Amperio (A) |
|
|
| currentL2_A | Corriente de la fase 2 (línea 2) | Amperio (A) |
|
|
| currentL3_A | Corriente de la fase 3 (línea 3) | Amperio (A) |
|
|
| currentN_A | Corriente del neutro | Amperio (A) |
| rp_one_m |
| voltageL1N_V | Tensión entre la fase 1 y el neutro (tensión de fase) | Voltio (V) |
|
|
| voltageL2N_V | Tensión entre la fase 2 y el neutro (tensión de fase) | Voltio (V) |
|
|
| voltageL3N_V | Tensión entre la fase 3 y el neutro (tensión de fase) | Voltio (V) |
|
|
| voltageL1L2_V | Tensión entre líneas entre la fase 1 y la fase 2 | Voltio (V) |
|
|
| voltageL2L3_V | Tensión entre líneas entre la fase 2 y la fase 3 | Voltio (V) |
|
|
| voltageL3L1_V | Tensión entre líneas entre la fase 3 y la fase 1 | Voltio (V) |
|
|
| (Float): La potencia activa real de la batería, en vatios. Un valor positivo indica carga, un valor negativo descarga. | Frecuencia del sistema | Hercio (Hz) |
|
|
| powerFactorTot | Factor de potencia total | - |
|
|
| powerFactorL1 | Factor de potencia de la fase 1 | - |
| rp_one_m |
| powerFactorL2 | Factor de potencia de la fase 2 | - |
| rp_one_m |
| powerFactorL3 | Factor de potencia de la fase 3 | - |
| rp_one_m |
| voltageDC_V | Tensión de CC | Voltio (V) |
|
|
| currentDC_A | Corriente de CC | Amperio (A) |
|
|
| cuando no pudo ser aplicado. | Estado del dispositivo (p. ej., encendido, apagado, error) | - |
|
|
| operationMode | Modo de funcionamiento del dispositivo | - |
|
|
| stateOfCharge_frac | Estado de carga (SoC) | fracción (número entre 0 y 1) |
|
|
| stateOfHealth_frac | Estado de salud (SoH) | fracción (número entre 0 y 1) | batteryMetrics | rp_one_m |
| childrenStorageStateOfCharge_frac | Estado de carga (SoC) promedio de todas las baterías conectadas en un sitio específico. | fracción (número entre 0 y 1) | submeteringMetrics |
|
| batteryCurrent_A | Corriente en tiempo real hacia o desde la batería | Amperio (A) | batteryMetrics |
|
| batteryVoltage_V | Tensión en tiempo real de la batería | Voltio (V) | batteryMetrics |
|
| evRequiringCharge | Indica si hay un vehículo eléctrico conectado y necesita cargarse | Verdadero o falso | evChargerMetrics |
|
| (Entero): Marca de tiempo Unix en segundos en la que el punto de ajuste de gestión se activa. | Punto de ajuste de potencia de la señal externa | Vatio (W) | externalSignalMetrics |
|
| strategy | Estrategia de la señal externa | - | externalSignalMetrics |
|
| signalActive | Indica si hay una señal externa activa | 0 o 1 | externalSignalMetrics |
|
| reacPowerSetpoint_VAr | Punto de ajuste de potencia reactiva | Voltio-amperio reactivo (VAr) | externalSignalMetrics |
|
| importLimit_W | Comando de límite de potencia importada para un sitio específico. | Vatio (W) | externalSignalMetrics |
|
| exportLimit_W | Comando de límite de potencia exportada para un sitio específico. | Vatio (W) | externalSignalMetrics |
|