Aller au contenu

Nouvelles tentatives

Une distribution réussit lorsque votre endpoint répond avec un statut 2xx en moins de 15 secondes. Toute autre réponse (statut non 2xx, redirection, délai dépassé, erreur de connexion, erreur TLS) est un échec et est retentée.

SpacePost effectue jusqu’à 8 tentatives : la première immédiatement, puis des nouvelles tentatives avec des délais croissants après chaque échec.

Tentative Délai après l’échec précédent Environ après l’événement
1 immédiate 0
2 5 secondes 5 s
3 5 minutes 5 min
4 30 minutes 35 min
5 2 heures 2 h 35 min
6 5 heures 7 h 35 min
7 10 heures 17 h 35 min
8 10 heures 27 h 35 min

Après la 8e tentative en échec, la distribution est marquée failed et plus aucune tentative automatique n’est effectuée. Vous pouvez la rejouer manuellement.

  • Le webhook-id est identique à chaque tentative, et le corps aussi. Le webhook-timestamp et la signature sont régénérés à chaque tentative.
  • La distribution se fait au moins une fois. Un 2xx lent qui arrive après le délai d’attente est traité comme un échec : votre endpoint peut donc voir le même événement deux fois. Dédupliquez sur webhook-id.
  • L’ordre n’est pas garanti. Un email.delivered retenté peut arriver après un email.opened plus tardif. Utilisez created_at dans le payload et ne ramenez jamais l’état d’un e-mail en arrière.
  • Les webhooks désactivés ou supprimés ne reçoivent plus de distributions ; leurs distributions en attente sont marquées comme échouées.
  • Les corps de réponse (le premier 1 Ko) et les codes de statut des tentatives récentes sont visibles dans le journal des distributions du tableau de bord, qui conserve 30 jours d’historique.