Ein Link’nX-Szenario über eine HTTP-URL auslösen (GET-Webhook)

Der Auslöser HTTP in Link’nX erzeugt eine private URL unter der Adresse des Gateways. Ruft ein autorisiertes System diese URL mit der Methode GET auf, erhalten die zugeordneten Szenarien eine Ausführungsanforderung.

Für Installateure und Administratoren, die ein anderes System an ein Link’nX-Szenario anbinden. Um selbst eine Anfrage aus einem Szenario zu senden, verwenden Sie stattdessen eine HTTP-Aktion.

Bevor Sie beginnen

• Das aufrufende System kann das Gateway unter der im Formular angezeigten Adresse erreichen. Für einen Zugriff aus einem anderen Netzwerk oder aus dem Internet erfragen Sie beim Support das geeignete Vorgehen, bevor Sie die Netzwerkkonfiguration ändern.
• Die Aktionen der zugeordneten Szenarien sind vorbereitet: Der Aufruf der URL kann ihre Ausführung anfordern.

HTTP-Auslöser erstellen

1. Klicken Sie unter Triggers (Auslöser) auf Add (Hinzufügen) und wählen Sie dann in Select a trigger type (Auslösertyp auswählen), Gruppe Protocols (Protokolle), den Eintrag HTTP.
2. Füllen Sie Name aus: erforderlich, höchstens 64 Zeichen. Fiktives Beispiel: „Aufruf Empfang“.
3. Geben Sie unter URL nur den Namen des Endpunkts nach dem bereits angezeigten Präfix ein. Fiktives Beispiel: aufruf-empfang. Dieses Feld ist erforderlich und darf keinen Schrägstrich / enthalten: Fügen Sie in diesen Teil keine vollständige URL ein.
4. Klicken Sie unten rechts auf das Diskettensymbol und warten Sie dann auf die Bestätigung der Erstellung.

Auslöser dem Szenario zuordnen

Ordnen Sie den Auslöser dem Szenario zu, konfigurieren Sie dessen Aktionen und Bedingungen, speichern Sie und prüfen Sie dann die Aktivierung des Szenarios.

Verwenden mehrere Szenarien diesen Auslöser, kann ein Aufruf alle betreffen. Prüfen Sie die verknüpften Szenarien, bevor Sie eine URL wiederverwenden.

URL in das aufrufende System kopieren

1. Öffnen Sie den HTTP-Auslöser erneut und klicken Sie auf das Symbol mit zwei Blättern links neben dem Feld URL, dessen Tooltip Copy (Kopieren) lautet.
2. Übertragen Sie die URL nach URL copied to clipboard (URL in die Zwischenablage kopiert) in die Konfiguration des autorisierten Systems und prüfen Sie die Kopie. Halten Sie diese URL geheim.
3. Konfigurieren Sie dieses System so, dass es die kopierte URL mit der Methode GET aufruft.

Ergebnis prüfen

Führen Sie einen Test nur durch, wenn Sie bereit sind, die vorgesehenen Aktionen an der Installation zuzulassen. Beobachten Sie anschließend das erwartete Ergebnis an den Geräten und sehen Sie den Verlauf des Szenarios ein. Die Antwort auf den Aufruf reicht nicht aus, um zu bestätigen, dass jedes Gerät seinen Befehl ausgeführt hat: Die Bedingungen und der Aktivierungszustand des Szenarios müssen weiterhin geprüft werden.

HTTP-Auslöser ändern oder duplizieren

Um den Namen des Endpunkts zu ändern, öffnen Sie den Auslöser, ändern Sie URL, speichern Sie und bestätigen Sie dann die betroffenen Szenarien, falls das Fenster erscheint. Kopieren Sie die neue URL und aktualisieren Sie das aufrufende System: Aufrufe an den alten Endpunkt dürfen für diesen Auslöser nicht mehr verwendet werden.

Wenn Sie einen HTTP-Auslöser für eine unabhängige Verwendung duplizieren, wählen Sie vor dem Speichern einen anderen Endpunkt.

Fehlerbehebung

Meldung oder Symptom	Maßnahme
Issue with the field ‘URL’. It requires a value. (Problem mit dem Feld „URL“: Ein Wert ist erforderlich.)	Füllen Sie den Endpunkt aus
The URL must not contain a slash (/) (Die URL darf keinen Schrägstrich enthalten)	Entfernen Sie die Schrägstriche und prüfen Sie, ob Sie versehentlich die vollständige Adresse eingefügt haben
Der Aufruf hat keine Wirkung	Prüfen Sie zuerst, ob die kopierte URL dem gespeicherten Auslöser entspricht und ob das aufrufende System die angezeigte Adresse erreichen kann. Prüfen Sie anschließend das zugeordnete Szenario, seine Aktivierung, seine Bedingungen und seine Verzögerungen

Wiederholen Sie die Aufrufe nicht, um das Ausbleiben einer Reaktion zu diagnostizieren. Besteht das Problem weiterhin, wenden Sie sich an support@can-nx.com und geben Sie das Produkt, den Kontext, den Namen des Auslösers, die Uhrzeit und das Ergebnis des Aufrufs an, ohne die vollständige private URL zu übermitteln.