Tentatives & Dépannage
Comprendre les calendriers de tentatives de webhooks, les délais d'expiration (timeouts) et les règles de désactivation automatique.
Lorsque Parsurai tente de livrer un événement de webhook et que votre serveur ne répond pas avec succès, nous suivons un calendrier de tentatives strict pour garantir une livraison.
Calendrier des Tentatives (Échelle)
Si votre serveur répond avec une erreur réessayable, ou si la requête expire (timeout), nous réessayons la livraison avec un backoff exponentiel (délai de base de 30 secondes, multiplicateur 4x, plafonné à 6 heures, avec jusqu'à ±50 % de variation aléatoire). Nous arrêtons les tentatives — selon la première condition atteinte — après 8 tentatives ou 24 heures depuis la survenue de l'événement.
| Tentative | Délai approximatif depuis la précédente | Temps cumulé approximatif |
|---|---|---|
| 1ère (Initiale) | Immédiat | 0 |
| 2ème | ~30 secondes | ~30 secondes |
| 3ème | ~2 minutes | ~2,5 minutes |
| 4ème | ~8 minutes | ~10,5 minutes |
| 5ème | ~32 minutes | ~43 minutes |
| 6ème | ~2 heures 8 minutes | ~2 heures 51 minutes |
| 7ème | ~6 heures (plafond) | ~8 heures 51 minutes |
| 8ème (Finale) | ~6 heures (plafond) | ~14 heures 51 minutes |
Les délais réels varient de ±50 % en raison de la variation aléatoire, et le calendrier s'arrête plus tôt si l'événement atteint 24 heures.
Déclencheurs d'Échecs
Nous initions une nouvelle tentative dans les conditions suivantes :
- Codes d'état HTTP réessayables :
408,409,425,429, ou tout code5xx. - Délai d'attente de connexion : L'établissement de la connexion avec votre serveur prend plus de 5 secondes.
- Délai d'attente de lecture : La transmission de la requête et la lecture de la réponse prennent plus de 10 secondes.
- Échecs réseau : Échecs de résolution DNS, réinitialisation de connexion ou échecs de négociation SSL/TLS.
Tout autre code d'état non-2xx (y compris 410 Gone et les autres réponses 4xx) est considéré comme un échec définitif — il n'y a pas de nouvelle tentative, et le point de terminaison n'est pas automatiquement supprimé.
Politique de Pause Automatique
Un point de terminaison webhook est automatiquement suspendu pour éviter tout trafic inutile lorsque l'une des conditions suivantes est vraie :
-
Le point de terminaison a 20 livraisons consécutives en échec définitif, ou
-
72 heures se sont écoulées depuis la dernière livraison réussie du point de terminaison (ou depuis sa création, s'il n'a jamais réussi), alors qu'il a accumulé 5 échecs consécutifs ou plus.
-
Le statut du point de terminaison passe à
PAUSEDdans votre tableau de bord développeur. -
Une notification par e-mail est envoyée aux administrateurs du compte.
-
Aucune nouvelle livraison de webhook ne sera mise en file d'attente pour ce point de terminaison tant qu'il est suspendu.
-
Une fois le problème résolu, vous pouvez réactiver manuellement le point de terminaison via l'interface des paramètres développeur.
Renvoyer des Webhooks (Replay)
Vous pouvez renvoyer manuellement toute livraison de webhook historique des 30 derniers jours (offre Pro) ou 90 derniers jours (offre Business) via l'interface des paramètres développeur. Les replays créent un nouvel enregistrement de livraison faisant référence à l'événement d'origine, vous permettant de réintégrer des données perdues sans modifier les payloads des webhooks.