> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexalayer.net/llms.txt
> Use this file to discover all available pages before exploring further.

# 动态子账户

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

# 动态子账户

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

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

## 创建子账户

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

```json theme={null}
{
  "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 |  否  | 备注。                               |

成功响应：

```json theme={null}
{
  "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`    | 主账户用户名。     |

## 调整子账户流量

```json theme={null}
{
  "sub_user_id": 12,
  "flow_change_gb": 5
}
```

`flow_change_gb` 为正数表示给子账户增加流量，同时减少主账户流量；为负数表示从子账户回收流量，同时增加主账户流量。

## 修改子账户状态

```json theme={null}
{
  "sub_user_id": 12,
  "status": 1
}
```

`status: 1` 表示启用，`status: 0` 表示停用。

## 修改子账户密码

```json theme={null}
{
  "sub_user_id": 12,
  "new_password": "newpass1"
}
```

新密码需要为 4-12 位字母和数字。

## 删除子账户

```json theme={null}
{
  "sub_user_id": 12
}
```

删除时会先停用子账户，再删除本地记录。

## 子账户概览

如果只需要读取动态子账户概览，也可以使用：

```bash theme={null}
curl -X GET "https://backend.ztproxy.net/api/open/app/dashboard/child-accounts" \
  -H "Authorization: Bearer <token>"
```

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