In diesem Kapitel findest du Beispiele, wie du Geräte anderer Hersteller über WebRequests mit deinem Gira X1 verbindest. Alle Beispiele folgen demselben Muster:

  1. Das Gerät ruft bei einem Ereignis eine Adresse auf, z. B. http://<ip-gira-x1>:8081/virtual/doorbird-klingel.
  2. Der Grundbaustein der XTENSION Nodes empfängt die Anfrage und gibt sie am Ausgang „Komplette Anfrage“ aus.
  3. Ein Baustein „XTENSION Nodes: WebRequest prüfen“ erkennt die Anfrage anhand der „Erwarteten WebRequest-Ressource“ (z. B. doorbird-klingel) und setzt den Ausgang „Treffer“ auf 1. Übergebene Parameter stehen an den Ausgängen „Wert #1“, „Wert #2“ usw. zur Verfügung.
  4. Mit diesen Ausgängen steuerst du in deiner Logik Licht, Szenen, Meldungen oder Aufzeichnungen.

Die Grundlagen findest du unter Grundsätzliche Funktionsweise, Empfangen eines einfachen WebRequests und Extrahieren von Parametern aus dem WebRequest.

Die Beispiele

Kommt die Anfrage an?

Jede empfangene Anfrage erscheint im Register „Diagnose“ der Benutzeroberfläche, z. B. WebRequest GET /virtual/wasser-keller?alarm=1&temp=18.4 (1). Erscheint dort nichts, erreicht das Gerät deinen Gira X1 nicht – prüfe IP-Adresse, Port 8081 und Netzwerk. Erscheint die Anfrage, aber in der Logik passiert nichts, prüfe die Einstellungen am Baustein „WebRequest prüfen“.

Empfangene WebRequests im Register Diagnose

Tipps für alle Beispiele

  • Ressource exakt eintragen: Ohne /virtual/, ohne Parameter, ohne Schrägstrich am Ende. Groß- und Kleinschreibung spielt keine Rolle.
  • Methode beachten: Der Baustein erwartet standardmäßig GET. Sendet ein Gerät POST, stelle die „Erwartete WebRequest-Methode“ entsprechend um.
  • „Treffer“ bleibt 1: Der Ausgang wird erst bei der nächsten anderen Anfrage an /virtual/ wieder 0. Für Ereignisse, die sich wiederholen (Klingel, Bewegung), verwendest du deshalb am besten den Ausgang „Treffender WebRequest Datum / Uhrzeit“: Er ändert sich bei jedem Treffer und kann z. B. einen Impuls auslösen.
  • Parameter: Verwende nur einfache Werte ohne Sonderzeichen. Jeder Parameter muss die Form name=wert haben.
  • Sicherheit: Jedes Gerät im lokalen Netz kann diese Adressen aufrufen. Löse sicherheitsrelevante Aktionen (z. B. Türöffnen) nicht allein über einen leicht zu erratenden WebRequest aus.