Livraison et relecture
Livraison, tentatives et mise en pause automatique
Une livraison en échec (réponse non 2xx, délai dépassé ou erreur réseau) est réessayée avec un délai exponentiel : 5 s, 30 s, 2 min, 10 min, 1 h, 4 h, puis une dernière tentative environ 24 heures après la première. Si un point de terminaison échoue pendant 72 heures d'affilée, il est mis en pause automatiquement et son créateur est averti par e-mail — aucun autre événement n'est livré tant qu'il n'est pas corrigé et repris.
Dépanner les problèmes de livraison
Résultats de réponse courants et comment résoudre chacun d'eux.
Connexion impossible | Assurez-vous que votre hôte est accessible publiquement et non bloqué par un pare-feu. |
Redirection 3xx | Les redirections sont traitées comme des échecs. Faites pointer le point de terminaison directement vers l'URL finale. |
Erreur client 4xx | Votre serveur a rejeté la requête. Vérifiez que l'URL est correcte et ne nécessite pas une authentification que nous n'envoyons pas. |
Erreur serveur 5xx | Votre serveur a rencontré une erreur lors du traitement de la requête. Consultez les journaux de votre application. |
Délai dépassé | Votre point de terminaison a mis trop de temps à répondre. Renvoyez immédiatement un 2xx et traitez l'événement de façon asynchrone. |
L'ordre des événements n'est pas garanti
Les événements peuvent arriver dans le désordre, et les tentatives signifient que le même événement peut être livré plus d'une fois. Ne comptez pas sur l'ordre de livraison, et dédupliquez à partir de l'id de l'enveloppe — jamais à partir de created_at, deux événements pouvant partager un horodatage.
Relecture
Chaque livraison individuelle — réussie ou échouée — peut être relue à la demande depuis l'historique des livraisons dans Paramètres → Développeur → Webhooks. Une relecture réintègre le même pipeline de livraison avec un nouveau cycle de tentatives ; elle ne renvoie rien rétroactivement de son propre chef.
Tester votre point de terminaison
Utilisez « Envoyer un événement de test » dans Paramètres → Développeur → Webhooks pour déclencher un événement synthétique ping.sent via le véritable pipeline de livraison — signé de la même façon que tout autre événement —, afin de vérifier votre point de terminaison sans attendre qu'un événement réel se déclenche.