Webhooks

Les webhooks permettent aux services externes d'envoyer des données à Blitz Rocket lorsque des événements se produisent dans votre application. Utilisez les webhooks pour créer automatiquement des participations au concours lorsque les utilisateurs s'inscrivent sur votre plateforme, ou pour attribuer des points lors des achats.

Comment fonctionnent les Webhooks

Vous configurez une URL de webhook dans votre système externe (par exemple, Shopify, Stripe, ou votre backend personnalisé)
Lorsqu'un événement se produit (inscription, achat), votre système envoie une requête HTTP POST au point de terminaison webhook de Blitz Rocket
Blitz Rocket traite l'événement, crée ou met à jour les participations, et attribue des points

Points de terminaison Webhook disponibles

Webhook	Endpoint	Objectif
Inscription	`POST /api/webhooks/signup/:contestId`	Créer des participations à partir des inscriptions externes
Achat	`POST /api/webhooks/purchase/:contestId`	Suivre les achats provenant de boutiques externes

Sécurité des Webhooks

Chaque connexion webhook possède une clé secrète que vous pouvez configurer dans les paramètres de votre équipe. Lors de l'envoi des requêtes webhook, incluez le secret dans le corps de la requête ou en tant qu'en-tête pour vérifier l'authenticité.

Intégrations prises en charge

Blitz Rocket prend en charge les webhooks de :

Shopify — Webhooks automatiques pour les commandes et les clients
Stripe — Webhooks pour les paiements et abonnements
Personnalisé — Tout système pouvant envoyer des requêtes HTTP POST

Webhook vs API

Fonctionnalité	Webhooks	API REST
Direction	Externe → Blitz Rocket	Votre code → Blitz Rocket
Authentification	Secret webhook	Clé API
Cas d'utilisation	Automatisation pilotée par événements	Opérations à la demande
Temps réel	Oui (push)	Non (pull)

Utilisez les webhooks lorsque vous souhaitez une création automatisée et pilotée par événements des participations et un suivi des achats. Utilisez l'API REST lorsque vous avez besoin d'un contrôle précis des opérations.