Fondamentaux des Webhooks

Les webhooks sont une méthode pour informer votre application lorsqu'un événement spécifique se produit, comme la création d'une nouvelle commande. Ils facilitent une intégration e-commerce plus poussée entre votre panier d'achat et d'autres systèmes.

Lors d'un événement, Snipcart initiera une requête POST vers une URL que vous pouvez spécifier dans le tableau de bord.

Votre point de terminaison désigné doit répondre avec des données au format Content-Type application/json et un code de statut 200.

Pour ceux qui découvrent les webhooks, il est recommandé de lire cet article d'introduction.

Configurer une URL de Webhook

Pour configurer votre URL de webhook, connectez-vous au tableau de bord Snipcart et allez à Configurations de magasin → Webhooks.

L'URL doit être une URL absolue.

Plus loin, nous fournissons des exemples de traitement des requêtes Webhook.

Remarque : Vous pouvez entrer plusieurs URL de webhooks, séparées par des points-virgules, comme : https://example.com/webhooks; https://example2.com/webhooks/

Détails de la Requête

Cliquer sur une entrée d'URL de webhook dans le tableau de bord ouvre sa page de détails.

Cette page est utile pour le développement d'applications et l'intégration avec les webhooks de Snipcart

. Elle affiche les détails complets de la requête HTTP envoyée à votre application et la réponse reçue de votre part.

Le bouton Envoyer ce crochet à nouveau déclenche un appel répété de Snipcart à votre application, aidant au débogage.

Sécuriser votre point de terminaison Webhook

Pour assurer l'authenticité des requêtes provenant de Snipcart, surtout pour les données protégées, utilisez l'en-tête X-Snipcart-RequestToken. Cet en-tête, ajouté à chaque requête sortante, contient un jeton valide pendant une heure. Vous pouvez vérifier ce jeton en effectuant une requête GET vers https://app.snipcart.com/api/requestvalidation/{token}, fonctionnant comme une forme de poignée de main numérique.