## 当前用户 (`me`)

当前登录用户查看或修改自己的资料、实名认证与界面偏好。

鉴权: 用户 · 文档: https://www-demo.kuxitong.com/zh/docs/api/me

### GET `/api/v2/me`

当前用户 · 鉴权: 用户

```sh
curl "https://panel.example.com/api/v2/me" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/me`

修改个人资料 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `email` | string |  | 邮箱 |
| `email_code` | string |  | 发到新邮箱的验证码(POST /verify-codes,purpose=bind);改邮箱时必填。 |
| `login_ip_allow` | string[] |  | 登录 IP 白名单(IP 或 CIDR);空 = 不限。 |
| `login_verify` | LoginVerify |  | 登录二次验证:none 不要求;email / sms 登录时还要邮件/短信验证码(须平台允许且已绑定对应地址)。 可选值: ["none","email","sms"] |
| `phone` | string |  | 手机号 |
| `phone_code` | string |  | 发到新手机号的验证码(POST /verify-codes,purpose=bind);改手机号时必填。 |

```sh
curl -X PUT "https://panel.example.com/api/v2/me" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### GET `/api/v2/me/certification`

实名认证状态 · 鉴权: 用户

```sh
curl "https://panel.example.com/api/v2/me/certification" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/me/certification`

提交实名认证 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `id_number` | string | 有 | 打码后的证件号。 |
| `real_name` | string | 有 | 打码后的姓名。 |

```sh
curl -X POST "https://panel.example.com/api/v2/me/certification" \
  -H "X-API-Key: $GOCDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"id_number":"11010519491231002X","real_name":"张三"}'
```

### GET `/api/v2/me/preferences`

用户偏好 · 鉴权: 用户

```sh
curl "https://panel.example.com/api/v2/me/preferences" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/me/preferences`

修改用户偏好 · 鉴权: 用户

```sh
curl -X PUT "https://panel.example.com/api/v2/me/preferences" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

当前用户对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `balance_cents` | integer |  | 账户余额(分),同 GET /users/{user_id}/account 的 balance_cents(无账户记 0)。只有 GET /users 列表带,单个用户的读写接口不带。 (只读) |
| `certified` | boolean |  | 是否已通过实名认证。 |
| `client_ip` | string |  | 本次请求的来源 IP,与登录 IP 白名单校验用的是同一个取法(白名单比什么就显示什么)。只有 GET /me、PUT /me 带。 (只读) |
| `created_at` | string |  | 创建时间 (只读) |
| `delegated_session` | boolean |  | 当前会话是否由超管代登录或切换为用户签发(是则口令、邮箱、手机号、登录白名单、二次验证与实名只读)。只有 GET /me、PUT /me 带。 (只读) |
| `email` | string |  | 邮箱 |
| `email_code` | string |  | 发到新邮箱的验证码(POST /verify-codes,purpose=bind);改邮箱时必填。 |
| `enabled` | boolean |  | 是否启用 |
| `id` | integer |  | 记录 ID (只读) |
| `id_number` | string |  | 打码后的证件号。 |
| `login_ip_allow` | string[] |  | 登录 IP 白名单(IP 或 CIDR);空 = 不限。 |
| `login_verify` | LoginVerify |  | 登录二次验证:none 不要求;email / sms 登录时还要邮件/短信验证码(须平台允许且已绑定对应地址)。 可选值: ["none","email","sms"] |
| `phone` | string |  | 手机号 |
| `phone_code` | string |  | 发到新手机号的验证码(POST /verify-codes,purpose=bind);改手机号时必填。 |
| `provider` | string |  | 实名认证通道。 |
| `real_name` | string |  | 打码后的姓名。 |
| `reason` | string |  | 未通过的原因。 |
| `role` | string |  | 账号角色:admin 管理员,tenant 租户。 可选值: ["admin","tenant"] |
| `status` | string |  | 实名状态:none 未认证,pending 待认证,verified 已通过,failed 未通过。 可选值: ["none","pending","verified","failed"] |
| `totp_enabled` | boolean |  | 是否已启用动态口令。 |
| `totp_recovery_left` | integer |  | 未用完的 TOTP 恢复码个数。只有 GET /me、PUT /me 且已启用动态口令时带。 (只读) |
| `updated_at` | string |  | 更新时间 (只读) |
| `url` | string |  | 待认证时用户要去的认证地址(仅提交时返回)。 |
| `username` | string |  | 用户名 |