GET-Output
Mit dem Typ GET-Output können mit dem HTTP GET Request Werte von myGEKKO gesendet werden.
Über GET lassen sich auch Formular-Daten übermitteln. Diese werden in codierter Form der URL angehängt. URL und Formular-Daten sind durch ein Fragezeichen (?) voneinander getrennt.
Die Requests werden nur bei Wertänderung gesendet.
Die maximale Länge von Name + Request On + Request Off/Parameter darf in der Summe nicht über 250 Zeichen betragen. Pro Request beträgt die maximale Länge 127 Zeichen.
Anwendungsmöglichkeiten
1. ON/OFF (Ein/Aus)
Request On:
Bsp.: | http://192.168.2.27/api/v1/var/lights/item0/scmd?value=1&username=www&password=www |
Request Off:
Bsp.: | http://192.168.2.27/api/v1/var/lights/item0/scmd?value=1&username=www&password=www |
2. VALUE (Wert)
Falls kein Request OFF eingetragen wird, so wird immer der Request ON ausgeführt.
Request On:
@VALUE@ wird mit dem übergebenen Wert aus AO oder DO als Ganzzahl ersetzt.
Bsp.: | Bei dem Wert 60 wird die Lampe Nr. 1 auf 60% Helligkeit gedimmt. |
Es wird folgender Befehl verwendet, um den Status weiterzugeben: http://192.168.2.27/api/v1/var/lights/item0/scmd?value=D@VALUE@&username=www&password=www @VALUE@ ist gleich 60 in unserem Beispiel, daraus folgt dass der gesendete Befehl so aussieht: http://192.168.2.27/api/v1/var/lights/item0/scmd?value=D60&username=www&password=www |
Genauso kann der Platzhalter für Wörter verwendet werden:
@VALUE:0[true],1[false]@
Bsp.: | Unsere Beispiellampe 1 wird eingeschaltet und sendet damit den Befehl. |
Es wird folgender Befehl verwendet, um den Status weiterzugeben: http://192.168.2.27/api/v1/var/lights/item0/scmd?value=@VALUE:0[true],1[false]@&username=www&password=www @VALUE@ ist gleich 1 in unserem Beispiel, daraus folgt dass Befehl die „1“ in „true“ umwandelt und folgenden Befehlt sendet: http://192.168.2.27/api/v1/var/lights/item0/scmd?value=true&username=www&password=www |
Im Request darf kein ; (Strichpunkt) eingegeben werden, da dieses verwendet wird um Parameter zu trennen.