エラーフィルター

エラーフィルター登録情報更新

概要

指定されたメールアドレスのエラーカウントを設定・リセットする機能です。

注意事項

  • 一度のリクエストで指定可能なアドレスは最大100件までです。
  • エラーアドレスを一度に大量にリセットすると、エラー率が上がり、配信の遅延やブロックが発生する恐れがあります。

この機能を利用して、特定のメールアドレスへの配信を抑止することも可能です。その際は、設定値を「99」など、意図的に設定したとわかる値を設定することをおすすめします。

メソッドとURL

メソッド URL
PUT https://{HOST名}/errorfilter

リクエスト

ボディパラメーター

JSON形式で設定します。

項目 型 必須 説明
items Object Array ◯ 登録・更新対象のリスト。
address String ◯ エラーカウントを設定するアドレス。
メールアドレスがエラーフィルターに未登録の場合は、新規登録します。
count Number 設定する値。
「0~99」までの値が設定可能。
項目の省略が可能。省略時は「0」と判断します。

レスポンス

ステータスコード

コード   説明
200 OK リクエスト受付、正常終了。
400 Bad Request 構文不正。フォーマットやパラメーターの不正。
413 Request Entity Too Large 指定したアドレス件数が所定値を超えている。
500 Internal Server Error 想定外のエラー。 しばらく経ってから再度実施し、状況が改善しなければ、弊社までお問い合わせください。

上記以外のステータスコードが返却される場合もあります。その場合は、HTTPレスポンスステータスコード一覧をご確認ください。

HTTPレスポンスステータスコード一覧

ボディパラメーター

項目 型 説明
items Object Array レスポンスのリスト。配列で結果が格納される。
address String 登録されているメールアドレス。
count Number エラーカウント。
registered_date String 初回登録日時。
update_date String 最終更新日時。
count Number itemsに設定されたデータの件数。
message String 全体的な失敗時に設定される補足メッセージ。

リクエスト

リクエストサンプル

{
  "items":[
    {
      "address":"xxxxxxxx@xxxx.xx",
      "count":0
    },
    {....}
  ]
}

レスポンスサンプル

正常

{
  "items": [
    {
      "address": "xxxxxxxx@xxxx.xx",
      "count": 1
      "registered_date": "yyyy-mm-ddThh:mm+09:00",
      "update_date": "yyyy-mm-ddThh:mm+09:00"
    },
    {...}
  ],
  "count": 2
}

指定した回数に変更されます。

エラー

{
  "message": "Too Many Requests"
}

補足情報が返却されます。