---
title: Ein Link’nX-Szenario über eine HTTP-URL auslösen (GET-Webhook)
description: Erstellen Sie einen HTTP-Auslöser in Link’nX, kopieren Sie seine private URL und lassen Sie ein anderes System sie per GET aufrufen, um Szenarien zu starten.
canonical: https://wiki.can-nx.com/de/guides/link-trigger-http/
language: de
product: Link’nX
audience:
  - administrateur
  - installateur
context: "Link’nX Web: Auslöser vom Typ HTTP, per GET aufgerufen von einem System, das das Gateway erreicht"
---

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

Kontext: Link’nX Web: Auslöser vom Typ HTTP, per GET aufgerufen von einem System, das das Gateway erreicht

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](https://wiki.can-nx.com/de/guides/link-action-http/).

## 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](https://wiki.can-nx.com/de/guides/link-trigger-edit/).

## Auslöser dem Szenario zuordnen

[Ordnen Sie den Auslöser dem Szenario zu](https://wiki.can-nx.com/de/guides/link-compose-scenario/), 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](https://wiki.can-nx.com/de/guides/link-related-scenarios/), 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](https://wiki.can-nx.com/de/guides/link-history/) 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.