Externe Monitoring-API

Ziel

Für Integratoren, die Echtzeittransparenz benötigen, führt das Abrufen unserer Telemetrie-API zu Verzögerungen und verursacht sowohl auf Seiten des Integrators als auch auf Seiten von SmartgridOne zusätzlichen Aufwand. Um dies zu vermeiden, kann der Controller so konfiguriert werden, dass er Telemetriedaten an einen vom Integrator bereitgestellten, festgelegten Endpunkt sendet. Dieser „Webhook-Mechanismus“ ermöglicht Live-Datenströme mit nahezu null Latenz und umgeht die Einschränkungen des herkömmlichen API-Abrufs.

Ersteinrichtung (Ausgangspunkt für neue Benutzer)

1. Überprüfen Sie Ihr Netzwerk

Stellen Sie sicher, dass Ihr SmartgridOne Controller über eine aktive Netzwerkverbindung verfügt.

2. Fügen Sie Ihre Geräte hinzu

Melden Sie sich bei der Inbetriebnahmeschnittstelle an und stellen Sie sicher, dass die Geräte zum SmartgridOne Controller hinzugefügt wurden.

3. Konfigurieren Sie den Webhook über „externe Datenquellen“

4. Geben Sie die Parameter ein

1. Die URL und den Endpunkt der API

2. Das Bearer-Autorisierungstoken, das für die API-Anfrage verwendet wird. Um zu verhindern, dass ein kompromittierter Controller zur Fälschung von Daten anderer Geräte verwendet wird, empfehlen wir dringend, eindeutige Token pro Controller zu verwenden und jedes Token an einen bestimmten Standort in Ihrer Implementierung zu binden.

3. Die Häufigkeit, mit der Daten übertragen werden (in Sekunden, Standardwert ist 60 s)

4. Wählen Sie aus, welche Daten übertragen werden sollen:

   • Daten auf Geräteebene enthalten alle unten angegebenen Datenfelder für jeden einzelnen mit dem SmartgridOne Controller verbundenen Knoten.
   • Auf Geräteart-Ebene werden aggregierte Daten auf Geräteartebene erfasst (z. B. Solar, Speicher, fest)

Wählen Sie anschließend aus, alle Geräte einzubeziehen.

Endpunktdaten

Der Endpunkt muss eine HTTP-POST-Anfrage mit den folgenden Daten akzeptieren:

Wenn die Geräteartebene ausgewählt wurde:

{
    "time": "<Unix Timestamp>",
    "siteNodeId": "<Site NodeID>",
    "grid": "<Grid Fields>",
    "solar": "<Solar Fields>",
    "storage": "<Storage Fields>",
    "heat_pump": "<Heat Pump Fields>",
    "switched_load": "<Switched Load Fields>",
    "variable_power_load": "<Variable Power Load Fields>",
}

Wenn die Geräteebene ausgewählt wurde:

{
    "time": "<Unix Timestamp>",
    "siteNodeId": "<Site NodeID>",
    "nodeId1": "<Node Fields>",
    "nodeId2": "<Node Fields>",
    ...
}

Weitere Informationen zu den einzelnen Feldern finden Sie hier: Feedback-Payload-Struktur.