管理动态代理子账户。基础地址:https://backend.ztproxy.net/api

动态子账户

动态代理支持为用户创建子账户,并对每个子账户单独设置流量、状态和密码。所有接口都需要 Bearer Token。

代理商只能操作自己和下级用户;普通用户只能操作自己的子账户。

创建子账户

对外路径请以 ZTProxy 支持团队提供的中性路径为准。请求体示例:

{
  "username": "sub001",
  "password": "pass1234",
  "flow_limit_gb": 10,
  "remark": "测试子账户"
}

字段说明:

字段类型必填说明
usernamestring子账户用户名,2-12 位字母和数字。
passwordstring子账户密码,4-12 位字母和数字。
flow_limit_gbnumber子账户流量上限,单位 GB。大于 0 时会从主账户可用流量中分配。
remarkstring备注。

成功响应:

{
  "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>"

该接口会按当前账号权限返回可见子账户。