创建按流量使用的动态代理订单。基础地址:https://api.wanyuagent.com/api
动态订单
动态代理订单用于购买按流量使用的动态代理资源。
创建动态订单
curl -X POST "https://api.wanyuagent.com/api/open/app/order/create/v2" \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"orderType": "dynamic_proxy",
"poolId": "<dynamic_product_no>",
"trafficAmount": 3,
"unitPrice": 0,
"totalAmount": 0,
"remark": "API dynamic order",
"userId": 1001,
"ipCount": 1,
"duration": 30,
"unit": 1
}'字段说明
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
orderType | string | 是 | 动态代理使用 dynamic_proxy。 |
poolId | string | 是 | 动态代理产品编号。 |
trafficAmount | number | 是 | 购买流量,单位为 GB,必须大于 0。 |
userId | number | 是 | 目标用户 ID。 |
unitPrice | number | 是 | 兼容字段,请传 0;服务端按目标用户、代理层级和流量阶梯计算实际单价。 |
totalAmount | number | 是 | 兼容字段,请传 0;服务端根据实际单价重新计算,客户端金额不会作为扣款依据。 |
remark | string | 否 | 订单备注。 |
动态订单与网页开通使用同一条处理链路。接口会先在服务端完成价格解析和用户、代理商余额预检,再执行资源开通;成功后在同一订单号下记录用户、代理商(如有)和平台成本流水。任一必要步骤失败时,订单不会以“部分扣款”状态提交。
流量查询
查询用户所有产品的动态流量:
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>"更完整的动态代理提取、流量明细和子账户流量查询见 动态流量与提取。
查询动态订单列表
curl -X GET "https://api.wanyuagent.com/api/dynamic?page=1&page_size=10&pool_type=<dynamic_product_no>" \
-H "Authorization: Bearer <token>"查询参数:
| 参数 | 说明 |
|---|---|
page | 页码,默认 1。 |
page_size | 每页数量,最大 100。 |
user_id | 指定用户 ID。代理商只能查询自己和下级用户。 |
order_no | 按订单号或应用订单号搜索。 |
pool_type | 动态产品编号筛选。 |
查询动态订单详情
按订单 ID 查询:
curl -X GET "https://api.wanyuagent.com/api/dynamic/123" \
-H "Authorization: Bearer <token>"按订单号或应用订单号查询:
curl -X GET "https://api.wanyuagent.com/api/dynamic/order-info/DYN202605260001abc123" \
-H "Authorization: Bearer <token>"动态子账户管理见 动态子账户。