Webhooks-Übung
Erfahren Sie, wie Sie mit Webhooks initiierte Szenarien erstellen, auslösen und verwalten.
Übungsübersicht
Der Zweck dieses Szenarios besteht darin, eine App zu erstellen, um sie an Supermärkte zu verkaufen, damit diese einfach feststellen können, ob eine Kundin oder ein Kunde alt genug ist, um Alkohol zu kaufen. Das Kassenpersonal muss einfach den Namen und das Geburtsdatum der Person an eine URL posten, die zur Verfügung gestellt wird. Dieser Post löst das Szenario aus, das die Antwort berechnet und sie an die Person, die die Anfrage gestellt hat, zurückgibt.
-
Das Szenario besteht aus drei Webhooks.
-
Das Trigger-Modul ist ein benutzerdefinierter Webhook, der auf einen Post lauscht.
-
Wenn es einen Post erhält, wird dieser an eines der nächsten Module ausgegeben.
-
Das nächste Modul gibt eine Antwort an die Person zurück, die die Anfrage gestellt hat.
Zu befolgende Schritte
Richten Sie den Trigger-Webhook ein.
-
Erstellen Sie ein neues Szenario und nennen Sie es „Webhooks verwenden“.
-
Fügen Sie für den Trigger das benutzerdefinierte Webhook-Modul aus der Webhooks-App hinzu.
-
Klicken Sie auf „Hinzufügen“, um einen neuen Webhook zu erstellen.
-
Geben Sie den Webhook-Namen „App für Alkoholmindestalter“ ein.
-
Lassen Sie IP-Einschränkungen leer, d. h. jeder kann Daten an den Webhook senden.
-
Klicken Sie auf Speichern.
-
Zurück im Bedienfeld „Webhooks-Zuordnung“ wurde eine URL für diesen spezifischen Webhook erstellt. Klicken Sie auf „Adresse in Zwischenablage kopieren“, um diese URL zu kopieren.
-
Klicken Sie auf „OK“.
-
Klicken Sie auf „Einmal ausführen“.
-
Verwenden Sie die URL in Postman, um einen Namen und ein Geburtsdatum an Ihren benutzerdefinierten Webhook zu senden. Anweisungen zum Einrichten von Postman finden Sie im Tutorial Exemplarische Vorgehensweise zu Webhooks.
Das Bedienfeld des Webhooks-Moduls sollte wie folgt aussehen:
Der Webhook befindet sich jetzt in einem Status, in dem er Daten zur Bestimmung der Datenstruktur überwacht.
-
Sie können die Datenstruktur der Payload definieren, die Sie erwarten (Datenstrukturen werden später besprochen). Wenn Sie keine Datenstruktur definieren, bestimmt Fusion die Datenstruktur automatisch, wenn der Post gesendet wird.
-
Auf der Postman-Seite möchten Sie an die kopierte URL senden. Der Post sollte grundlegende Formulardaten enthalten. Für dieses Beispiel benötigen Sie drei Felder: Name, Geburtsdatum und clientToken.
-
Nachdem Sie auf „Von Postman senden“ geklickt haben, sollten Sie einen Hinweis erhalten, dass der Post akzeptiert wurde.
-
Dies ist der Punkt, an dem Ihr Szenario zeigt, dass die Datenstruktur erfolgreich ermittelt wurde.
-
Sie können sehen, dass die Daten empfangen wurden, indem Sie den Ausführungsinspektor öffnen.
Richten Sie das Routing für Client-Token ein.
-
Fügen Sie dem Trigger-Modul einen Router hinzu.
-
Fügen Sie im oberen Pfad ein Webhook-Antwortmodul hinzu. Dies ist unser Pfad für den Fall, dass das Client-Token nicht übereinstimmt.
-
Legen Sie den Status auf 401 fest.
-
Legen Sie den Hauptteil auf {„Fehler“: „Anfrage konnte nicht authentifiziert werden. Bitte überprüfen Sie Ihr clientToken“} fest.
-
Erstellen Sie einen Filter zwischen dem Router und dem Webhook-Antwortmodul. Geben Sie ihm den Namen „Client-Token stimmt nicht überein“.
-
Verwenden Sie für die Bedingung das Feld „clientToken“ aus dem Trigger-Modul und führen Sie einen numerischen Vergleich des Typs „Ist nicht gleich“ mit der Zahl 5121933 durch.
-
Fügen Sie im unteren Pfad ein weiteres Webhook-Antwortmodul hinzu. Dies ist unser Pfad für den Fall, dass das Client-Token übereinstimmt.
-
Legen Sie den Status auf 200 fest.
-
Verwenden Sie beim Einrichten des Hauptteils die Funktionen des Bedienfelds „Zuordnung“, um zu testen, ob die Person 21 oder älter ist. Falls sie es ist, geben Sie „Sie sind alt genug, um Alkohol zu kaufen!“ zurück, und ansonsten: „Pech gehabt …“
-
Erstellen Sie auf dem unteren Pfad einen Filter zwischen dem Router und dem Webhook-Antwortmodul. Nennen Sie ihn „Client-Token stimmt überein“.
-
Verwenden Sie für die Bedingung das Feld „clientToken“ aus dem Trigger-Modul und führen Sie einen numerischen Vergleich des Typs „Ist gleich“ mit der Zahl 5121933 durch.
-
Klicken Sie auf die Schaltfläche „Planung“ unter „Einmal ausführen“, um Ihr Szenario zu aktivieren, sodass jedes Mal, wenn ein neuer Post eingeht, er die beiden Pfade durchläuft und eine Antwort generiert wird.