Externe Monitoring-API

Ziel

Für Integratoren, die Echtzeitsichtbarkeit benötigen, führt das Abfragen 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 lösen, kann der Controller so konfiguriert werden, dass Telemetriedaten an einen vom Integrator bereitgestellten Endpunkt gesendet werden. Dieser 'Webhook-Mechanismus' ermöglicht Live-Datenströme mit nahezu null Latenz und umgeht die Einschränkungen des traditionellen API-Pollings.

Erstkonfiguration (Startpunkt für neue Nutzer)

1. Überprüfen Sie Ihr Netzwerk

Stellen Sie sicher, dass Ihr SmartgridOne Controller eine aktive Netzwerkverbindung hat.

2. Fügen Sie Ihre Geräte hinzu

Melden Sie sich am Inbetriebnahme-Interface 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 den Endpunkt der API

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

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

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

   • Gerätedaten enthalten alle unten angegebenen Datenfelder für jeden einzelnen Knoten, der an das SmartgridOne Controller angeschlossen ist.
   • Daten auf Gerätetyp-Ebene enthalten aggregierte Daten auf Gerätetyp-Ebene (z.B. Solar, Speicher, Fest).

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

Endpoint-Daten

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

{
    "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>",
}

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