配信結果取得

配信予約後に配信処理をおこなったメールアドレスの配信結果を取得します。 未配信の場合、データの取得はできません。

配信予約

メソッドとURL

リクエスト

URLパラメーター

レスポンス

ステータスコード

上記以外のステータスコードが返却される場合もあります。 その場合は、RFC2616規定のHTTPレスポンスステータスコード一覧をご確認ください。

HTTPレスポンスステータスコード一覧

ボディーパラメーター

JSON形式で取得されます。

項目		型	説明
items		Object Array	レスポンス情報が設定されます。
	mail_id	String	各宛先毎に割り当てられたメールID。
	destination_type	String	宛先アドレスのタイプ。
	to	String	宛先のメールアドレス。
	from	Object	送信時に指定したfromアドレス。
	status	Number	メールアドレス単位の送信成否。
	message	String	配信結果情報。 詳細は以下をご参照ください。 SMTP応答コード一覧
	timestamp	String	statusが更新された日時が設定されます。
count		Number	itemsの設定された個数が設定されます。
total		Number	返却できないデータも含めた検索結果数が設定されます。
message		String	取得エラー時に補足メッセージが指定されます。

宛先アドレスのタイプ

配信予約で指定した、宛先アドレスのタイプが設定されます。 返却される値は、To、Cc、Bccの3種類となります。

メールアドレス単位の配信ステータス

配信結果により、以下の値が設定されます。

※配信予約API実行直後は、配信予約情報の反映がされておらず「”message”: “Not Found”」が返却される場合がございます。時間をおいて実行をお願いします。

配信結果情報

配信処理を実施した際の送信結果や、バウンスメール受信によるエラー情報が登録されます。

配信結果ステータスコード一覧

サンプル

レスポンス

正常

{
"items":[
    {
      "mail_id":"0000000",
      "destination_type":"To",
      "to":"xxxxxxxxx@xxxx.jp",
      "from":"xxxxxxx@xxx.jp",
      "status":1,
      "message":"250 Requested mail action okay completed",
      "timestamp":"2020-01-01T00:00:00+09:00"
    }
  ],
  "count": 1,
  "total":1
}

エラー

{
  "message":"Too Many Requests"
}