IPリストの作成
終点:
POSThttps://proxy-seller.com/personal/api/v1/{YourApiKey}/residentsubuser/list/add
パスのパラメータ:
名称 | 価値 | 説明 |
|---|---|---|
認可 |
| 個人APIキー |
リクエスト本文:
名称 | タイプ | 説明 |
|---|---|---|
タイトル | ストリング | 作成するリストの名前 |
ホワイトリスト | ストリング | 認証用IP。ログイン認証情報を使用して認証する場合は、空白のままにします。 |
ジオ | オブジェクト | リストにGEOデータを追加する(国、地域、都市、ISP) |
カントリー | ストリング | GEOデータベースから選択した国 |
地域 | ストリング | GEOデータベースから選択した地域 |
都市 | ストリング | GEOデータベースから選択された都市 |
アイソピー | ストリング | GEOデータベースから選ばれたISP |
輸出 | オブジェクト | ここでは、リスト内のIP数とエクスポートの種類(ポート番号とファイル形式)を指定します。 |
ポート | 番号 | IP数(最大1000) |
エクステンド | ストリング | 輸出の種類 |
ローテーション | 番号 | 「'-1'でローテーションなし(スティッキー)、'0'でリクエストごとのローテーション、'1'から'3600'で秒単位の時間ベースのローテーション |
パッケージ・キー | ストリング | IPのリストを追加したいサブユーザのパッケージのキー。 |
例
https://proxy-seller.com/personal/api/v1/fj4948ffhg58gh843gh/residentsubuser/list/add反応だ:
{
"status": "success",
"data": {
"id": 561,
"title": "US Washington Garfield FIRST-STEP",
"login": "3c8aa1d4",
"password": "AZT62Dx3",
"whitelist": "127.0.0.1,192.168.0.1",
"rotation": "-1 = rotation, 0 = rotation per request, 1..60 time in seconds",
"geo": {
"country": "US",
"region": "Washington",
"city": "Garfield",
"isp": "FIRST-STEP"
},
"export": {
"ports": 10000,
"ext": "txt"
}
},
"errors": []
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Error api key",
"code": 503,
"customData": null
},
{
"message": "IP not allowed",
"code": 503,
"customData": null
},
{
"message": "Request limit reached",
"code": 503,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP not allowed",
"code": 503,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "Tarif not found",
"code": 0,
"customData": null
}
]
}ボディリクエストにエラーがある応答:
{
"status": "error",
"data": null,
"errors": [
{
"message": "Incorrect IP address 0.0.0.0 entered",
"code": 409,
"customData": null
},
{
"message": "Incorrect IP address 0.0.0.0 entered",
"code": 0,
"customData": null
}
]
}{
"status": "error",
"data": null,
"errors": [
{
"message": "IP 127.0.0.1 already linked",
"code": 0,
"customData": null
},
{
"message": "IP 127.0.0.1 already linked",
"code": "0",
"customData": null
}
]
}Same error may be in case with wrong "region", "city", "isp"!
{
"status": "error",
"data": null,
"errors": [
{
"message": "Invalid country (region, city, isp) ISO code",
"code": 400,
"customData": null
},
{
"message": "Invalid country ISO code (400)",
"code": 0,
"customData": null
}
]
}