http-de.md

Deutsch • English

HTTP Api

Die API Keys können über die HTTP Api gelesen und geschrieben werden.

Dafür muss die HTTP API (v2) in der App erst aktiviert werden:

Alle Werte auf einmal abfragen

höhere Last am System, viel traffic, sollte nicht für den Dauerbetrieb benutzt werden

http://192.168.0.75/api/status

Vereinzelte Werte abfragen

Um die erhöhte Last zu reduzieren, kann die Status Anfrage so gefiltert werden, dass nur bestimmte Api Keys in der Response vor kommen. Ab Firmware 051.4:

http://192.168.0.75/api/status?filter=rfb,alw,acu,adi,amp

Bis Firmware 051.3 (legacy): Achtung, beim filter json parsen ging häufig der Speicher aus und es waren nie mehr als ca. 10 parameter möglich

http://192.168.0.75/api/status?filter=["rfb","alw","acu","adi","amp"]

Werte setzen

Jeder zu setzende api wert muss als Url Query parameter (GET Parameter) mitgegeben werden. Der Wert muss dabei als JSON encodiert werden. Bei Strings zB dürfen die Anführungszeichen davor und danach nicht fehlen.

http://192.168.0.75/api/set?fna="mein charger"
http://192.168.0.75/api/set?amp=16
http://192.168.0.75/api/set?dwo=null
http://192.168.0.75/api/set?dwo=3.14
http://192.168.0.75/api/set?bac=false&sdp=true

In der HTTP-Antwort sollte für jeden verarbeiteten Api-Key ein Ergebnis im JSON-Objekt sein, true wenn erfolgreich, oder ein string mit der Fehlermeldung.

{
  "bac": true,
  "sdp": true
}