blastengine API (1.3.2)

blastengine API の利用に関して

API の利用には、blastengineのサービス利用規約が適用され、API を利用すると同利用規約に同意したものとみなされます。

認証について

APIキー発行時に作成される BearerToken を Authorization ヘッダにセットしてリクエストをサーバーに発行することでAPIを利用できます。 BearerToken はユーザごとに異なりますので、 BearerToken を使うことでそのユーザのアクセス権を保持しているということになります。

概要

API を利用する際の共通仕様は以下のとおりです。

項目	説明
APIのバージョン	1.3.2
使用するプロトコル	HTTPS
文字コード	UTF‒8

リクエストヘッダ

API をリクエストする場合には、以下の共通リクエストヘッダが必要です。

ヘッダ	説明
Authorization	ユーザー認証情報
Content-Type	添付データのコンテンツの種類 ( `application/json` / `multipart/form-data`(一部))
Accept-Language	ロケール情報 ( `ja-JP` / `en-US` )

レスポンスヘッダ

サーバから共通して返されるレスポンスヘッダは以下です。

ヘッダ	説明
X-RateLimit-Remaining	アクセス可能な残りの回数
X-Rate-Limit-Retry-After-Seconds	アクセス回数がリセットされるまでの時間(秒)

API BearerToken

API利用時には、前項で作成した BearerToken を利用して以下のようなリクエストをサーバーに発行します。
[BearerToken]には作成した BearerToken を入れてください。

curl https://app.engn.jp/api/v1/XXXXX -H "Authorization: Bearer [BearerToken]"

※ API BearerToken の生成方法
下記に記載する手順で生成してください。
[前提] API BearerToken の生成には apiKey が必要です。 apiKeyの発行・再発行は管理画面上から行ってください。

ログインID + apikey に Sha256 をかけます。コマンド実行時に表示されるハイフンは省いてください。
大文字は全て小文字化します。
base64 エンコードをかけます。エンコード結果に改行が含まれる場合、改行を削除をしてください。

echo -n 'ログインID + apikey' | shasum -a 256
出力された文字列を全て小文字化します
echo -n '小文字化した文字列' | base64

利用例

以下の例をご利用の場合、記載の順にAPIを実施してください。

・利用例A：トランザクション配信

配信登録(トランザクション) API
配信状況は配信詳細 APIの配信ステータスをご確認ください。

・利用例B：一斉配信

配信登録: 開始(一斉配信) API
発行した配信IDに対して、以下のいずれかを利用して配信先アドレスを登録します。
配信登録: 完了(一斉配信) API で配信予約日時の登録をします。
配信予約日時経過後の配信状況は配信詳細 APIの配信ステータスをご確認ください。

※配信数によっては全てのメール配信処理完了までに時間がかかる可能性があります。

・利用例C：配信先アドレス一括登録

配信先アドレス一括登録ジョブの開始 API
ジョブの実行結果は配信先アドレス一括登録ジョブの取得 APIから確認できます。
- 一部成功や全て失敗している場合、エラーの内容が出力されたCSVのダウンロードURLが発行されている場合があります。
2.でダウンロードURLが発行された場合、配信先アドレス一括登録エラーCSVダウンロード APIからエラー内容を確認いただき、
再度1.を実施してください。

Rate Limit

Rate Limitは500req/mでございます。 blastengine APIには、サーバー負荷を抑える目的で呼び出し回数制限の仕組みが実装されています。 1分間に500回を超えた場合はリクエスト数制限超過エラーになります。 ※呼び出し回数制限値は予告なく変更する場合がございます。

配信登録上限

blastengine APIで登録できる配信の数には上限がございます。配信ステータスがEDITの配信が30件になりますと、それ以上配信登録ができなくなります。追加で配信登録を行う場合、EDITの配信を完了させるか、削除する必要がございます。

HTTPステータスコード

