Externe Monitoring-API

Ziel

Für Integratoren, die eine Echtzeitübersicht benötigen, führt das Abfragen unserer Telemetrie-API zu Verzögerungen und verursachen sowohl auf Seiten des Integrators als auch auf Seiten von SmartgridOne zusätzlichen Aufwand. Um dies zu lösen, kann der Controller so konfiguriert werden, dass er Telemetriedaten an einen vom Integrator angegebenen Endpunkt sendet. Dieser „Webhook-Mechanismus“ ermöglicht Live-Datenströme mit nahezu Null Latenz und umgeht so die Beschränkungen der traditionellen API-Abfrage.

Erste Konfiguration (Startpunkt für neue Benutzer)

1. Prü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 in der Inbetriebnahmeschnittstelle an und stellen Sie sicher, dass die Geräte hinzugefügt wurden zum SmartgridOne Controller.

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

4. Geben Sie die Parameter ein

1. Die URL und der Endpunkt der API

2. Das Bearer-Authentifizierungstoken, das für die API-Anfrage verwendet wird. Um zu verhindern, dass ein kompromittierter Controller verwendet wird, um Daten anderer Geräte zu fälschen, empfehlen wir dringend, für jeden Controller einzigartige Tokens zu verwenden und jedes Token an einen bestimmten Standort in Ihrer Implementierung zu binden.

3. Die Frequenz, mit der Daten gesendet werden (in Sekunden, Standard ist 60s)

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

   • Gerätedaten enthalten alle unten angegebenen Datenfelder pro einzelnem Knoten, der mit dem SmartgridOne Controller verbunden ist.
   • Auf Gerätetyp-Ebene werden aggregierte Daten auf Gerätetyp-Ebene bereitgestellt (z. B. Solar, Speicher, Festinstallation)

Anschließend wählen Sie aus, alle Geräte einzubeziehen.

Endpunkt-Daten

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

Wenn die Gerätetyp-Ebene 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ätebene ausgewählt wurde:

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

Weitere Informationen zu den einzelnen Feldern finden Sie hier: .