Retries & rejeu

Ce qui compte comme un succès

Une livraison réussit quand votre endpoint répond par un statut 2xx en moins de 10 secondes. Les redirections ne sont pas suivies. Tout autre statut, un délai dépassé, une erreur TLS ou une connexion refusée est un échec.

Nouvelles tentatives automatiques

Une livraison en échec est retentée 5 fois, avec un backoff exponentiel :

Après la dernière, la livraison est marquée en échec. L’event, lui, est conservé 30 jours : vous pouvez encore le rejouer ou le lire via l’API Events.

Du fait des nouvelles tentatives, un même event peut vous parvenir plusieurs fois, et les events peuvent arriver dans le désordre. Dédupliquez sur l’id de l’event et, quand l’ordre compte, comparez created ou relisez l’état le plus récent de l’objet.

Désactivation automatique

Un endpoint dont toutes les livraisons échouent depuis 3 jours est désactivé automatiquement. Les propriétaires de l’espace reçoivent un e-mail et une notification. Réparez l’endpoint puis réactivez-le depuis sa page : les nouveaux events recommencent à arriver, et vous pouvez rejouer ceux que vous avez manqués.

Inspecter les livraisons

La page de chaque endpoint, dans Réglages → Développeurs → Webhooks, liste ses livraisons récentes, avec pour chaque tentative :

• l’event et son type ;
• le statut HTTP renvoyé par votre endpoint et son temps de réponse ;
• les en-têtes et le corps exacts envoyés par Skoup ;
• le corps de réponse de votre endpoint (8 premiers Ko).

Rejouer un event

Depuis une livraison ou depuis Réglages → Développeurs → Events, cliquez sur Renvoyer pour livrer à nouveau un event à un endpoint. Le renvoi est une nouvelle livraison avec le même ID d’event : votre déduplication continue de fonctionner.

Envoyer un event de test

Sur la page d’un endpoint, Envoyer un event de test livre un exemple de n’importe quel type d’event, avec "livemode": false. C’est le moyen le plus rapide de vérifier votre contrôle de signature et votre parsing avant l’arrivée des vrais events.