コード	種別	説明
200	OK	リクエスト成功
201	Created	リクエストは成功し、新たなリソースが作成された
400	Bad Request	リクエスト値が不正
401	Unauthorized	認証エラー
403	Forbidden	API 利用権限なし
404	Not Found	指定リソースが存在しない
405	Method Not Allowed	指定HTTPリクエストメソッドがサポートされていない
415	Unsupported Media Type	指定したリクエストの形式がサポートされていない
423	Locked	アクセス中アカウントのロック
429	Too Many Requests	リクエスト数制限超過
500	Internal Server Error	サーバエラー
502	Bad Gateway	web通信の高負荷によるエラー

各種ステータス・種別一覧

送信メール文字コード

送信メール文字コード

UTF-8

ISO-2022-JP
配信種別

配信種別説明

TRANSACTION 即時配信

BULK 一斉配信

SMTP SMTP配信

送信メール文字コード
UTF-8
ISO-2022-JP

配信種別	説明
TRANSACTION	即時配信
BULK	一斉配信
SMTP	SMTP配信

配信ステータス

ステータス	説明
EDIT	編集中
IMPORTING	配信アドレス一括インポート中
RESERVE	配信予約済
WAIT	配信待ち
SENDING	配信中
SENT	配信成功
FAILED	配信失敗

最終送信ステータス

ステータス説明

SENT 配信成功

RETRY 再送

HARDERROR ハードエラー

SOFTERROR ソフトエラー

DROP エラー停止アドレスに合致
ジョブステータス

ステータス説明

WAIT 処理待ち

STARTED 処理中

FINISHED 完了

FAILED 処理失敗

STOP 停止

SYSTEM_ERROR システムエラー

TIMEOUT タイムアウト

ステータス	説明
SENT	配信成功
RETRY	再送
HARDERROR	ハードエラー
SOFTERROR	ソフトエラー
DROP	エラー停止アドレスに合致

ステータス	説明
WAIT	処理待ち
STARTED	処理中
FINISHED	完了
FAILED	処理失敗
STOP	停止
SYSTEM_ERROR	システムエラー
TIMEOUT	タイムアウト

処理種別

処理種別	説明
DELIVERIES_TRANSACTION	トランザクションメール
DELIVERIES_BULK	一斉配信メール
MESSAGES_IMPORT	メッセージ登録一括インポート
MAIL_OPEN	メール開封CSV生成
ERRORS_DOWNLOAD	エラーリストCSV生成

レスポンスコード

コード番号	内容
250	配信に成功しました
421	宛先サーバから一時的に拒否されました
450	一時的に宛先のメールボックスが利用できません
451	宛先サーバで一時的なエラーが発生しました
452	宛先サーバのシステムリソースが不足しています
453	宛先サーバで一時的なエラーが発生しました
454	内部処理中にエラーが発生しました
500	1行に対する文章が長すぎるため受け付けられません
521	宛先のメールボックスがいっぱいです
530	宛先サーバへの送信には認証または暗号化が必要です
550	宛先のメールアドレスがありません
550(rejection)	宛先サーバから受信拒否を受けました
551	宛先のメールアドレスがありません
552	宛先のメールボックスがいっぱいです
553	宛先のメールボックスが利用できません
554	宛先サーバでエラーが発生しました
554(relay)	転送先メールサーバでエラーが発生しました
554(banned)	配信が禁止されたアドレスへの配信のためブロックしました
554(errors)	エラー停止リストに含まれる宛先であるため、配信がドロップされました

添付ファイルのサイズ制限と種類

blastengine では添付できるファイルのサイズには制限があり、契約により異なります(デフォルトは1MB)。
制限内であれば複数のファイルを添付できます。

またセキュリティ上の理由により次の種類のファイルは添付できません。

添付不可能な拡張子
.ade, .adp, .apk, .appx, .appxbundle, .bat, .bz2, .cab, .chm, .cmd, .com, .cpl, .dll, .dmg, .ex, .ex_, .exe, .gz, .hta, .ins, .isp, .iso, .jar, .js, .jse, .lib, .lnk, .mde, .msc, .msi, .msix, .msixbundle, .msp, .mst, .nsh, .pif, .ps1, .scr, .sct, .shb, .sys, .tgz, .vb, .vbe, .vbs, .vxd, .wsc, .wsf, .wsh, .zip

