Abfrage des aktuellen Wertes
Um den aktuellen Wert abzufragen, reicht es aus die Funktion "status" hinter dem Ressourcenzweig dazuzuschreiben:
https://live.my-gekko.com/api/v1/var/lights/status?username=mustermann@email.com&key=y767ZV6n8k4B7iyvYFzc9D&gekkoid=W96Y-WZDZ-8YTE-8FT3
„lights“: {
„item96“: {
„sumstate“: {
„value“: „0;60;0;“
}
},
Die Interpretation des Wertes kann aus dem Tag „value“ der Ressourcenabfrage entnommen werden. Anhand des obrigen Beispiels erfolgt die Interpretation folgendermaßen:
- 0; = Off
- 60; = 60% gedimmt
- 0 = nicht gesperrt
- ; = kein RGB
Da die Ressourcen bei der Abfrage gleichzeitig abonniert werden und im Hintergrund vom myGEKKO OS geholt werden, kann es sein, dass die Abfrage nach ca. 2 Sekunden wiederholt werden muss, um die Werte zu erhalten. Sollte die Abfrage nicht zyklisch aufgerufen werden, deabonniert der Server diese Werte wieder.
Sollten Sie mehrere Ressourcen abfragen müssen, dann empfiehlt es sich, nicht jeden einzelnen Wert sondern immer den ganzen Zweig abzufragen.
Sollten Sie jedoch nur die Werte der Lichter benötigen, ist es ratsam den Zweig der Lichter und keine Root-Abfrage zu starten, da ansonsten unnötig Daten transportiert werden.
Array-Abfrage
Wird die Rückgabe der Werte in Form eines Arrays benötigt, kann dies als Parameter „format=array“ mitgegeben werden:
https://live.my-gekko.com/api/v1/var/lights/status?username=mustermann@email.com&key=y767ZV6n8k4B7iyvYFzc9D&gekkoid=W96Y-WZDZ-8YTE-8FT3&format=array
„lights“: {
„item96“: {
„sumstate“: {
„value“: [0, 60, „ “, 0]
}
},