冪等性と再試行

Sendery がメールを受け付けた後に、リクエストがタイムアウトすることがあります。そのまま送り直すと、同じメールが 2 通届く可能性があります。

冪等性キーは、1 通のメールを識別する値です。同じキーと内容で再試行すると、Sendery は重複送信せず、元のメールの ID と状態を返します。

メールを送信するときに Idempotency-Key ヘッダーを指定します。

• 新しいメールには固有のキーを使います。
• バックグラウンドジョブを含む再試行では、キーとリクエスト全体を変更しません。
• 意図的にもう 1 通送る場合は、新しいキーを使います。

同じキーでリクエストの内容を変えると、409 idempotency_conflict が返されます。

タイムアウト、一時的なサービスエラー、rate_limited エラーは、時間をおいて再試行します。レスポンスに Retry-After が含まれる場合は、指定された秒数だけ待ってください。

認証、テンプレート、請求のエラーは、原因を修正してから再試行します。