差し込みコードについて

blastengine では、差し込み機能を提供しております。送信先アドレス毎にメール本文の一部（お名前や会社名など）だけが異なるメールを送ることができますので、宛先毎に合わせてパーソナライズされたメールの送信が可能になります。

差し込みコードのご利用方法

差し込みコードのkeyを予め、メールの本文(text_part、html_part)に設定しておくことで、
メール送信時、差し込みコードのvalueに置き換えられます。また、差し込みコードの設定上限は50件でございます。

差し込みコード

key __prop1__ __prop2__ __prop3__

value テスト太郎 123456 ブラストエンジン
本文差し込みイメージ

key	__prop1__	__prop2__	__prop3__
value	テスト太郎	123456	ブラストエンジン

__prop1__ 様    

 （会員番号 __prop2__）    

  __prop3__ をご利用いただきありがとうございます。

テスト太郎 様    

 （会員番号 123456）    

  ブラストエンジン をご利用いただきありがとうございます。

配信の保管期限について

配信が開始されてから`62`日経過後に、配信情報とそれに関わる配信先アドレス、配信ログ情報は`全て削除`されます。

エラー停止について

1つの宛先に対し2週間以内に2度以上のハードエラーが発生すると、宛先はエラー停止対象となります。期間は最大で2週間となります。

deliveries

配信一覧

※配信の保管期限があります。ご注意ください。

query Parameters

text_part	string <= 300 characters テキストパート(正規表現不可, 部分一致)
html_part	string <= 300 characters HTMLパート(正規表現不可, 部分一致)
subject	string <= 30 characters 件名(正規表現不可, 部分一致)
from	string <= 254 characters 送信元アドレス(正規表現不可, 部分一致)
status[]	Array of strings <= 10 items Example: ?status[]} 配信ステータス
delivery_type[]	Array of strings <= 10 items Example: ?delivery_type[]} 配信種別(TRANSACTION \| BULK \| ALL)
delivery_start	string yyyy-MM-ddTHH:mm:ss+09:00 配信日時(開始位置) ISO 8601拡張形式のdate-time値
delivery_end	string yyyy-MM-ddTHH:mm:ss+09:00 配信日時(終了位置) ISO 8601拡張形式のdate-time値
size	integer [ 1 .. 1000 ] Default: 100 1ページ辺りの要素数
page	integer [ 1 .. 1000 ] Default: 1 取得するページ数 (1 indexed)
sort	string Default: "delivery_time:desc" 並び替え条件カンマ区切りにより複数指定可 (指定可能なソート = delivery_time:[asc\|desc], updated_time:[asc\|desc])

header Parameters

Authorization

required

string

認証トークン

Responses

200

配信履歴と予約のリストを返却します

400

バリデーションエラー

500

システム内部エラー

get /deliveries

Production server

