サービススペック 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>##
件名、本文またはテンプレート内の代替文字を、1アドレス毎に指定した個別文字列に置換することが可能。
タグ:##int_txt_<No>##
件名、本文またはテンプレート内の代替文字を、1アドレス毎に指定した共通文字列に置換することが可能。
※条件判断による差し込みはできません。
タグ:##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または、期間を指定してクリックカウント・開封結果を取得することが可能。