機能説明
メールアドレスを指定し、バウンスの履歴を取得します。
同一のメールアドレスのバウンス履歴の内、最新の1000件分まで取得することができます。
バウンス履歴は、通常過去7日分を保存しています。
ジョブは非同期で実行され、レスポンスに含まれるジョブIDで結果を取得することができます。
リクエスト
エンドポイント
/v2/bounces/[メールアドレス]
HTTPメソッド
GET
リクエストボディ
なし
レスポンス
ステータスコード
|
状態
|
コード
|
|---|---|
| 成功 | 200 |
| メールアドレスが不正 | 400 |
| 認証失敗 | 401 |
| 実行中の同種別ジョブが多すぎる | 403 |
| 存在しないエンドポイント | 404 |
| 許可されていないHTTPメソッド | 405 |
| システムエラーが発生した | 500 |
| システムが一時的にサービスを提供できない状態になっている | 503 |
| システムのタイムアウト | 504 |
レスポンスボディ
|
要素名
|
型
|
要素数
|
説明
|
|---|---|---|---|
| code | 数値 | 1 | ステータスコード |
| job_id | 数値 | 1 | ジョブID |
成功
{"code":200, "job_id":10}
失敗
{"code":400, "validation_errors":{"envelope_to":"must be email address"}}