ワンクリック登録解除

ワンクリック登録解除者リスト取得API

ワンクリック登録解除リクエストを受理した配信先メールアドレスの情報を取得するAPIです。取得したデータをもとにお客様が管理する配信リストを更新し、該当の配信先へのメール配信を停止してください。

機能説明

弊社のワンクリック登録解除システムで受理した登録解除者リストを取得します。取得データをお客様の配信リストに反映し、対象の配信先を配信対象から除外してください。

解除者リストは、リクエストを受け付けてから90日間保持されます。保持期間中は自動的に配信対象から除外されるため、リクエストを受け付けた時点以降、その宛先への配信は行われません。
配信を再開したい場合は、ワンクリック登録解除者除外APIを利用してください。

ワンクリック登録解除者除外API
補足説明
API v1を弊社サービス環境以外で利用している場合は、自動除外は行われません。この場合は、速やかに配信リストを更新をしてください。
注意
本システムでワンクリック登録解除リクエストを受理していない場合は、解除者リストを取得できません。
配信予約時に、<unsubscribe_url>要素にhttpsリクエストURLを直接指定する場合は注意してください。
data要素(配信予約)

解除者リストは、認証情報として指定されたサービスと、そのサービスで配信されたHeader Fromアドレスを指定して、１日単位で取得できます。日付の範囲指定や、複数のHeader Fromアドレスをまとめて指定して取得することはできません。

接続先

本APIの接続先は以下の通りです。

https://(ドメイン名)/tm/unsubscribe_requesters.php

リクエスト

ヘッダ

HTTPプロトコルで送受信を行う場合は、HTTPヘッダが必要です。
リクエスト時には、以下の項目を設定してください。

ヘッダ名 値 内容
Content-Type application/octet-stream リクエストのコンテンツタイプを指定します。
他の値でもテキストとして認識される設定であれば動作する場合がありますが、弊社サポート対象外です。

ボディパラメーター

XML形式で設定します。

項目 データ型 必須 説明
request データなし ◯ ルート要素であり、API v1で使用するXMLをまとめる唯一の要素
auth データなし ◯ リクエスト時に認証情報を定義する要素
詳細は以下ページを参照してください
auth要素(共通)
site データなし ◯ 利用するサイトIDを指定
service データなし ◯ 利用するサービスIDを指定
name 文字列(CDATA) ◯ ユーザ名を指定
pass 文字列(CDATA) ◯ パスワードを指定
unsubscription_request データなし ◯ 登録解除リクエストに関する要素
header_from 文字列 ◯ Header Fromアドレス を指定
year 数値 ◯ ワンクリック登録解除のリクエストを受理した年を指定
month 数値 ◯ ワンクリック登録解除のリクエストを受理した月を指定
day 数値 ◯ ワンクリック登録解除のリクエストを受理した日を指定

レスポンス

レスポンスは以下の通りです。

ボディパラメーター

項目 データ型 必須 説明
response データなし ◯ ルート要素であり、API v1で使用するXMLをまとめる唯一の要素
unsubscribers データなし ◯ ワンクリック登録解除リクエストの受理に関する要素
header_from 文字列 ◯ リクエストしたHeader Fromアドレス
requesters データなし ◯ ワンクリック登録解除リクエストを受理した配信先リストに関する要素
requester データなし ◯ ワンクリック登録解除リクエストを受理した配信先に関する要素
message_id 文字列 ◯ 配信時にmessage-idヘッダに指定された文字列。配信IDを含む形式であり、実際の配信を特定可能。
message_to 文字列 ◯ 登録解除リクエストを受理した配信先メールアドレス
datetime 文字列 ◯ 登録解除リクエストを受理した日時 (RFC 2822/3339形式)
filtered 文字列 ◯ 該当の配信先メールアドレスが配信先から除外される対象かどうか（ 除外対象：1 / 除外対象外：0 ）
補足説明
レスポンスのサイズは最大8MB(解除者リストが約2万件)です。
<filtered> 要素は、配信先の自動除外機能が実行できないシステム構成(※)の場合、常に0です。
※配信予約時に直接解除用URLを指定する（<unsubscribe_url>要素にhttpsリクエストURLを指定する）場合や、弊社サービス環境以外でのご利用の場合。
配信予約API
data要素(配信予約)
<send_list>
    <data id="1">
        <address device="0">xxx@example.com</address>
        <unsubscribe_url>https://example.com/xxxxxxxx</unsubscribe_url>
    </data>
</send_list>

サンプル

リクエスト

<?xml version="1.0" encoding="UTF-8" ?>
<request>
  <auth>
    省略
  </auth>
　<unsubscription_request>
    <header_from>xxx@example.com</header_from><!—- Header Fromアドレス -->
    <year>2024</year><!—- 年 -->
    <month>5</month><!—- 月 -->
    <day>4</day><!—- 日 -->
  </unsubscription_request>
</request>

レスポンス

<?xml version="1.0" encoding="UTF-8" ?>
<response>
  <unsubscribers>
    <header_from>xxx@example.com</header_from><!-- Header Fromアドレス -->
    <requesters>
      <requester><!-- 取得したデータ分繰り返される。 -->
        <message_id>xxx@example.com</message_id><!-- メッセージID -->
        <message_to>xxx@example.com</message_to><!-- 送信先メールアドレス –->
        <datetime>2021/05/01 16:34</datetime><!-- リクエスト受理日時 -->
        <filtered>0</filtered><!-- フラグ 1: 0: -->
      </requester>
    </requesters>
  </unsubscribers>
</response>