接口参考

基础地址：

https://api.wanyuagent.com/api

需要认证的接口必须携带：

Authorization: Bearer <token>

认证

获取 JWT token。

请求

{
  "username": "your_username",
  "password": "your_password"
}

响应

{
  "code": 0,
  "message": "登录成功",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiIs...",
    "user": {
      "id": 1001,
      "username": "your_username",
      "is_agent": true,
      "balance": 1000,
      "status": "active"
    }
  }
}

用户

POST `/open/app/user/v2`

在当前管理员或代理商账号下创建用户。

请求

{
  "username": "sub_user_001",
  "password": "password123",
  "email": "user@example.com",
  "phone": "13812345678",
  "remark": "API sub-user",
  "is_agent": false,
  "balance": 0
}

字段	类型	必填	说明
`username`	string	是	3-50 个字符，必须唯一。
`password`	string	是	6-50 个字符。
`email`	string	否	邮箱。
`phone`	string	否	11 位手机号。
`is_agent`	boolean	否	是否创建代理商账号。
`balance`	number	否	初始余额。
`agent_id`	number	否	管理员可指定用户所属代理商。

GET `/open/app/user/balance/current`

查询当前登录用户余额。

curl "$ZTPROXY_BASE/open/app/user/balance/current" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

产品与地区

POST `/open/app/product/query/v2`

查询可用产品。

请求

{
  "proxyType": 103,
  "productNo": "ZT_US_New York City_2"
}

字段	类型	必填	说明
`proxyType`	number	否	代理类型筛选。常见值：`103` 静态，`104` 动态。
`productNo`	string	否	产品编号。
`areaCode`	string	否	地区筛选。

响应项通常包含 product_no、product_name、proxy_type、inventory、country_code、city_code、duration、unit、global_price、cidr_info 和 project_list 等字段。

GET `/open/app/product/area/v2`

查询产品服务地区。

curl "$ZTPROXY_BASE/open/app/product/area/v2?proxyType=103&productNo=ZT_US_New%20York%20City_2" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

参数	类型	必填	说明
`proxyType`	number	否	产品代理类型。
`productNo`	string	否	产品编号。

订单

POST `/open/app/order/create/v2`

创建订单。动态代理订单使用 orderType: "dynamic_proxy"。该接口也能创建基础静态订单，但静态订单通常建议使用 /open/app/static/order/create/v2。

动态代理请求

{
  "orderType": "dynamic_proxy",
  "poolId": "dynamic_ipweb",
  "trafficAmount": 1,
  "unitPrice": 5,
  "totalAmount": 5,
  "remark": "API dynamic order",
  "userId": 1001,
  "ipCount": 1,
  "duration": 30,
  "unit": 1
}

POST `/open/app/static/order/create/v2`

创建静态代理订单。

静态代理请求

{
  "orderType": "static_proxy",
  "poolId": "ZT_US_New York City_2",
  "trafficAmount": null,
  "unitPrice": 10,
  "totalAmount": 10,
  "remark": "API static order",
  "userId": 1001,
  "regionCode": "US",
  "countryCode": "US",
  "cityCode": "New York City",
  "staticType": "isp",
  "ipCount": 1,
  "cycleTimes": 1,
  "duration": 30,
  "unit": 1,
  "extBandWidth": 0,
  "bandWidthPrice": 0,
  "bridgePrice": 0,
  "projectId": "default"
}

字段	类型	必填	说明
`orderType`	string	是	静态代理使用 `static_proxy`。
`poolId`	string	是	产品编号。
`userId`	number	是	目标用户 ID。代理商只能为自己的下级用户下单。
`unitPrice`	number	是	单价。传 `0` 时后端可能按配置价格计算。
`totalAmount`	number	是	总金额。传 `0` 时部分产品支持后端计算。
`regionCode`	string	否	区域代码。
`countryCode`	string	否	国家代码。
`cityCode`	string	否	城市代码。
`staticType`	string	否	静态资源类型。
`ipCount`	number	是	IP 数量。
`cycleTimes`	number	是	购买周期数。
`duration`	number	是	时长。
`unit`	number	是	`1` = 天，`3` = 月，`4` = 年。
`cidrBlocks`	array	否	支持 CIDR 分配的产品可传网段和数量。
`assignedIp`	string	否	指定单个 IP。
`assignedIpList`	array	否	指定多个 IP。
`projectId`	string	否	共享静态代理产品的项目/业务类型。

