Authenticate, find products, create a ZTProxy order and retrieve proxy details.

API base URL

https://backend.ztproxy.net/api

Use this global endpoint and include a valid access token for authenticated requests.

English API Quickstart

Use the global ZTProxy API origin:

https://backend.ztproxy.net/api

1. Authenticate

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

Store data.token securely and send it as Authorization: Bearer <token>. Never put a token, site password or proxy credential in a client-side application, URL or support message.

2. Check the account

curl "https://backend.ztproxy.net/api/open/app/dashboard/info/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

Use this response to confirm the current balance and resource summary before creating an order.

3. Find a product and location

curl -X POST "https://backend.ztproxy.net/api/open/app/product/query-standard/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"proxyType":103,"language":"en"}'

Use the returned productId, countryCode and cityCode. Do not construct or guess internal product identifiers.

4. Create a static order

curl -X POST "https://backend.ztproxy.net/api/open/app/static/order/create-standard/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType":"static_proxy",
    "poolId":"<productId>",
    "userId":1001,
    "countryCode":"US",
    "cityCode":"<cityCode>",
    "staticType":"isp",
    "ipCount":1,
    "cycleTimes":1,
    "duration":30,
    "unit":1,
    "unitPrice":0,
    "totalAmount":0,
    "remark":"API order"
  }'

An accepted request may return queued: true. Poll the order list for the final order state and assigned proxy details; acceptance is not proof of fulfilment.

5. Read static orders

curl "https://backend.ztproxy.net/api/open/app/static/order/list/v2?page=1&pageSize=10" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

6. Create a rotating-proxy order

curl -X POST "https://backend.ztproxy.net/api/open/app/order/create/v2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "orderType":"dynamic_proxy",
    "poolId":"<productId>",
    "trafficAmount":3,
    "userId":1001,
    "unitPrice":0,
    "totalAmount":0,
    "ipCount":1,
    "duration":30,
    "unit":1,
    "remark":"API rotating order"
  }'

trafficAmount is measured in GB. The server applies the same role-aware price used by the web application; unitPrice and totalAmount are compatibility fields and must not be treated as a client-selected price.

Response and retry rules

  • Check both the HTTP status and the response code.
  • Treat validation, authentication, permission and insufficient-balance errors as non-retryable until the request or account is corrected.
  • Retry timeouts and temporary 5xx responses with exponential backoff and an idempotency key where the endpoint supports one.
  • Do not assume an order succeeded until its final status and delivered resources are visible.

For endpoint fields and related operations, continue to the English Core API Reference.

Selection guides

Before you order, these marketing guides may help (full Chinese versions are live; English pages are full for rotating vs static, placeholders for the others):