Buy dynamic IP proxy by area

POST

/open_api/v3/proxy/api/proxy/dynamic/ip/by_area

Purchase parameters may be sent in the JSON body and/or the query string (body wins on conflicts). Dynamic purchases accept session_mode (sticky default; rotating requires the standard line s=3/4 — s=1/2 with rotating returns 422) and session_duration (sticky minutes, whitelist 10/30/60/120, standard line only; the duration joins the idempotency fingerprint, so changing it needs a new idempotency_key). Subnational targeting: state_id/city_id ride the premium line only — s=1/2 with country_id(+state_id)(+city_id) provisions through the verified gateway bridge; s=3/4 with state_id/city_id is rejected. ISP targeting: the isp catalog key (see GET /proxy/isp/catalog) requires the premium line s=1/2 plus country_id and is rejected elsewhere.

请求参数

Authorization

Basic Auth

在 Header 添加参数

Authorization

，其值为在 Basic 之后拼接空格，以及经过 Base64 编码的 username:password

示例：

Authorization: Basic *****************

Body 参数application/json必填

示例

{
    "s": 4,
    "protocol": "http",
    "country_id": 46,
    "state_id": 0,
    "city_id": 0,
    "is_data_center": false,
    "session_mode": "sticky",
    "session_duration": 120
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/open_api/v3/proxy/api/proxy/dynamic/ip/by_area' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '{
    "s": 4,
    "protocol": "http",
    "country_id": 46,
    "state_id": 0,
    "city_id": 0,
    "is_data_center": false,
    "session_mode": "sticky",
    "session_duration": 120
}'

返回响应

🟢200

application/json

HTTP 200 always; judge by envelope code

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "token_id": 410515,
        "username": "u2hf7g6s",
        "password": "Vb1yC8kN",
        "host": "proxy.proxy302.com",
        "port": 2222,
        "protocol": "http",
        "pool_id": 0,
        "is_api": 1,
        "is_static": false,
        "direct_mysql": true
    }
}

修改于 2026-10-26 19:25:15

Buy dynamic traffic proxy

List owned proxy tokens