https://app.engn.jp/api/v1/deliveries

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"data":
[
- {
  - "delivery_id": 1,
  - "from":
    {
    "email": "sample_1@example.com",
    "name": "送信者サンプル1"
    },
  - "status": "SENT",
  - "delivery_time": "2021-11-11T00:00:00+09:00",
  - "updated_time": "2021-11-01T00:00:00+09:00",
  - "created_time": "2021-01-01T00:00:00+09:00",
  - "reservation_time": "2021-11-11T00:00:00+09:00",
  - "delivery_type": "BULK",
  - "subject": "件名サンプル Vol.1"
  },
- {
  - "delivery_id": 2,
  - "from":
    {
    "email": "sample_2@example.com",
    "name": "送信者サンプル2"
    },
  - "status": "FAILED",
  - "delivery_time": "2021-01-11T12:34:56+09:00",
  - "updated_time": "2021-01-02T00:00:00+09:00",
  - "created_time": "2021-01-01T00:00:00+09:00",
  - "reservation_time": "2021-01-11T12:34:00+09:00",
  - "delivery_type": "TRANSACTION",
  - "subject": "件名サンプル Vol.2"
  },
- {
  - "delivery_id": 3,
  - "from":
    {
    "email": "sample_3@example.com",
    "name": "送信者サンプル3"
    },
  - "status": "WAIT",
  - "delivery_time": "2021-01-11T12:34:56+09:00",
  - "updated_time": "2021-01-02T00:00:00+09:00",
  - "created_time": "2021-01-01T00:00:00+09:00",
  - "reservation_time": "2021-01-11T12:34:00+09:00",
  - "delivery_type": "BULK",
  - "subject": "件名サンプル Vol.3"
  },
- {
  - "delivery_id": 4,
  - "from":
    {
    "email": "sample_4@example.com",
    "name": "送信者サンプル4"
    },
  - "status": "WAIT",
  - "delivery_time": "2021-01-11T12:34:56+09:00",
  - "updated_time": "2021-01-02T00:00:00+09:00",
  - "created_time": "2021-01-01T00:00:00+09:00",
  - "reservation_time": "2021-01-11T12:34:00+09:00",
  - "delivery_type": "BULK",
  - "subject": "件名サンプル Vol.4"
  }
]

}

配信登録(トランザクション)

配信種別を TRANSACTION として配信IDを新規発行し、配信を実施します。

※発行されたIDは照会、変更および削除の操作を行う際に必要になります。

※配信の保管期限があります。ご注意ください。

header Parameters

Authorization

required

string

認証トークン

Request Body schema:
application/json

from required	object 送信元情報
to required	string [ 6 .. 254 ] characters 宛先
cc	Array of strings <= 10 items CC
bcc	Array of strings <= 10 items BCC
insert_code	Array of objects <= 50 items 差し込みコード
subject required	string [ 1 .. 150 ] characters 件名
encode	string Default: `UTF-8` 送信メール文字コード
text_part required	string <= 30 kb テキストパート
html_part	string <= 70 kb HTMLパート

Responses

201

登録した配信IDを返却します

post /deliveries/transaction

Production server

https://app.engn.jp/api/v1/deliveries/transaction

Request samples

Payload

Content type

Copy

Expand all Collapse all

