機能説明
メール配信における動作設定を行うことができます。
設定できる項目は、下記のとおりです。
最低一つの項目を更新する必要があります。
- 再送上限回数(defer_limit)
リクエスト
エンドポイント
/v1/settings/mails
HTTPメソッド
POST
リクエストボディ
JSON形式であること
要素名
|
型
|
要素数
|
制限
|
説明
|
---|---|---|---|---|
defer_limit | 数値 | 1 |
|
再送試行を行う上限回数 |
リクエストボディ サンプル
レスポンス
ステータスコード
状態
|
コード
|
---|---|
成功 | 200 |
リクエストボディがjsonではない | 400 |
jsonリクエストのバリデーションエラー | 400 |
認証失敗 | 401 |
存在しないエンドポイント | 404 |
許可されていないHTTPメソッド | 405 |
システムエラーが発生した | 500 |
システムが一時的にサービスを提供できない状態になっている | 503 |
システムのタイムアウト | 504 |
レスポンスボディ
成功
{
"code":200,
"data":[
{"defer_limit":10}
]
}
失敗
{"code":400,"validation_errors":{"defer_limit":"must be 0 times or more. current -1"}}
{"code":400,"validation_errors":{"defer_limit":"must be 20 times or less. current 21"}}
{"code":400,"data_error":{"data":"invalid format"}}
{"code":400,"validation_errors":{"any_defined_parameters":"required"}}
設定に関する説明
下記の説明を確認、理解した上で設定を変更してください。
デフォルト値を推奨値としており、利用者のユースケースに応じた変更を許可します。
デフォルト値を推奨値としており、利用者のユースケースに応じた変更を許可します。
再送上限回数
メールの送信において、宛先メールサーバの状況や宛先メールボックスの容量超過等、一時的なエラーによって配送が行えないケースが存在します。
一時的な配送エラーが起きた場合、autobahn MTAは一定の間隔を空けた上で再送試行を行います。
再送回数の上限に達した場合、そのメールはバウンスとして扱います。
デフォルト値は20回となっており、再送間隔を広げながらおよそ1週間かけて行います。
再送回数と、再送間隔の関係の目安は下記の表のとおりです。
再送回数と、再送間隔の関係の目安は下記の表のとおりです。
ただし、実際の再送間隔はサーバ状況等により左右されることがあります。
さらに、本設定の値を小さくした場合は、本来配送可能なメールが配送できなくなるリスクがあるため、留意してください。
再送回数
|
再送までの時間
|
初回配送試行後の経過時間
|
---|---|---|
1回目 | 1分 | 1分 |
2回目 | 4分 | 5分 |
3回目 | 5分 | 10分 |
4回目 | 10分 | 20分 |
5回目 | 10分 | 30分 |
6回目 | 30分 | 1時間 |
7回目 | 1時間 | 2時間 |
8回目 | 1時間 | 3時間 |
9回目 | 1時間 | 4時間 |
10回目 | 1時間 | 5時間 |
11回目 | 1時間 | 6時間 |
12回目 | 6時間 | 12時間 |
13回目 | 6時間 | 18時間 |
14回目 | 6時間 | 1日 |
15回目 | 1日 | 2日 |
16回目 | 1日 | 3日 |
17回目 | 1日 | 4日 |
18回目 | 1日 | 5日 |
19回目 | 1日 | 6日 |
20回目 | 1日 | 7日 |