Cet article explique comment configurer des webhooks en utilisant l'API Gelato pour recevoir des notifications dans ton application chaque fois qu'un événement se produit avec ta commande.
Configuration du Webhook
L'API Gelato offre une fonctionnalité webhook robuste, te permettant de rester informé des événements critiques liés à tes commandes. Pour configurer tes webhooks, suis ces étapes :
Accède au Tableau de bord Gelato et navigue vers la section Webhooks. Cet espace dédié te fournit un hub centralisé pour gérer tes configurations de webhooks.
Clique sur le bouton « Ajouter un Webhook » pour lancer la création d'un nouveau webhook. Cette action te présentera un formulaire de configuration où tu pourras spécifier les détails de ton webhook.
Fournis l'URL du point de terminaison dans ton application qui recevra les notifications webhook. Assure-toi que cette URL est accessible publiquement et correctement configurée pour gérer les requêtes HTTP entrantes. Sélectionne la méthode HTTP, soit GET soit POST, qui correspond aux besoins de ton application. Choisis les types d'événements spécifiques auxquels tu souhaites t'abonner. Gelato propose une liste complète de types d'événements, tels que la création de commande, les mises à jour de commande et les notifications d'expédition, offrant un contrôle précis sur les notifications que tu reçois. Pour des descriptions détaillées de chaque type d'événement, consulte la documentation API.
Configure l'autorisation pour ton webhook afin de renforcer la sécurité et de t'assurer que les notifications proviennent d'une source fiable. Sélectionne le type d'autorisation approprié, comme les en-têtes HTTP ou les paramètres de requête. Fournis les identifiants nécessaires, tels qu'une clé API ou un jeton, dans les champs prévus à cet effet. Pour confirmer la configuration de ton webhook et t'assurer que les notifications sont bien délivrées, envoie une notification de test vers le point de terminaison spécifié. Cette étape permet d'identifier et de résoudre tout problème potentiel avant que le webhook ne soit déployé dans un environnement de production.
Gérer les Webhooks
Une fois que tu as configuré tes webhooks, tu peux facilement les gérer depuis le Tableau de bord Gelato. La section Webhooks offre une vue d'ensemble complète de tous tes webhooks, te permettant d'effectuer des actions telles que :
Modifier les webhooks existants : Modifie la configuration de tes webhooks à tout moment pour l'adapter à tes besoins évolutifs. Mets à jour l'URL de notification, les abonnements aux événements ou les détails d'autorisation selon tes besoins.
Supprimer des webhooks : Supprime les webhooks qui ne sont plus nécessaires pour maintenir une configuration de webhooks propre et organisée. La suppression d'un webhook arrêtera l'envoi de notifications vers le point de terminaison associé.
Pour une compréhension approfondie de l'API Gelato, y compris des informations détaillées sur les événements webhook et les charges utiles, consulte notre documentation technique complète.
Pour accéder à la section Webhooks dans ton compte Gelato, tu peux aller directement sur Developer > Webooks depuis le menu de gauche.