{

"from":
{
- "email": "sample@example.com",
- "name": "送信者サンプル"
},
"to": "sample_1@example.jp",
"cc":
[
- "sample_2@example.jp"
],
"bcc":
[
- "sample_3@example.jp"
],
"insert_code":
[
- {
  - "key": "__code1__",
  - "value": "差し込みコードサンプル1"
  },
- {
  - "key": "__code2__",
  - "value": "差し込みコードサンプル2"
  }
],
"subject": "テスト件名",
"encode": "ISO-2022-JP",
"text_part": "テスト配信",
"html_part": "<!DOCTYPE html><html><header></header><body>sample html</body></html>"

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信登録: 開始(一斉配信)

配信種別を BULK 、配信ステータスを EDIT として配信IDを新規発行します。

※発行されたIDは照会、変更および削除の操作を行う際に必要になります。

※配信の保管期限があります。ご注意ください。

header Parameters

Authorization

required

string

認証トークン

Request Body schema:
application/json

from required	object 送信元情報
encode	string Default: `UTF-8` 送信メール文字コード
subject required	string [ 1 .. 150 ] characters 件名
text_part required	string <= 30 kb テキストパート
html_part	string <= 70 kb HTMLパート

Responses

201

登録した配信IDを返却します

post /deliveries/bulk/begin

Production server

https://app.engn.jp/api/v1/deliveries/bulk/begin

Request samples

Payload

Content type

Copy

Expand all Collapse all

{

"from":
{
- "email": "sample@example.com",
- "name": "送信者サンプル"
},
"encode": "ISO-2022-JP",
"subject": "テスト件名",
"text_part": "テスト配信",
"html_part": "<!DOCTYPE html><html><header></header><body>sample html</body></html>"

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信登録: 更新(一斉配信)

指定した配信IDの配信ステータスが EDIT の場合に情報を更新します。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Request Body schema: application/json

from	object 送信元情報
to	Array of objects 宛先 (上限50件。すでに宛先が登録済みの場合、消去後に登録されます。)
subject	string [ 1 .. 150 ] characters 件名
text_part	string <= 30 kb テキストパート
html_part	string <= 70 kb HTMLパート

Responses

200

更新した配信IDを返却します

put /deliveries/bulk/update/{delivery_id}

Production server

https://app.engn.jp/api/v1/deliveries/bulk/update/{delivery_id}

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all

{

"from":
{
- "email": "sample@example.com",
- "name": "送信者サンプル"
},
"to":
[
- {
  - "email": "sample_1@example.jp",
  - "insert_code":
    [
    {
    "key": "__code1__",
    "value": "差し込みコードサンプル1"
    },
    {
    "key": "__code2__",
    "value": "差し込みコードサンプル2"
    }
    ]
  },
- {
  - "email": "sample_2@example.jp",
  - "insert_code":
    [
    {
    "key": "__code1__",
    "value": "差し込みコードサンプル1"
    }
    ]
  }
],
"subject": "テスト件名",
"text_part": "テスト配信",
"html_part": "<!DOCTYPE html><html><header></header><body>sample html</body></html>"

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信登録: 完了(一斉配信: 予約)

指定した配信を 配信予約日時 に一斉配信します。
指定した配信IDの配信ステータスを RESERVE に更新します。
配信先アドレスが1件以上設定されている必要があります。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Request Body schema: application/json

reservation_time

required

string yyyy-MM-ddTHH:mm:ss+09:00

配信予約日時
ISO 8601拡張形式のdate-time値

Responses

200

配信登録が完了した配信IDを返却します

patch /deliveries/bulk/commit/{delivery_id}

Production server

https://app.engn.jp/api/v1/deliveries/bulk/commit/{delivery_id}

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all

{

"reservation_time": "2021-01-11T12:34:00+09:00"

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信登録: 完了(一斉配信: 即時)

指定した配信を 即時 一斉配信します。
配信先アドレスが1件以上設定されている必要があります。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Responses

200

配信登録が完了した配信IDを返却します

patch /deliveries/bulk/commit/{delivery_id}/immediate

Production server

https://app.engn.jp/api/v1/deliveries/bulk/commit/{delivery_id}/immediate

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信詳細

※配信の保管期限があります。ご注意ください。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Responses

200

指定の配信情報を返却します

get /deliveries/{delivery_id}

Production server

https://app.engn.jp/api/v1/deliveries/{delivery_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1,
"from":
{
- "email": "sample@example.com",
- "name": "送信者サンプル"
},
"status": "RESERVE",
"delivery_time": "2021-01-11T12:34:56+09:00",
"updated_time": "2021-01-02T00:00:00+09:00",
"created_time": "2021-01-01T00:00:00+09:00",
"reservation_time": "2021-01-11T12:34:00+09:00",
"text_part": "テキストサンプル",
"html_part": "<!DOCTYPE html><html><header></header><body>sample html</body></html>",
"delivery_type": "BULK",
"subject": "件名サンプル Vol.5",
"attaches":
[
- {
  - "delivery_attach_id": 1,
  - "file_name": "sample.txt",
  - "mime": "application/text",
  - "size": 100,
  - "created_time": "2021-01-01T00:00:00+09:00",
  - "updated_time": "2021-01-01T00:00:00+09:00"
  },
- {
  - "delivery_attach_id": 2,
  - "file_name": "sample.pdf",
  - "mime": "application/pdf",
  - "size": 100,
  - "created_time": "2021-01-01T00:00:00+09:00",
  - "updated_time": "2021-01-01T00:00:00+09:00"
  }
],
"open_count": 220,
"total_count": 2100,
"sent_count": 1950,
"drop_count": 50,
"soft_error_count": 50,
"hard_error_count": 50

}

配信削除

指定した配信IDの配信ステータスが SENDING, WAIT, IMPORTING に該当しない場合に、配信IDを削除します。
※配信の保管期限があります。ご注意ください。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Responses

200

削除した配信IDを返却します

delete /deliveries/{delivery_id}

Production server

https://app.engn.jp/api/v1/deliveries/{delivery_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信キャンセル

指定した配信IDの配信ステータスを EDIT に更新します。
配信IDの配信ステータスが EDIT, RESERVE, WAIT のいずれかで、配信種別が BULK である必要があります。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Responses

200

キャンセルした配信IDを返却します

patch /deliveries/{delivery_id}/cancel

Production server

https://app.engn.jp/api/v1/deliveries/{delivery_id}/cancel

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"delivery_id": 1

}

配信先アドレス登録

指定した配信IDの配信種別が BULK、配信ステータスが EDIT の場合に配信先アドレスを新規に登録します。

※発行されたIDは照会、変更および削除の操作を行う際に必要になります。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Request Body schema: application/json

email required	string [ 6 .. 254 ] characters 配信先アドレス
insert_code	Array of objects <= 50 items Nullable 差し込みコード

Responses

201

登録したEメールIDを返却します

post /deliveries/{delivery_id}/emails

Production server

https://app.engn.jp/api/v1/deliveries/{delivery_id}/emails

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all

{

"email": "sample_1@example.jp",
"insert_code":
[
- {
  - "key": "__code1__",
  - "value": "差し込みコードサンプル1"
  },
- {
  - "key": "__code2__",
  - "value": "差し込みコードサンプル2"
  }
]

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"email_id": 1

}

配信先アドレス詳細

※配信の保管期限があります。ご注意ください。

path Parameters

email_id

required

integer <int64>

Example: 1

EメールID

header Parameters

Authorization

required

string

認証トークン

Responses

200

指定の配信先アドレス情報を返却します

get /deliveries/-/emails/{email_id}

Production server

https://app.engn.jp/api/v1/deliveries/-/emails/{email_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"email_id": 1,
"email": "sample_1@example.jp",
"delivery_id": 161,
"insert_code":
[
- {
  - "key": "__code1__",
  - "value": "差し込みコードサンプル1"
  },
- {
  - "key": "__code2__",
  - "value": "差し込みコードサンプル2"
  }
],
"created_time": "2021-01-01T00:00:00+09:00",
"updated_time": "2021-01-01T00:00:00+09:00"

}

配信先アドレス更新

指定したEメールIDを設定している配信IDの配信種別が BULK、配信ステータスが EDIT の場合に情報を更新します。

path Parameters

email_id

required

integer <int64>

Example: 1

EメールID

header Parameters

Authorization

required

string

認証トークン

Request Body schema: application/json

email	string [ 6 .. 254 ] characters 配信先アドレス
insert_code	Array of objects <= 50 items 差し込みコード

Responses

200

更新したEメールIDを返却します

put /deliveries/-/emails/{email_id}

Production server

https://app.engn.jp/api/v1/deliveries/-/emails/{email_id}

Request samples

Payload

Content type

application/json

Copy

Expand all Collapse all

{

"email": "sample_1@example.jp",
"insert_code":
[
- {
  - "key": "__code1__",
  - "value": "差し込みコードサンプル1"
  },
- {
  - "key": "__code2__",
  - "value": "差し込みコードサンプル2"
  }
]

}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"email_id": 1

}

