Skip to content

http-de.md

Latest commit

 

History

History
43 lines (29 loc) · 1.44 KB

http-de.md

File metadata and controls

43 lines (29 loc) · 1.44 KB

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.99/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.

http://192.168.0.75/api/status?filter=ccn,ccp,cec

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 controller"
http://192.168.0.75/api/set?ccn=[null,null,null,null,null,null,"Kühlschrank"]
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
}