动态代理提取、剩余流量和流量查询接口。基础地址：https://backend.ztproxy.net/api

API 基础地址

https://backend.ztproxy.net/api

全球用户统一使用此地址。需要认证的接口必须携带有效的访问令牌。

动态流量与提取

当前公开接入仅说明动态资源2（公开产品号 dynamic_2）。购买成功后保存响应中的 accountId，再通过账户级接口完成地区查询、代理提取和流量查询。完整流程见动态资源2接入指南。

提取动态代理

curl -X POST "https://backend.ztproxy.net/api/business/dynamic-accounts/123/extract" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "protocol": "socks5",
    "country": "US",
    "state": "California",
    "city": "Los Angeles",
    "quantity": 10,
    "sessionId": "task01",
    "sessionMinutes": 10
  }'

123 替换为购买动态资源2后返回的 accountId。普通用户只能访问自己的账户；代理商只能访问自己有权管理的账户。

字段说明：

字段	类型	必填	说明
`protocol`	string	否	默认 `socks5`。SOCKS5 访问 HTTPS 目标不代表 HTTP 代理或 HTTPS CONNECT 已可用。
`country`	string	否	标准国家代码；不传表示全球随机。
`state`	string	否	当前国家地区表中的州/省名称。
`city`	string	否	当前国家和州/省下的城市名称。
`quantity`	integer	否	提取数量，范围 `1`–`200`，默认 `1`。批量提取时每条凭据使用独立会话。
`sessionId`	string	否	粘性会话标识，最多 6 位字母或数字。
`sessionMinutes`	integer	否	粘性会话时长，范围 `1`–`60` 分钟。

成功响应同时提供结构化的 host、port、username、password 和兼容的 data.proxy.list。批量提取结果以 data.proxy.list 为准；结构化字段和 formatted_proxy 表示第一条代理。客户端不应自行拼接代理用户名。

{
  "code": 0,
  "msg": "success",
  "data": {
    "productNo": "dynamic_2",
    "protocol": "socks5",
    "host": "<proxy-host>",
    "port": 10000,
    "username": "<proxy-username>",
    "password": "<proxy-password>",
    "quantity": 2,
    "proxy": {"list": [
      "<host>:<port>:<username-1>:<password>",
      "<host>:<port>:<username-2>:<password>"
    ]}
  }
}

安全提示：请只在服务端保存和使用登录 Token，不要把 Token 或返回的代理凭据写入前端代码、公开仓库或日志。

查询动态资源2账户和剩余流量

curl -X GET "https://backend.ztproxy.net/api/business/dynamic-accounts/123" \
  -H "Authorization: Bearer <token>"

响应中的 limitBytes、usedBytes 和 todayUsedBytes 均以字节为单位；剩余流量可由 limitBytes - usedBytes 计算。

查询动态资源2用量

curl -X GET "https://backend.ztproxy.net/api/business/dynamic-accounts/123/usage?granularity=day&page=1&pageSize=100" \
  -H "Authorization: Bearer <token>"

granularity 支持 day、hour 和 detail。日期范围和分页参数见动态资源2接入指南。