リトライ
エンドポイントが 15 秒以内に 2xx のステータスで応答すると、配信は成功です。それ以外(2xx 以外のステータス、リダイレクト、タイムアウト、接続エラー、TLS エラー)は失敗とみなされ、再試行されます。
スケジュール
Section titled “スケジュール”SpacePost は最大 8 回試行します。最初の 1 回はすぐに行い、その後は失敗のたびに間隔を延ばして再試行します。
| 試行 | 直前の失敗からの待機時間 | イベントからのおおよその経過時間 |
|---|---|---|
| 1 | 即時 | 0 |
| 2 | 5 秒 | 5 秒 |
| 3 | 5 分 | 5 分 |
| 4 | 30 分 | 35 分 |
| 5 | 2 時間 | 2 時間 35 分 |
| 6 | 5 時間 | 7 時間 35 分 |
| 7 | 10 時間 | 17 時間 35 分 |
| 8 | 10 時間 | 27 時間 35 分 |
8 回目の試行が失敗すると、配信は失敗としてマークされ、以降の自動的な試行は行われません。手動で再送できます。
知っておくこと
Section titled “知っておくこと”webhook-idはどの試行でも同じで、ボディも同一です。webhook-timestampと署名は、試行のたびに再生成されます。- 配信は少なくとも 1 回です。 タイムアウト後に届いた遅い
2xxは失敗として扱われるため、エンドポイントが同じイベントを 2 回受け取ることがあります。webhook-idで重複を排除してください。 - 順序は保証されません。 再試行された
email.deliveredが、後のemail.openedより遅れて届くことがあります。ペイロードのcreated_atを使い、メールの状態を後戻りさせないでください。 - 無効化または削除された Webhook には配信されなくなり、保留中の配信は失敗としてマークされます。
- 直近の試行のレスポンスボディ(先頭 1 KB)とステータスコードは、ダッシュボードの配信ログで確認できます。ログは 30 日分の履歴を保持します。