Exercice sur les webhooks
Créé pour :
- Débutant
- Utilisateur ou utilisatrice
Découvrez comment créer, déclencher et gérer des scénarios lancés par webhook.
Vue d’ensemble de l’exercice
L’objectif de ce scénario est de créer une application destinée à être vendue aux magasins de proximité afin de facilement déterminer si un client ou une cliente a l’âge requis pour acheter de l’alcool. Il suffit au caissier ou à la caissière d’afficher le nom et la date de naissance du client ou de la cliente à l’adresse URL qui lui a été fournie. Cette publication déclenche le scénario qui permet de calculer la réponse et de la renvoyer au demandeur ou à la demandeuse.
-
Le scénario se compose de trois webhooks.
-
Le module déclencheur est un webhook personnalisé qui écoute une publication.
-
Lorsqu’il reçoit une publication, il la transmet à l’un des modules suivants.
-
Le module suivant renvoie une réponse au demandeur ou à la demandeuse.
Étapes à suivre
Configurer le webhook du déclencheur.
-
Créez un scénario et nommez-le « Utiliser les webhooks ».
-
Pour le déclencheur, ajoutez le module webhook personnalisé à partir de l’application Webhooks.
-
Cliquez sur Ajouter pour créer un webhook.
-
Saisissez le nom du webhook « Application pour l’âge de la consommation d’alcool ».
-
Laissez les restrictions d’IP vides, ce qui signifie que n’importe qui peut envoyer des données.
-
Cliquer sur Enregistrer.
-
Dans le panneau de mappage des webhooks, une URL a été créée pour ce webhook spécifique. Cliquez sur « Copier l’adresse dans le presse-papiers » pour copier l’URL.
-
Cliquez sur OK.
-
Cliquez sur Exécuter une fois.
-
Utilisez l’URL dans Postman pour envoyer un nom et une date de naissance à votre webhook personnalisé. Pour obtenir des instructions sur la configuration de Postman, consultez le tutoriel Présentation détaillée des webhooks.
Le panneau du module Webhooks devrait ressembler à celui-ci :
Le webhook est maintenant à l’écoute des données pour déterminer la structure de celles-ci.
-
Vous pouvez définir la structure de données de la charge utile que vous souhaitez obtenir (les structures de données seront abordées ultérieurement). Si vous ne définissez pas de structure de données, Fusion la déterminera automatiquement lors de l’envoi de la publication.
-
Du côté de Postman, envoyez l'URL copiée. La publication doit contenir des données du formulaire de base. Pour cet exemple, vous avez besoin de trois champs : Nom, Date de naissance et ClientToken.
-
Une fois que vous avez cliqué sur Envoyer depuis Postman , vous devriez recevoir une indication que la publication a été acceptée.
-
C’est à ce stade que votre scénario montrera que la structure des données a été déterminée avec succès.
-
Vous pouvez constater que les données ont été reçues lors de l’ouverture de l’inspecteur d’exécution.
Configurez le routage pour les jetons clients.
-
Ajoutez un routeur au module déclencheur.
-
Dans le chemin supérieur, ajoutez un module de réponse webhook. Il s’agit de notre chemin d’accès lorsque le jeton client ne correspond pas.
-
Définissez le statut sur 401.
-
Définissez le corps sur {"error": "Échec de l’authentification de la requête. Vérifiez votre clientToken"}.
-
Créez un filtre entre le routeur et le module de réponse webhook. Nommez-le « Le jeton client ne correspond pas ».
-
Pour la condition, utilisez le champ clientToken du module déclencheur et effectuez une comparaison numérique « N’est pas égal à » avec le nombre 5121933.
-
Dans le chemin du bas, ajoutez un autre module de réponse webhook. Il s’agit de notre chemin d’accès lorsque le jeton client correspond.
-
Définissez le statut sur 200.
-
Lors de la mise en place du corps, utilisez les fonctions du panneau de mappage pour vérifier si la personne est âgée d’au moins 18 ans. Si c’est le cas, renvoyez « Vous avez l’âge de boire ! », sinon renvoyez « Pas de chance… ».
-
Créez un filtre entre le routeur et le module de réponse Webhook sur le chemin inférieur. Nommez-le « Le jeton client ne correspond pas. »
-
Pour la condition, utilisez le champ Jeton client du module de déclenchement et effectuez une comparaison numérique « Est égal à » avec le nombre 5 121 933.
-
Cliquez sur le bouton Planification sous Exécuter une fois pour activer votre scénario, de sorte qu’à chaque publication d’un nouveau billet, celui-ci soit reçu, suive l’un ou l’autre des chemins et génère une réponse.