Salta ai contenuti

Nuovi tentativi

Una consegna ha successo quando il tuo endpoint risponde con uno stato 2xx entro 15 secondi. Qualsiasi altra cosa (uno stato diverso da 2xx, un redirect, un timeout, un errore di connessione, un errore TLS) è un fallimento e viene ritentata.

SpacePost fa fino a 8 tentativi: il primo subito, poi nuovi tentativi con ritardi crescenti dopo ogni fallimento.

Tentativo Ritardo dopo il fallimento precedente Circa dopo l’evento
1 immediato 0
2 5 secondi 5 s
3 5 minuti 5 min
4 30 minuti 35 min
5 2 ore 2 h 35 min
6 5 ore 7 h 35 min
7 10 ore 17 h 35 min
8 10 ore 27 h 35 min

Dopo l’8° tentativo fallito la consegna viene contrassegnata come failed e non vengono fatti altri tentativi automatici. Puoi rinviarla manualmente.

  • Il webhook-id è lo stesso a ogni tentativo, e il corpo è identico. Il webhook-timestamp e la firma vengono rigenerati a ogni tentativo.
  • La consegna è at-least-once. Un 2xx lento che arriva dopo il timeout viene trattato come un fallimento, quindi il tuo endpoint potrebbe vedere lo stesso evento due volte. Deduplica sul webhook-id.
  • L’ordine non è garantito. Un email.delivered ritentato può arrivare dopo un email.opened successivo. Usa created_at nel payload e non riportare mai indietro lo stato di un’email.
  • I webhook disabilitati o eliminati smettono di ricevere consegne; le consegne in sospeso a loro destinate vengono contrassegnate come fallite.
  • I corpi delle risposte (primo 1 KB) e i codici di stato dei tentativi recenti sono visibili nel log delle consegne della dashboard, che conserva 30 giorni di cronologia.