top of page

Anleitungen

Push API

Andere

Hersteller:

Geräte-Integration

Stromzähler

Zuletzt geändert am:

24. November 2023

clever-PV bietet eine Möglichkeit selbst über einen HTTP Request Stromzähler, Wechselrichter und Batteriespeicher Daten zu senden.Somit hat man die Möglichkeit, Geräte intelligent zu steuern wo die Energiedaten nicht über das Internet abgerufen werden können.


Ein Szenario wäre z.B wenn man auf einem Gerät im lokalen Netzwerk ein Script laufen lässt, welches periodisch den Wechselrichter abfrägt und die Daten anschließend zu clever-PV sendent.

Vorbereitung

Um Daten an clever-PV senden zu können, musst du einen Stromzähler mit dem Typ "Push API" erstellen.


Erstelle nun einen API Key. Dieser dient zur Authentifizierung und sollte vertraulich behandelt werden.



Nun wird die eine URL angezeigt, an diese du per HTTP-POST Request Daten senden kannst.



Einbindung in clever-PV

Da du nun eine gültige URL erstellt hast, kannst du deine Energiedaten an clever-PV senden.Der Content-Type ist immer application/jsonDie Zahlenwerte sind als ganze Zahl (integer) zu übertragen.


Beispiele

Hausverbrauch

{

"watt": -1000

}



Damit wird nur dein Hausverbrauch übermittelt. Negativer Wert bedeutet, es wird in das öffentliche Netz eingespeist (Überschuss). Positiver Wert bedeutet Netzbezug (Verbrauch).


Hausverbrauch und PV-Produktion

{

"watt": -1000,

"producingWatt": 1500

}


Im Feld "producingWatt" wird die aktuelle PV-Prduktion übermittelt. Der Wert ist immer positiv.


Hausverbrauch, PV-Produktion und Batteriespeicher


{

"watt": -1000,

"producingWatt": 1500,

"soc": 75,"chargingPower": 500,

"powerStorageState": 1

}


Im Feld "soc" wird die der aktuelle State of Charge in Prozent deiner Batterie übermittelt.Im Feld "chargingPower" wird die Lade/Entladeleistung deiner Batterie übermittelt. Der Wert ist immer positiv.

Je nachdem, ob deine Batterie gerade lädt, entlädt oder einen anderen Status hat, wird diese Information in "powerStorageState" übermittelt. Folgende Werte sind zulässig:


Idle : 0

Charging : 1

Disabled : 2

Discharging : 3


Bei erfolgreichen übersenden wird mit Status Code 202 (Accepted) geantwortert.


Hinweis: Die gesendeten Daten werden nicht sofort im Frontend aktualisiert. Stattdessen werden diese zur weiteren Verarbeitung vorerst zwischengespeichert. Ca. alle 15 Sekunden aktualisiert sich der Wert in der Anzeige.Die API hat ein Rate-Limit von 180 Requests pro Minute.

bottom of page