SmartPi API

Mit der integrierten REST-API ist es möglich, alle relevanten Daten auszulesen und in eigenen Applikationen zu verwenden. Das Webinterface des SmartPi nutzt auch die REST-API.

Aktuelle Werte

Geben Sie zum Beispiel in der Adresszeile Ihres Browsers http://<ipaddress:1080>/api/all/all/now ein. Sie bekommen alle aktuellen Werte angezeigt.

Die Struktur der URL ist immer gleich aufgebaut: http://<ipaddress>:<port>/api/<phaseid>/<valueid>/now

Für valueid sind folgende Parameter erlaubt:

current Strom [A] (Für Phase 1,2,3 und Neutralleiter (4))
voltage Spannung [V](Nur für Phase 1,2,3)
power Leistung [W]  (Nur für Phase 1,2,3)
cosphi cos φ  (Nur für Phase 1,2,3)
frequency Frequenz [Hz]  (Nur für Phase 1,2,3)
all Alle Werte

 

Für phaseid sind folgende Parameter erlaubt:

1 Phase 1
2 Phase 2
3 Phase 3
4 Nur beim Parameter valueid current gültig (Strom des Neutralleiters)
all Alle Phasen

 

Historische- und Diagrammdaten

Die REST-API kann auch historische Daten liefern.
Zum Beispiel gibt http://<ipaddress:1080>/api/chart/123/power/from/2016-09-29T00:00:00.000Z/to/2016-09-29T14:00:00.000Z alle am 29. September 2016 zwischen 0:00 Uhr und 14:00 Uhr gemessenen Werte aus.

Auch hier ist die Struktur der URL immer gleich aufgebaut: http://<ipaddress>:<port>/api/chart/<phaseid>/<valueid>

Für valueid sind folgende Parameter erlaubt

current Strom [A] (available for phase 1,2,3, neutral conductor)
voltage Spannung [V] (available for phase 1,2,3)
power Leistung [W]  (available for phase 1,2,3)
cosphi cos φ  (available for phase 1,2,3 –  it is important to measure the voltage)
energy_pos Energie [Wh] (Energieverbrauch)
energy_neg Energie [Wh] (Energieerzeugung)

 

Für phaseid sind folgende Parameter erlaubt

1 Phase 1
2 Phase 2
3 Phase 3
4 Nur beim Parameter valueid current gültig (Strom des Neutralleiters)
123 All Phasen