当前用户
当前登录用户查看或修改自己的资料、实名认证与界面偏好。
me用户账号鉴权: 用户6 个接口当前用户
GET
/api/v2/me鉴权: 用户
修改个人资料
PUT
/api/v2/me鉴权: 用户
请求体 application/json
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| string | — | 邮箱 | |
| email_code | string | — | 发到新邮箱的验证码(POST /verify-codes,purpose=bind);改邮箱时必填。 |
| login_ip_allow | string[] | — | 登录 IP 白名单(IP 或 CIDR);空 = 不限。 |
| login_verify | LoginVerify | — | 登录二次验证:none 不要求;email / sms 登录时还要邮件/短信验证码(须平台允许且已绑定对应地址)。 |
| phone | string | — | 手机号 |
| phone_code | string | — | 发到新手机号的验证码(POST /verify-codes,purpose=bind);改手机号时必填。 |
实名认证状态
GET
/api/v2/me/certification鉴权: 用户
提交实名认证
POST
/api/v2/me/certification鉴权: 用户
请求体 application/json
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id_number | string | 必填 | 打码后的证件号。 |
| real_name | string | 必填 | 打码后的姓名。 |
用户偏好
GET
/api/v2/me/preferences鉴权: 用户
修改用户偏好
PUT
/api/v2/me/preferences鉴权: 用户
当前用户对象
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 带。 |
| 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 登录时还要邮件/短信验证码(须平台允许且已绑定对应地址)。 |
| phone | string | — | 手机号 |
| phone_code | string | — | 发到新手机号的验证码(POST /verify-codes,purpose=bind);改手机号时必填。 |
| provider | string | — | 实名认证通道。 |
| real_name | string | — | 打码后的姓名。 |
| reason | string | — | 未通过的原因。 |
| role | string | — | 账号角色:admin 管理员,tenant 租户。 |
| status | string | — | 实名状态:none 未认证,pending 待认证,verified 已通过,failed 未通过。 |
| totp_enabled | boolean | — | 是否已启用动态口令。 |
| totp_recovery_left | integer | — | 未用完的 TOTP 恢复码个数。只有 GET /me、PUT /me 且已启用动态口令时带。 |
| updated_at | string | — | 更新时间 |
| url | string | — | 待认证时用户要去的认证地址(仅提交时返回)。 |
| username | string | — | 用户名 |