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 Sofar 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.
Stellen Sie sicher, dass Ihr Sofar EMS über eine aktive Netzwerkverbindung verfügt.
Melden Sie sich in der Inbetriebnahmeschnittstelle an und stellen Sie sicher, dass die Geräte hinzugefügt wurden zum Sofar EMS.
Die URL und der Endpunkt der API
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.
Die Frequenz, mit der Daten gesendet werden (in Sekunden, Standard ist 60s)
Wählen Sie aus, welche Daten gesendet werden sollen:
Anschließend wählen Sie aus, alle Geräte einzubeziehen.
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: Feedback Payload Structure.