Appliquez ces recommandations avant le passage en production (live).
Code HTTP 2xx
L’URL de destination d’un webhook doit toujours renvoyer un code HTTP 2xx.
Le code HTTP confirme uniquement la bonne réception du webhook. N’utilisez pas les codes d’erreur HTTP pour signaler des erreurs métier.
Délais de réponse
L’URL de destination devrait répondre rapidement. Visez un délai de réponse de moins de 500 ms ; jusqu’à une seconde reste acceptable de façon occasionnelle. Ce sont des recommandations, pas des limites appliquées.
HUB2 attend une réponse 5 secondes au maximum. Au-delà, l’envoi est considéré comme un échec et l’événement est renvoyé, ce qui peut à terme désactiver le webhook (voir Comportement). Traitement asynchrone
Des mécanismes simples permettent de respecter ces délais.
En particulier, vérifiez la signature, confiez le webhook à un traitement asynchrone (une file d’événements, par exemple) et répondez immédiatement avec un code 2xx.
Exemple en JavaScript :
Répartition des événements entre plusieurs webhooks
Si un seul webhook est enregistré avec tous les événements, sa désactivation interrompt l’envoi de tous ces événements.
Pour l’éviter, enregistrez un seul événement par webhook : si un webhook est désactivé, les autres continuent de fonctionner.