Un webhook est une URL sur votre serveur que nous appelons quand quelque chose se produit, pour que votre code n’ait pas à interroger sans cesse.
En configurer un
- Dans Développeurs, choisissez Webhooks, puis Ajouter un point de terminaison.
- Saisissez une URL HTTPS et choisissez les événements voulus, par exemple
question.completed. - Copiez le secret de signature. Il ne s’affiche qu’une fois.
Événements
Questions réservées, terminées, incomplètes, annulées ou refusées ; crédits achetés, qui s’épuisent ou qui expirent ; contestations résolues ; et connexion proche de son plafond.
Vérifier la signature
Chaque envoi comporte un en-tête x-50heads-signature avec un horodatage et un HMAC-SHA256 du corps calculé avec votre secret. Vérifiez-le avant de vous fier au contenu. La documentation des webhooks (en anglais) propose du code à copier.
Nouvelles tentatives
Répondez avec un statut 2xx en moins de dix secondes. Sinon, nous réessayons avec un délai croissant, huit fois sur 24 heures. Le journal Envois montre chaque tentative, et vous pouvez rejouer n’importe quel envoi.
Il arrive qu’un envoi arrive deux fois ou dans le désordre. Utilisez l’identifiant de l’événement pour ignorer les doublons.