GET `/open/app/static/order/list/v2`

查询静态订单和代理实例。

curl "$ZTPROXY_BASE/open/app/static/order/list/v2?page=1&pageSize=10&status=active" \
  -H "Authorization: Bearer $ZTPROXY_TOKEN"

参数	类型	说明
`page`	number	页码，默认 `1`。
`pageSize` / `page_size`	number	每页数量，最大 `100`。
`status`	string	订单状态筛选。
`filter`	string	控制台使用的业务筛选。
`user_id`	number	用户筛选。
`agent_id`	number	管理员按代理商筛选。
`search`	string	搜索订单号、IP、端口、用户名、密码或备注。
`region`	string	地区模糊筛选。
`created_start` / `created_end`	string	创建时间范围。
`expire_start` / `expire_end`	string	到期时间范围。
`show_recycle_bin`	boolean	普通用户是否查看回收站实例。

GET `/open/app/static/order/statistics`

查询静态订单各状态数量。

POST `/open/app/static/order/renew`

静态代理订单或实例续费。根据具体产品传入目标订单/实例标识、续费时长和价格字段。

POST `/open/app/static/order/{order_no}/cancel`

释放或取消静态订单。

代理白名单

POST `/open/app/proxy/addIpWhiteList/v2`

添加 IP 白名单。

请求

{
  "ip": "203.0.113.10"
}

POST `/open/app/proxy/delIpWhiteList/v2`

删除 IP 白名单。

请求

{
  "ip": "203.0.113.10"
}

部分部署中这两个白名单接口被放入免登录路径，但建议调用时仍携带 Bearer Token。

仪表盘和记录

GET `/open/app/dashboard/info/v2`

查询当前用户的余额、资源数量和仪表盘概览。管理员可传入 target_user_id。

GET `/open/app/user/transactions`

查询消费记录。

参数	类型	说明
`page`	number	页码。
`page_size`	number	每页数量，最大 `100`。
`type`	string	交易类型。
`order_type`	string	`static` 或 `dynamic`。
`start_date` / `end_date`	string	日期范围，格式 `YYYY-MM-DD`。
`username`	string	管理员按用户名筛选。
`order_no`	string	订单号筛选。
`keyword`	string	搜索备注、类型、订单号或用户名。
`target_user_id`	number	目标用户筛选。
`agent_id`	number	管理员按代理商筛选。

GET `/transaction/agent/transactions`

查询当前用户、代理商或管理员权限范围内的充值和余额调整记录。

指纹浏览器 API 域名

通过指纹浏览器调用 ZTProxy API 时，使用同一个后端域名：

https://api.wanyuagent.com/api

指纹浏览器环境相关 API 位于同一后端的 /api/browser 下，与代理下单 API 分开说明。

Documentation Index

​接口参考

​认证

​POST /auth/login

​用户

​POST /open/app/user/v2

​GET /open/app/user/balance/current

​产品与地区

​POST /open/app/product/query/v2

​GET /open/app/product/area/v2

​订单

​POST /open/app/order/create/v2

​POST /open/app/static/order/create/v2

​GET /open/app/static/order/list/v2

​GET /open/app/static/order/statistics

​POST /open/app/static/order/renew

​POST /open/app/static/order/{order_no}/cancel

​代理白名单

​POST /open/app/proxy/addIpWhiteList/v2

​POST /open/app/proxy/delIpWhiteList/v2

​仪表盘和记录

​GET /open/app/dashboard/info/v2

​GET /open/app/user/transactions

​GET /transaction/agent/transactions

​指纹浏览器 API 域名