Abfrage der verfügbaren Ressourcen

Die Abfrage der verfügbaren Ressourcen erfolgt über das Keyword „var“. Folgende ROOT-Abfrage liefert alle im myGEKKO OS verfügbaren Systeme und dazugehörigen Objekte als JSON-Objekt zurück.

Über Live-Web:
https://live.my-gekko.com/api/v1/var/?username=<mustermann@email.com>&key=<password>&gekkoid=<XXXX-XXXX-XXXX-XXXX>

<mustermann@email.com> = Benutzername/Email des Benutzers
<password> = Passwort des Accounts
<XXXX-XXXX-XXXX-XXXX> = myGEKKO-ID des Controllers

ODER

Lokaler Zugriff:
https://<xxx.xxx.xxx.xxx>/api/v1/trend/?username=<admin>&password=<password>

<xxx.xxx.xxx.xxx> = IP-Adresse der Controllers im Netzwerk
<admin> = Benutzername des Nutzers im myGEKKO OS
<mygekko> = Passwort des Nutzers im myGEKKO OS
 

Ein Beispiel für das Discovery der Variablen finden Sie im Anhang oder im Wiki.

Um nur einen Teil des Ressourcenbaums abzufragen, kann man auch in die Hierarchie navigieren und z. B. ...v1/var/lights/item96... abfragen.

Platzhalter

Sollte nicht der gesamte Name bzw. die gesamte Bezeichnung bekannt sein, kann das *-Zeichen als Platzhalter verwendet werden.

Abfrage aller Lichtgruppen

Bsp.:

...v1/var/lights/group*/name...

{
       „group0“: {
              „name“: "Grp1"
       },
       „group15“: {
              „name“: "Grp15"
       }
}