Skip to main content

​
动态流量与提取

本页说明动态代理提取、剩余流量查询和动态代理流量明细接口。

​
提取动态代理

curl -X POST "https://backend.ztproxy.net/api/business/dynamic-proxy/extract" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "productNo": "<dynamic_product_no>",
    "proxyType": 104,
    "username": "target_user",
    "extractConfig": {
      "method": "api"
    }
  }'
字段说明：
字段类型必填说明
productNostring是动态代理产品编号。
proxyTypenumber是动态代理通常为 104。
usernamestring否指定目标用户；不传则使用当前登录用户。
extractConfig.methodstring否提取方式，默认 api。

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

curl -X GET "https://backend.ztproxy.net/api/user/1001/products-flow" \
  -H "Authorization: Bearer <token>"
权限规则：
  • 代理商可查询自己和下级用户。
  • 普通用户只能查询自己。

​
查询指定产品剩余流量

curl -X GET "https://backend.ztproxy.net/api/user/1001/remaining-flow/<dynamic_product_no>" \
  -H "Authorization: Bearer <token>"
product_no 使用动态代理产品编号。

​
查询动态子账户流量信息

curl -X GET "https://backend.ztproxy.net/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://backend.ztproxy.net/api/agent/getFlowConsumeDetail?startDate=2026-05-01&endDate=2026-05-26" \
  -H "Authorization: Bearer <token>"
日期格式为 YYYY-MM-DD，开始日期不能大于结束日期。

​
查询账户总流量

curl -X GET "https://backend.ztproxy.net/api/agent/getFlowTotalFull" \
  -H "Authorization: Bearer <token>"
该接口查询账户多类型流量总计。

​
修改动态子账号密码

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