登录、查询产品、创建 ZTProxy 订单并获取代理信息。基础地址：https://backend.ztproxy.net/api

快速开始

本页演示典型 API 调用流程：登录、检查余额、查询产品、创建订单、查询订单代理信息。

1. 登录

curl -X POST "https://backend.ztproxy.net/api/auth/login" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "your_username",
    "password": "your_password"
  }'

保存响应中的 data.token。

export ZTPROXY_TOKEN="<token>"
export ZTPROXY_BASE="https://backend.ztproxy.net/api"

2. 查询账户余额

curl -X GET "$ZTPROXY_BASE/open/app/dashboard/info/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

响应会返回当前账号的余额和资源统计。

3. 查询产品

curl -X POST "$ZTPROXY_BASE/open/app/product/query-standard/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "proxyType": 103
  }'

返回结果中的 productId 可作为创建订单时的 poolId。标准接口会返回统一的 countryCode 和 cityCode，例如 US、NEW_YORK。

如果需要查询 IP 段，可继续调用：

curl "$ZTPROXY_BASE/open/app/product/ip-ranges/v2?proxyType=103&productNo=<productId>" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

4. 创建静态代理订单

curl -X POST "$ZTPROXY_BASE/open/app/static/order/create-standard/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType": "static_proxy",
    "poolId": "ZT_US_New York City_2",
    "userId": 1001,
    "unitPrice": 10,
    "totalAmount": 10,
    "countryCode": "US",
    "cityCode": "NEW_YORK",
    "staticType": "isp",
    "ipCount": 1,
    "cycleTimes": 1,
    "duration": 30,
    "unit": 1,
    "remark": "API order"
  }'

响应会先返回已受理的订单信息，其中包括 orderNo / order_no 和 queued: true。静态代理实例、供应商订单号和最终状态通过静态订单列表查询。

5. 查询静态订单和代理实例

curl -X GET "$ZTPROXY_BASE/open/app/static/order/list/v2?page=1&pageSize=10" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

也可以按订单号、IP、用户名、密码或地区搜索：

curl -X GET "$ZTPROXY_BASE/open/app/static/order/list/v2?search=192.0.2.10&page=1&pageSize=10" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

6. 创建动态代理订单

curl -X POST "$ZTPROXY_BASE/open/app/order/create/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType": "dynamic_proxy",
    "poolId": "<dynamic_product_no>",
    "trafficAmount": 1,
    "userId": 1001,
    "unitPrice": 5,
    "totalAmount": 5,
    "ipCount": 1,
    "duration": 30,
    "unit": 1,
    "remark": "API dynamic order"
  }'

常用后续接口