配信先アドレス削除

指定したEメールIDを設定している配信IDの配信種別が BULK、配信ステータスが EDIT の場合に情報を削除します。

path Parameters

email_id

required

integer <int64>

Example: 1

EメールID

header Parameters

Authorization

required

string

認証トークン

Responses

200

削除したEメールIDを返却します

delete /deliveries/-/emails/{email_id}

Production server

https://app.engn.jp/api/v1/deliveries/-/emails/{email_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"email_id": 1

}

配信先アドレス一括登録ジョブの開始

指定した配信IDの配信種別が BULK、配信ステータスが EDIT の場合に配信先アドレスを新規に登録します。

path Parameters

delivery_id

required

integer <int64>

Example: 1

配信ID

header Parameters

Authorization

required

string

認証トークン

Request Body schema: multipart/form-data

file required	string <binary> <= 256MB text/csv 形式 / csvサンプルファイル(Download) ※一括登録用ファイルは以下の内容でアップロードをしてください。使用可能なファイル: `.csv` のみヘッダー1項目め: `email`(サンプルファイル参照) 文字コード: `UTF-8` BOMなし差し込みコードの設定上限は50件
data	object json形式 Content-Typeにapplication/jsonを指定してください。

Responses

200

登録した配信先アドレス一括登録ジョブのジョブIDを返却します

