GET-Input

Mit dem Typ GET-Input können mit dem HTTP GET Request Werte aus einer HTTP API ausgelesen werden.

Es wird eine Ressource unter Angabe eines URL vom Server/Gerät angefordert. Mit diesem Typ werden nur Daten abrufen.

 
Hinweis

Die maximale Länge von Name + Request On + Request Off/Parameter darf in der Summe nicht über 250 Zeichen betragen.

Die maximale Länge der Antwort beträgt 1000 Zeichen.


Request ON = URL:

Bsp:

myGEKKO API:

http://192.168.2.30/api/v1/meteo/status?username=www&password=www

Für Arrays:
http://192.168.2.30/api/v1/var/status?username=www&password=www&format=array

Dachs Senertec:

http://glt:@192.168.0.192:8080/getKey?k=Hka_Mw1.sWirkleistung


Request OFF/Parameter:

Ist dieses Feld leer, so nimmt Controller an, die Antwort ist bereits eine Zahl und wandelt diese entsprechend um und kann in einem AI genutzt werden.

Beispiele für mögliche Parameter:

  • Für weitere Erklärung der Parameter siehe Erklärung Variablen

  • TEXT@conn-state:
    Wertet z.B. aus ob die Antwort aus dem Text conn_state besteht und setzt dementsprechend den Wert auf 1 bzw. auf 0.
  • JSON@twilight.status:
    Nimmt als Antwort ein JSON Objekt und sucht in diesem Objekt nach dem Feld „twilight.status“ und wandelt diesen Wert um, sodass dieser als AI verwendet werden kann. Gültig sind sämtliche numerischen Werte sowie auch True/False.
  • JSON@temperatures[0].value:
    Befindet sich im JSON-Objekt ein Array, kann dieser Ausdruck verwendet werden um ein spezifisches Feld auszulesen.
  • JSON@lights.item0.sumstate.value[1]:
    Ein bestimmter Wert in einem Array kann so ausgelesen werden.
  • JSON@status.effect@none:
    Nimmt als Antwort ein JSON Objekt und sucht in diesem Objekt nach dem Feld „status.effect“. Ist der Wert dieses Objektes „none“ so wird das Ergebnis auf 1 ansonsten auf 0 gesetzt.
  • TEXT@Hka_Mw1.sWirkleistung=@VALUE@:
         Wertet die Zahl nach dem Parameter „Hka_Mw1.sWirkleistung=“ aus und wandelt diese entsprechend um und kann in einem AI genutzt werden. Bsp.: Hka_Mw1.sWirkleistung=5,67
 
Hinweis

Im Request bzw. Parameter darf kein ; (Strichpunkt) eingegeben werden, dieses Zeichen wird in der Eingabe aktuell nicht unterstützt.

Zum Auslesen der möglichen Werte aus Ihrem myGEKKO Controller, konsultieren Sie das Handbuch zur „Query API“. Dort wird die Freischaltung und Zugriff auf die JSON mit den WErten aus Ihrem Controller erklärt.