data要素(配信結果取得)

メールアドレスごとのデータを指定する要素です。エラーリスト取得 API で要素 data と同じ意味を持ちますが要素status が追加されています。

<data id ="xxxx-xxxxx">
    <sent_date>2021/05/01 16:34</sent_date>
    <to_addr><![CDATA[xxxxxx@xxx.jp]]></to_addr>
    <from_addr><![CDATA[xxxxxx@xxx.jp]]></from_addr>
    <key_field><![CDATA[no_data]]></key_field >
    <status>0</status>
    <message code="000"><![CDATA[XXXXXXXXXXXXXXX]]></message>
</data>
ご注意
何らかのエラーにより配信処理自体がおこなわれていない場合、「result code=”0″」(送信成功)となりますが、sent_list は空の状態となります。

構成要素

以下の項目が、data要素(配信ステータス取得)固有となります。

  1. sent_date
  2. to_addr
  3. from_addr
  4. key_field
  5. status
  6. message

sent_date

配信処理を MTA に対し実施した時間(送信日時と表現します)を指定する要素です。

<sent_date>2021/05/01 16:34</sent_date>
構成要素 送信日時(YYYY/MM/DD HH:MI 形式)

to_addr

メール配信の宛先を指定する要素です。要素 data 内のデータはすべて、このメールアドレス向けに配信した結果を意味しています。

<to_addr><![CDATA[xxxxxx@xxx.jp]]></to_addr>
構成要素 メールアドレス

from_addr

メール配信時に利用した送信元メールアドレスを指定する要素です。API v1 の場合は、管理画面 のサービスに設定しているものとは異なるメールアドレスを設定することができるため、配信に使った from アドレスが確認できます。

<from_addr><![CDATA[xxxxxx@xxx.jp]]></from_addr> 
構成要素 メールアドレス

key_field

メール配信時に指定した、要素 key_field の値を設定する要素です。

<key_field><![CDATA[no_data]]></key_field > 
構成要素 任意の文字列(未設定の場合は、「no_data」と指定されます。)

status

該当するメールアドレスへの送信処理の結果を設定する要素です。

<status>0</status>
構成要素 数値 0:送信成功
1:送信失敗

 

message

該当するメールアドレスへの送信処理の結果情報を設定する要素です。

<message code="000"><![CDATA[XXXXXXXXXXXXXXX]]></message>
属性名 内容 数値/文字列
code エラーメッセージ 文字列