管理动态代理子账户。基础地址:https://backend.ztproxy.net/api
动态子账户
动态代理支持为用户创建子账户,并对每个子账户单独设置流量、状态和密码。所有接口都需要 Bearer Token。
代理商只能操作自己和下级用户;普通用户只能操作自己的子账户。
创建子账户
对外路径请以 ZTProxy 支持团队提供的中性路径为准。请求体示例:
{
"username": "sub001",
"password": "pass1234",
"flow_limit_gb": 10,
"remark": "测试子账户"
}字段说明:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
username | string | 是 | 子账户用户名,2-12 位字母和数字。 |
password | string | 是 | 子账户密码,4-12 位字母和数字。 |
flow_limit_gb | number | 否 | 子账户流量上限,单位 GB。大于 0 时会从主账户可用流量中分配。 |
remark | string | 否 | 备注。 |
成功响应:
{
"code": 0,
"msg": "子账户创建成功",
"data": {
"id": 12,
"user_id": 1001,
"username": "sub001",
"flow_limit_mb": 10000,
"status": 1
}
}查询子账户列表
对外路径请以 ZTProxy 支持团队提供的中性路径为准。
响应会返回子账户记录和实时流量数据,常见字段包括:
| 字段 | 说明 |
|---|---|
username | 子账户用户名。 |
download_flow_gb | 下载流量,单位 GB。 |
upload_flow_gb | 上传流量,单位 GB。 |
flow_limit_gb | 流量上限,单位 GB。 |
status_text | 子账户状态文案。 |
main_username | 主账户用户名。 |
调整子账户流量
{
"sub_user_id": 12,
"flow_change_gb": 5
}flow_change_gb 为正数表示给子账户增加流量,同时减少主账户流量;为负数表示从子账户回收流量,同时增加主账户流量。
修改子账户状态
{
"sub_user_id": 12,
"status": 1
}status: 1 表示启用,status: 0 表示停用。
修改子账户密码
{
"sub_user_id": 12,
"new_password": "newpass1"
}新密码需要为 4-12 位字母和数字。
删除子账户
{
"sub_user_id": 12
}删除时会先停用子账户,再删除本地记录。
子账户概览
如果只需要读取动态子账户概览,也可以使用:
curl -X GET "https://backend.ztproxy.net/api/open/app/dashboard/child-accounts" \
-H "Authorization: Bearer <token>"该接口会按当前账号权限返回可见子账户。