エラーコード

APIエラーとSMTP応答の通知方法と、それぞれの対処法。

APIエラーの形式

APIエラーは、安定したコードとメッセージを含むJSONで返されます。処理ロジックではコードで判定し、メッセージは人に見せる場合にのみ使ってください。文言は変更されることがあります。

{
  "error": { "code": "invalid_recipient", "message": "The recipient address is not valid." }
}

再試行か、修正か?

エラーは2種類に分かれます。リクエストを修正する場合:429以外の4xxは送信内容に問題があることを示すため、再試行しても同じ結果になります。時間をおいて再試行する場合:429と5xxは一時的なエラーなので、指数バックオフと試行回数の上限を設けて再試行してください。

SMTP応答

SMTP応答は3桁のコードで始まります。2xxは成功、4xxは一時的な失敗で、送信側は後で再試行します。5xxは恒久的な失敗で、同じメッセージを同じアドレスに再送してはいけません。多くの応答には、5.1.1のような拡張コードが付き、原因を示します。

バウンス理由の読み方

バウンスの原因を最も早く把握できるのが拡張コードです。5.1.1はメールボックスが存在しないこと、5.2.2はメールボックスが満杯であることを示します。5.7.1は受信サーバーがポリシーに基づいて拒否したことを意味し、多くは認証や評判が原因です。4.x.xは一時的なもので、再試行されます。

バウンスへの対処

ハードバウンスしたアドレスはリストから削除し、ポリシーによる拒否はSPF、DKIM、DMARCの設定を確認して原因を調べてください。バウンス率の上昇は評判を損なうため、早めに対処しましょう。