Erstellen Sie sichere Integrationen auf Grundlage der von Eniris-Anwendungen verwendeten Daten. Ermitteln Sie zugängliche Unternehmen und Geräte, verwalten Sie Metadatenbeziehungen und fragen Sie Zeitreihen-Telemetriedaten verbundener Energieanlagen ab.
Verwenden Sie Ihr bestehendes Konto. Melden Sie sich bei der Authentication API mit derselben E-Mail-Adresse und demselben Passwort an, die Sie für SmartgridX oder die Eniris-App verwenden. Sie benötigen keine separaten API-Zugangsdaten.
Jede API-Anfrage erfordert ein JWT-Zugriffstoken. Rufen Sie ein Token über die Eniris Authentication API mit diesen Zugangsdaten ab und senden Sie es mit jeder Anfrage mit:
Authorization: Bearer <access-token>
Die API verwendet HTTPS und JSON. Eniris stellt außerdem Client-Pakete für Python und npm bereit, die den Authentifizierungsablauf implementieren und die Kommunikation mit der API vereinfachen.
Für die aktuellen Anfrage-Schemas, Antwortmodelle und den interaktiven Endpunkt-Explorer verwenden Sie die offizielle Eniris API-Referenz. Bevorzugen Sie die neueren POST .../query Endpunkte, wenn die Referenz einen älteren GET Endpunkt als ersetzt kennzeichnet.
Der API-Zugriff ist für Integrationen und den Datenexport vorgesehen und kann kostenpflichtig sein. API-Zugriff oder Preisinformationen anfordern.
Die folgende Tabelle enthält die verfügbaren Felder, für die Daten über die Eniris Metadata & Telemetry Query API abgerufen werden können.
Daten für ein bestimmtes Feld sind nur für die angegebenen Messungen und Aufbewahrungsrichtlinien verfügbar.
| Feldname | Ermöglichte Messwerte | Maßeinheit | Bedeutung | Aufbewahrungsrichtlinie |
|---|---|---|---|---|
| setpoint_W | Gesamte Wirkleistung zum aktuellen Zeitpunkt. | Watt (W) |
⚠️ Für die oben genannten Messungen gilt: Positive Werte zeigen Laden, Verbrauch oder Import an. Negative Werte zeigen Entladen oder Export an.
⚠️ Für diese Messungen geben die Werte die Erzeugung an.
⚠️ Für diese Messungen geben die Werte den Verbrauch an. |
|
| childrenStoragePower_W | Gesamte Lade- oder Entladeleistung in Echtzeit aller an einem bestimmten Standort angeschlossenen Batterien. | Watt (W) | submeteringMetrics |
|
| childrenProducedPower_W | Gesamte Echtzeit-Leistungserzeugung aller an einem bestimmten Standort angeschlossenen Strom erzeugenden Geräte. | Watt (W) | submeteringMetrics |
|
| childrenEVPower_W | Gesamter Echtzeit-Leistungsverbrauch aller an einem bestimmten Standort angeschlossenen EV-Ladegeräte. | Watt (W) | submeteringMetrics |
|
| childrenConsumedPower_W | Gesamter Echtzeit-Leistungsbedarf aller an einem bestimmten Standort angeschlossenen Energieverbraucher. | Watt (W) | submeteringMetrics | rp_one_m |
| childrenOtherPower_W | Gesamter Echtzeit-Leistungsverbrauch von Geräten, die an einem bestimmten Standort keine EV-Ladegeräte oder Wärmepumpen sind. | Watt (W) | submeteringMetrics |
|
| Feldname | Ermöglichte Messwerte | Maßeinheit | Bedeutung | Aufbewahrungsrichtlinie |
|---|---|---|---|---|
| importedAbsEnergyTot_Wh | Gesamte importierte Energie | Wattstunde (Wh) |
|
|
| exportedAbsEnergyTot_Wh | Gesamte exportierte Energie | Wattstunde (Wh) |
|
|
| producedAbsEnergyTot_Wh | Gesamte erzeugte Energie | Wattstunde (Wh) |
|
|
| consumedAbsEnergyTot_Wh | Gesamte verbrauchte Energie | Wattstunde (Wh) |
|
|
| chargedAbsEnergyTot_Wh | Gesamte geladene Energie | Wattstunde (Wh) |
|
|
| dischargedAbsEnergyTot_Wh | Gesamte entladene Energie | Wattstunde (Wh) |
|
|
| importedEnergyDeltaTot_Wh | Delta der importierten Energie zwischen zwei Zeitpunkten | Wattstunde (Wh) |
|
|
| exportedEnergyDeltaTot_Wh | Delta der exportierten Energie zwischen zwei Zeitpunkten | Wattstunde (Wh) |
|
|
| childrenStorageChargedEnergyDeltaTot_Wh | Gesamtes Delta der geladenen Energie zwischen zwei Zeitpunkten aller an einem bestimmten Standort angeschlossenen Batterien. | Wattstunde (Wh) | submeteringMetrics |
|
| childrenStorageDischargedEnergyDeltaTot_Wh | Gesamtes Delta der entladenen Energie zwischen zwei Zeitpunkten aller an einem bestimmten Standort angeschlossenen Batterien. | Wattstunde (Wh) | submeteringMetrics |
|
| producedEnergyDeltaTot_Wh | Delta der gesamten erzeugten Energie zwischen zwei Zeitpunkten | Wattstunde (Wh) |
|
|
| chargedEnergyDeltaTot_Wh | Delta der geladenen Energie zwischen zwei Zeitpunkten | Wattstunde (Wh) |
|
|
| dischargedEnergyDeltaTot_Wh | Delta der entladenen Energie zwischen zwei Zeitpunkten | Wattstunde (Wh) |
|
|
| Feldname | Ermöglichte Messwerte | Maßeinheit | Bedeutung | Aufbewahrungsrichtlinie |
|---|---|---|---|---|
| powerSetpoint_W | Leistungs-Sollwert | Watt (W) | planning |
|
| policy | Befehlsrichtlinie | - | planning |
|
| constraint_ph0_label | Bezeichner der Einschränkung | - | planning |
|
| reactivePowerSetpoint_VAr | Blindleistungs-Sollwert | Voltampere reaktiv (VAr) | planning |
|
| Feldname | Ermöglichte Messwerte | Maßeinheit | Bedeutung | Aufbewahrungsrichtlinie |
|---|---|---|---|---|
| currentL1_A | Strom von Phase 1 (Leitung 1) | Ampere (A) |
|
|
| currentL2_A | Strom von Phase 2 (Leitung 2) | Ampere (A) |
|
|
| currentL3_A | Strom von Phase 3 (Leitung 3) | Ampere (A) |
|
|
| currentN_A | Neutralleiterstrom | Ampere (A) |
| rp_one_m |
| voltageL1N_V | Spannung zwischen Phase 1 und Neutralleiter (Phasenspannung) | Volt (V) |
|
|
| voltageL2N_V | Spannung zwischen Phase 2 und Neutralleiter (Phasenspannung) | Volt (V) |
|
|
| voltageL3N_V | Spannung zwischen Phase 3 und Neutralleiter (Phasenspannung) | Volt (V) |
|
|
| voltageL1L2_V | Leiterspannung zwischen Phase 1 und Phase 2 | Volt (V) |
|
|
| voltageL2L3_V | Leiterspannung zwischen Phase 2 und Phase 3 | Volt (V) |
|
|
| voltageL3L1_V | Leiterspannung zwischen Phase 3 und Phase 1 | Volt (V) |
|
|
| actualPowerTot_W | Netzfrequenz | Hertz (Hz) |
|
|
| powerFactorTot | Gesamtleistungsfaktor | - |
|
|
| powerFactorL1 | Leistungsfaktor von Phase 1 | - |
| rp_one_m |
| powerFactorL2 | Leistungsfaktor von Phase 2 | - |
| rp_one_m |
| powerFactorL3 | Leistungsfaktor von Phase 3 | - |
| rp_one_m |
| voltageDC_V | Gleichspannung | Volt (V) |
|
|
| currentDC_A | Gleichstrom | Ampere (A) |
|
|
| (String): Entweder | Gerätestatus (z. B. Ein, Aus, Fehler) | - |
|
|
| operationMode | Betriebsmodus des Geräts | - |
|
|
| stateOfCharge_frac | Ladezustand (SoC) | Bruchteil (Zahl zwischen 0 und 1) |
|
|
| stateOfHealth_frac | Gesundheitszustand (SoH) | Bruchteil (Zahl zwischen 0 und 1) | batteryMetrics | rp_one_m |
| childrenStorageStateOfCharge_frac | Durchschnittlicher Ladezustand (SoC) aller an einem bestimmten Standort angeschlossenen Batterien. | Bruchteil (Zahl zwischen 0 und 1) | submeteringMetrics |
|
| batteryCurrent_A | Echtzeitstrom zur Batterie bzw. von der Batterie | Ampere (A) | batteryMetrics |
|
| batteryVoltage_V | Echtzeitspannung der Batterie | Volt (V) | batteryMetrics |
|
| evRequiringCharge | Gibt an, ob ein EV angeschlossen ist und geladen werden muss | Wahr oder Falsch | evChargerMetrics |
|
| Legt einen expliziten Leistungs-Sollwert zusätzlich zu oder anstelle der FCR-Reaktion fest – zum Beispiel, um den Ladezustand der Batterie während der FCR-Teilnahme in einen arbeitsfähigen Bereich zu steuern. | Leistungs-Sollwert des externen Signals | Watt (W) | externalSignalMetrics |
|
| strategy | Strategie des externen Signals | - | externalSignalMetrics |
|
| signalActive | Ist ein externes Signal aktiv oder nicht | 0 oder 1 | externalSignalMetrics |
|
| reacPowerSetpoint_VAr | Blindleistungs-Sollwert | Voltampere reaktiv (VAr) | externalSignalMetrics |
|
| importLimit_W | Befehl für die Importleistungsgrenze an einem bestimmten Standort. | Watt (W) | externalSignalMetrics |
|
| exportLimit_W | exportLimit_W | Watt (W) | externalSignalMetrics |
|