リクエスト一覧の取得 | ドキュメント | Email Verification Bulk API | WhoisXML API

リクエスト一覧の取得

POST https://emailverification.whoisxmlapi.com/api/bevService/request/list

CURLリクエストのサンプル

curl https://emailverification.whoisxmlapi.com/api/bevService/request/list -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "page": 1, "onlyIds": false, "perPage": 10, "sort": "desc", "format": "json"}'

POSTリクエスト本文のサンプル

{
    "apiKey": "YOUR_API_KEY",
    "page": 1,
    "format": "json",
    "onlyIds": false,
    "perPage": 10,
    "sort": "desc"
}

入力パラメータ

apiKey

必須My productsページで個人用APIキーを取得してください。

page

任意。整数。

「perPage」と組み合わせて、結果セットをページ分割するために使用。

初期値:1。

onlyIds

任意。ブール値。

trueの場合は、IDのリストのみが返されます。

初期値:true

perPage

任意。整数。

結果セットの各ページをこのリクエスト数に制限。

最小:10、最大:50

初期値:10

sort

任意。文字列。

応答内のリクエストの順序を指定します。

利用可能な値:「asc」、「desc」。

初期値:「desc」。

format

任意。文字列。

応答の形式を指定します。

利用可能な値:「xml」、「json」、「csv」。

初期値:「json」。

出力サンプル

{
    "response": {
        "current_page": 1,
        "data": [
            {
                "id": 596
            },
            {
                "id": 595
            },
            {
                "id": 544
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}

Code: 200 OK.
{
    "response": {
        "current_page": 1,
        "data": [
            {
                "id": 596,
                "api_version": 3,
                "date_start": "1528377253",
                "total_emails": 3,
                "invalid_emails": 0,
                "processed_emails": 3,
                "failed_emails": 0,
                "ready": 1
            },
            {
                "id": 595,
                "api_version": 3,
                "date_start": "1528377227",
                "total_emails": 20,
                "invalid_emails": 0,
                "processed_emails": 20,
                "failed_emails": 0,
                "ready": 1
            },
            {
                "id": 544,
                "api_version": 2,
                "date_start": "1528204702",
                "total_emails": 500,
                "invalid_emails": 0,
                "processed_emails": 500,
                "failed_emails": 0,
                "ready": 1
            }
        ],
        "from": 1,
        "last_page": 1,
        "per_page": 10,
        "to": 3,
        "total": 3
    }
}

Code: 200 OK.

入力パラメータ

response

応答オブジェクト。

成功時のユーザーのリクエストデータの配列を持つ「data」フィールドが含まれます。

from」と「to」フィールドは、現在のページに対して返されたリクエストの結果セットのID範囲を表します。

per_page」はページのサイズ、「total」は結果セットのリクエスト数です。

「current_page」と「last_page」は、結果セットのページ数に対応。

エラーの場合は、 「error」にその説明が含まれます。複数のエラーがある場合は、その説明が「errors」配列に返されます。

data

配列。

リクエストの情報要素のリスト('onlyIds'trueの場合、各要素は'id'フィールドのみを持ちます)。

data[k].id

文字列。

Request ID。

data[k].api_version

整数。

リクエストに使用されたAPIのバージョン。

data[k].date_start

文字列。

リクエストの開始Unixタイムスタンプの文字列表現。

data[k].total_emails

整数。

リクエストのメール数の合計。

data[k].invalid_emails

整数。

無効なメールの数。

data[k].processed_emails

整数。

すでに処理されたメールアドレスの数。

data[k].failed_emails

整数。

処理できなかったメールの数。

data[k].ready

整数。

処理が終了した場合は 1、それ以外の場合は 0。

from

整数。

データセットの現在のページにおける最小リクエストID。

to

整数。

データセットの現在のページの最大リクエストID数。

per_page

整数。

結果セットの各ページの最大リクエスト数。

total

整数。

結果セット内のリクエストの合計数。

current_page

整数。

結果セット内の現在のページ番号。

last_page

整数。

セット内の最後のページの番号。

error

文字列。

エラーの説明。

errors

配列。

複数のエラーメッセージ。