IPCola

query rotation proxy distribution

POST

https://api.ipcola.com/api/node/flat_distribution/rotation

distribution

Request

Header Params

Authorization

string

optional

Default:

Bearer {{AUTH_TOKEN}}

Body Params application/json

stable_type

string

required

"short_session","middle_session", or "long_session"
short_session <=30min
middle_session 1-2hours
long_session 12-24hours

is_datacenter

boolean

required

true => datacenter, false => residential

next_level

string

required

distribution level, one of these value, "country","region","city","isp"

country_code

string

optional

if next level is region, city or isp, country_code is needed

region

string

optional

if next level is city, region is needed

node_count_filter

integer

required

default is 1, max is 100, only show location >= filter_value

Example

{
  "stable_type": "short_session",
  "next_level": "country",
  "is_datacenter": true,
  "Region": "",
  "country_code": "",
  "node_count_filter": 10
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.ipcola.com/api/node/flat_distribution/rotation' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "stable_type": "short_session",
    "next_level": "country",
    "is_datacenter": true,
    "Region": "",
    "country_code": "",
    "node_count_filter":10
}'

Responses

🟢200result

application/json

Body

meta_message

string

required

success or other error msg

meta_status

integer

required

1 for success, negative for error

distribution_map

object

required

map[location]

Additional properties

integer

optional

Example

{
  "meta_message": "string",
  "meta_status": 0,
  "distribution_map": {
    "property1": 0,
    "property2": 0
  }
}

Modified at 2023-08-11 10:41:41

query traffic package

query daily traffic data