Blocks はアカウントが存在しないなどの理由により送信エラーが発生したため、配信停止状態にあるメールアドレスを検索・参照する、ダウンロードする、配信停止状態を解除する等の操作を提供します。

このAPIは管理コンソールが提供します。接続先ホストについては共通仕様を参照ください。

list

Blocks/list は、配信停止状態にあるメールアドレスを検索・参照する操作を提供します。

リクエスト

/transaction/v2/blocks/list.[json|xml]

アクセス制御

パラメータ

レスポンス

JSON

{
"blocks": [
    {
    "created": "2015-12-14 08:46:00",
    "email": "to1@example.com",
    "id": "cp0ihzuyl3445",
    "occurred": "1",
    "status": "2"
    },
    {
    "created": "2015-12-14 12:19:00",
    "email": "to2@example.com",
    "id": "cp0ihzuyl3479",
    "occurred": "1",
    "status": "2"
    }
    ...
]
}

XML

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<blocks>
<block>
    <id>cp0ihzuyl3445</id>
    <email>to1@example.com</email>
    <status>2</status>
    <occurred>1</occurred>
    <created>2015-12-14 08:46:00</created>
</block>
<block>
    <id>cp0ihzuyl3479</id>
    <email>to2@example.com</email>
    <status>2</status>
    <occurred>1</occurred>
    <created>2015-12-14 12:19:00</created>
</block>
</blocks>

エラーメッセージ

リクエスト例

curl -X POST -d 'api_user=testuser' -d 'api_key=password' -d 'server_composition=testcomp' https://api.smtps.jp/transaction/v2/blocks/list.json

download

Blocks/download は、配信停止状態にあるメールアドレスを検索し、CSVファイル形式でダウンロードする操作を提供します。

リクエスト

/transaction/v2/blocks/download.[json|xml]

アクセス制御

パラメータ

レスポンス

リクエストが成功した場合、Content-Type に application/octet-stream を指定し、以下フォーマットのCSVファイルをZIP圧縮してダウンロードします。データ暗号化を設定している場合、パスワード付き暗号化ZIPファイルをダウンロードします。

ファイル名

blocks-yyyyMMdd_HHmmss.zip　(例: blocks-20151207_175202.zip)

ファイルフォーマット

"created","id","email","status","occurred"
"2015-12-14 08:46:00","cp0ihzuyl3445","from1@example.com","2","1"
"2015-12-14 12:19:00","cp0ihzuyl3479","from2@example.com","2","1"

エラーメッセージ

リクエスト例

curl -X POST -d 'api_user=testuser' -d 'api_key=password' -d 'server_composition=testcomp' https://api.smtps.jp/transaction/v2/blocks/download.json > data.zip

delete

Blocks/delete は、配信停止状態にあるメールアドレスを恒久的に送信可能にする操作を提供します。

本操作を行ったメールアドレスはメール送信を許可されます。配信エラーが再発した場合でも、配信停止の対象とならないよう制御されます。

配信エラーの誤判定があった場合や、運用上必ずメール送信を試行する必要があるメールアドレスなど、 メールアドレスを恒久的に送信可能な状態としたい場合、本APIにて該当するメールアドレスを操作してください。

リクエスト

/transaction/v2/blocks/delete.[json|xml]

アクセス制御

パラメータ

レスポンス

処理が成功した場合、以下の応答メッセージになります。

JSON

{
    "message" : "success"
}

XML

<success>
    <message>success</message>
</success>

エラーメッセージ

リクエスト例

curl -X POST -d 'api_user=testuser' -d 'api_key=password' -d 'server_composition=testcomp' -d 'email=test@example.com' https://api.smtps.jp/transaction/v2/blocks/delete.json

cancel

Blocks/cancel は、配信停止状態にあるメールアドレスを取り消しする操作を提供します。

本操作を行ったメールアドレスはメール送信を許可されますが、配信エラーが再発し配信停止条件と合致した場合は、再び配信停止とするよう制御されます。

メール受信者側の迷惑メールフィルタの設定など復旧可能な理由により、配信停止となったメールアドレスを取り消したい場合、本APIにて該当するメールアドレスを操作してください。

リクエスト

/transaction/v2/blocks/cancel.[json|xml]

アクセス制御

パラメータ

レスポンス

処理が成功した場合、以下の応答メッセージになります。

JSON

{
    "message" : "success"
}

XML

<success>
    <message>success</message>
</success>

エラーメッセージ

リクエスト例

curl -X POST -d 'api_user=testuser' -d 'api_key=password' -d 'server_composition=testcomp' -d 'email=test@example.com' https://api.smtps.jp/transaction/v2/blocks/cancel.json