セットアップ

サービススペック API v1

リクエストサイズ
  • キューイングモード：500Mbyte
    ※500Mbyteを超た場合はリクエストエラーとなります。
    ※delivery要素の複数指定はできません。

ファイル容量が最大値を超えた場合は受け付けません。
エラー番号：3407「XMLが不正です」が発生します。
APIモジュール xmlのリクエスト受付レスポンスが返答されるまでは、次のリクエストを送信しないでください。
通信方式 https通信にて実施。
認証 HTTPヘッダ記載の認証情報
リクエスト時に、GUIユーザにて認証。
※管理画面で許可したサービスに対してのみ配信することが可能
配信リクエスト処理結果
  • XMLサイズが25Kbyte未満のリクエストの場合
    配信予約の配信データ作成処理が完了したあとに、配信IDを返答。
    エラーの場合はエラー内容をXMLで返答。
  • XMLサイズが25Kbyte以上の場合
    配信予約の受付が確定したあとに配信IDを返答。
    エラーの場合はエラー内容をXMLで返答。
    受付確定後の配信データ作成処理にてエラーが発生した場合は、認証に使用したGUIユーザに登録されているメールアドレスへ通知。

配信予約

配信時刻指定 即時配信
予約配信
※32日後までの指定した時刻に配信開始することが可能。
件名 本文指定 リクエストされたXMLファイルに記載された、件名 本文を配信することが可能。
テンプレート指定 予めGUIで登録したテンプレートを指定して配信することが可能。
※テンプレートIDを指定して配信する
属性値差し込み 件名、本文またはテンプレート内の代替文字を、指定した共通文字列に置換することが可能。
タグ：##com_txt_<No>##
件名、本文またはテンプレート内の代替文字を、１アドレス毎に指定した個別文字列に置換することが可能。
タグ：##int_txt_<No>##
件名、本文またはテンプレート内の代替文字を、１アドレス毎に指定した共通文字列に置換することが可能。
※条件判断による差し込みはできません。
タグ：##ext_txt_<No>##
属性値差し込み上限数 255個まで
画像差し込み 本文またはテンプレート内の代替文字を、指定した共通画像に置換することが可能。
タグ：##com_img_<No>##
画像指定は、URL（http, https）での指定が可能。
送信先メールアドレス指定 配信リクエストにアドレスリストを含め配信することが可能。
GUIエンドユーザテーブルに登録されているアドレスに対し配信することが可能。
※XMLサイズが25Kbyte 未満の場合に利用が可能。
絵文字
  • キャリア絵文字
  • Unicode絵文字
添付ファイル機能 オプション 2Mbyteまでのファイルの添付が可能。添付できるファイルは最大 3 件、最大サイズは 2Mbyte です。

  • 最大サイズは 3 ファイルの合計になります。
  • PCアドレス向けメールのみの対応となります
    （配信文字コードが「UTF-8」の場合は、全てのメールにファイルが添付されます。）
  • 添付ファイルサイズによって下記の通り、分間の配信通数を制御しておりますのでご注意ください。
    ～ 100Kbyte 指定なし
    ～ 500Kbyte 150 通/分
    ～ 1Mbyte 75 通/分
    ～ 1.5Mbyte 50 通/分
    ～ 2Mbyte 38 通/分
  • 配信速度指定（throttle）を指定した場合は、より小さい値の配信速度で送信されます。

情報取得

ステータス取得 配信状況をXMLで取得することが可能。
承認、配信完了のステータス、配信完了時は配信成功数、失敗数を取得可能。
配信結果ダウンロード 配信結果（成功、失敗）をXMLでダウンロードすることが可能。
配信IDを指定し、配信単位でアドレスを取得することが可能。
対象期間を指定し、配信期間でアドレスを取得することが可能。
送信時に指定した任意の文字列1つを取得可能。
エラーリストダウンロード バウンス結果をXMLでダウンロードすることが可能。
配信IDを指定し、配信単位でアドレスを取得することが可能。
対象期間を指定し、配信期間でアドレスを取得することが可能。
送信時に指定した任意の文字列1つを取得可能。
クリックカウント・開封結果取得 配信IDまたは、期間を指定してクリックカウント・開封結果を取得することが可能。

ワンクリック登録解除

ワンクリック登録解除設定 ワンクリック登録解除を利用するFromアドレスを登録。
※GUIのサービス設定画面にて、
ワンクリック登録解除者リスト ワンクリック登録解除リストに登録されたメールアドレスは、登録後90日間自動的に配信除外されます。
※90日経過後は自動的に配信が再開されるため、お客様の配信リストにて配信停止する対応が必要です。
ワンクリック登録解除者リスト取得 ワンクリック登録解除リストを取得可能。
対象のFromアドレス、登録解除リストに登録された日にて検索可能。
※最大レスポンスサイズはXMLレスポンスデータの書式で最大8MB（おおよそ2万件）です。
ワンクリック登録解除者除外
（配信再開設定）		 ワンクリック登録解除リストに登録されたメールアドレスに対して、再度、配信を再開する設定が可能。
※登録解除者リストへの登録期間（90日）が経過すると、配信は再開されます。
独自で作成したワンクリック登録解除URLの設定 ワンクリック登録解除のリクエストを受け付けるシステムをお客様で準備される場合、宛先メールアドレス毎にワンクリック登録解除URLを設定することが可能。
※独自で作成したワンクリック登録解除URLを指定する場合は、自動除外と再配信設定は利用できません