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

动态流量与提取

本页说明动态代理提取、剩余流量查询和动态代理流量明细接口。用户购买动态流量并开通动态账号后，可以直接调用 API 提取动态代理，无需先在网页中手动提取。

提取动态代理

curl -X POST "https://api.wanyuagent.com/api/business/dynamic-proxy/extract" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "productNo": "<dynamic_product_no>",
    "proxyType": 104,
    "flow": 1,
    "extractConfig": {
      "method": "api",
      "protocol": "socks5",
      "dataFormat": "txt",
      "delimiter": 1,
      "ipwebCountry": "US"
    }
  }'

普通用户不需要传 username，接口会提取当前 Token 所属账号的动态代理。代理商为直属下级用户提取时才传该下级用户的 username；管理员可指定任意站内用户。接口不会允许普通用户或代理商跨账号提取。

字段说明：

字段	类型	必填	说明
`productNo`	string	是	动态代理产品编号。
`proxyType`	number	是	动态代理通常为 `104`。
`flow`	number	API 提取时是	本次 API 提取的流量参数，单位 GB，必须大于 `0`。
`username`	string	否	指定目标用户；不传则使用当前登录用户。
`subIpwebUsername`	string	否	使用动态子账户提取时传子账户用户名；子账户必须属于目标用户且处于启用状态。
`extractConfig.method`	string	否	`api` 表示 API 提取，`password` 表示账密提取；默认 `api`。
`extractConfig.protocol`	string	否	API 提取协议，支持 `socks5` 或 `http`，默认 `socks5`。
`extractConfig.dataFormat`	string	否	返回格式，支持 `txt` 或 `json`，默认 `txt`。
`extractConfig.delimiter`	number	否	文本结果分隔符编号，默认 `1`。
`extractConfig.ipwebCountry`	string	否	动态 IP 池 3 的国家代码；不传表示全球随机。

成功响应中的代理结果位于 data.proxy。动态 IP 池 3 会返回可直接使用的动态代理配置；实际流量仍按当前账号或所选子账户的动态流量额度统计。

{
  "code": 0,
  "msg": "success",
  "data": {
    "proxy": {
      "list": ["<proxy-config>"]
    },
    "whitelist": null
  }
}

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

查询用户所有产品剩余流量

curl -X GET "https://api.wanyuagent.com/api/user/1001/products-flow" \
  -H "Authorization: Bearer <token>"

权限规则：

代理商可查询自己和下级用户。
普通用户只能查询自己。

查询指定产品剩余流量

curl -X GET "https://api.wanyuagent.com/api/user/1001/remaining-flow/<dynamic_product_no>" \
  -H "Authorization: Bearer <token>"

product_no 使用动态代理产品编号。

查询动态子账户流量信息

curl -X GET "https://api.wanyuagent.com/api/agent/childAccount/user/sub001" \
  -H "Authorization: Bearer <token>"

响应会将流量换算为 GB，并返回：

字段	说明
`limit_flow`	总流量，单位 GB。
`download_flow`	下载流量，单位 GB。
`upload_flow`	上传流量，单位 GB。
`used_flow`	已用流量，单位 GB。
`remaining_flow`	剩余流量，单位 GB。
`usage_percentage`	使用百分比。

按日期查询流量消费明细

curl -X GET "https://api.wanyuagent.com/api/agent/getFlowConsumeDetail?startDate=2026-05-01&endDate=2026-05-26" \
  -H "Authorization: Bearer <token>"

日期格式为 YYYY-MM-DD，开始日期不能大于结束日期。

查询账户总流量

curl -X GET "https://api.wanyuagent.com/api/agent/getFlowTotalFull" \
  -H "Authorization: Bearer <token>"

该接口查询账户多类型流量总计。

修改动态子账号密码

子账号密码修改请使用动态子账户管理能力。对外路径请以 ZTProxy 支持团队提供的中性路径为准。