post /deliveries/{delivery_id}/emails/import

Production server

https://app.engn.jp/api/v1/deliveries/{delivery_id}/emails/import

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"job_id": 1

}

配信先アドレス一括登録ジョブの取得

path Parameters

job_id

required

integer <int64>

Example: 1

ジョブID

header Parameters

Authorization

required

string

認証トークン

Responses

200

配信先アドレス一括登録状況を返却します

get /deliveries/-/emails/import/{job_id}

Production server

https://app.engn.jp/api/v1/deliveries/-/emails/import/{job_id}

Response samples

Content type

application/json

Copy

Expand all Collapse all

{

"percentage": 100,
"status": "FINISHED",
"success_count": 100,
"failed_count": 120,
"total_count": 220,
"error_file_url": "https://app.engn.jp/api/v1/deliveries/-/xxx/xxx"

}

配信先アドレス一括登録エラーCSVダウンロード

ジョブ実行により形式チェックなどで失敗した配信先アドレス情報を取得します。

path Parameters

job_id

required

integer <int64>

Example: 1

ジョブID

blastengine API (1.3.2)

blastengine API の利用に関して

認証について

概要

リクエストヘッダ

レスポンスヘッダ

API BearerToken

利用例

Rate Limit

配信登録上限

HTTPステータスコード

各種ステータス・種別一覧

添付ファイルのサイズ制限と種類

差し込みコードについて

差し込みコードのご利用方法

配信の保管期限について

配信が開始されてから62日経過後に、配信情報とそれに関わる配信先アドレス、配信ログ情報は全て削除されます。

エラー停止について

1つの宛先に対し2週間以内に2度以上のハードエラーが発生すると、宛先はエラー停止対象となります。期間は最大で2週間となります。

deliveries

配信一覧

query Parameters

header Parameters

Responses

Response samples

配信登録(トランザクション)

※発行されたIDは照会、変更および削除の操作を行う際に必要になります。

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

配信登録: 開始(一斉配信)

※発行されたIDは照会、変更および削除の操作を行う際に必要になります。

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

配信登録: 更新(一斉配信)

path Parameters

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

配信登録: 完了(一斉配信: 予約)

path Parameters

header Parameters

Request Body schema: application/json

Responses

Request samples

Response samples

配信登録: 完了(一斉配信: 即時)

path Parameters

header Parameters

Responses

Response samples

配信詳細

path Parameters

header Parameters

Responses

Response samples

配信削除

path Parameters

header Parameters

Responses

Response samples

配信キャンセル

path Parameters

header Parameters

Responses

Response samples

配信先アドレス登録

※発行されたIDは照会、変更および削除の操作を行う際に必要になります。

path Parameters

header Parameters

Request Body schema: application/json

Responses

Request samples

配信が開始されてから`62`日経過後に、配信情報とそれに関わる配信先アドレス、配信ログ情報は`全て削除`されます。

Request Body schema:
application/json

Request Body schema:
application/json