リクエストの一覧を取得 | ドキュメント | IP Geolocation Bulk API | WhoisXML API

リクエスト一覧の取得

POST https://ip-geolocation.whoisxmlapi.com/api/bgservice/request/list

CURLリクエストのサンプル

curl https://ip-geolocation.whoisxmlapi.com/api/bgservice/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,
                "date_start": "1528377253",
                "total_terms": 3,
                "invalid_terms": 0,
                "processed_terms": 3,
                "failed_terms": 0,
                "ready": 1
            },
            {
                "id": 595,
                "date_start": "1528377227",
                "total_terms": 20,
                "invalid_terms": 0,
                "processed_terms": 20,
                "failed_terms": 0,
                "ready": 1
            },
            {
                "id": 544,
                "date_start": "1528204702",
                "total_terms": 500,
                "invalid_terms": 0,
                "processed_terms": 500,
                "failed_terms": 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].date_start

文字列。

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

data[k].total_terms

整数。

リクエストに含まれる用語(IPアドレス、メール、ドメイン名)の総数。

data[k].invalid_terms

整数。

無効な用語の数。

data[k].processed_terms

整数。

すでに処理された用語の数。

data[k].failed_terms

整数。

処理できなかった用語の数。

data[k].ready

整数。

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

from

整数。

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

to

整数。

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

per_page

整数。

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

total

整数。

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

current_page

整数。

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

last_page

整数。

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

error

文字列。

エラーの説明。

errors

配列。

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