guke
a563c1ca4b
docs/api目录文档分类和补全 --------- Co-authored-by: guke <guke@autohome.com.cn> Reviewed-on: #111
971 B
971 B
PATCH /api/v1/user/profile — 修改昵称
所属:User 组（前缀
/api/v1/user） | 鉴权:Bearer access_token | ← 返回 API 索引
入参
请求体 JSON:
| 字段 | 类型 | 说明 |
|---|---|---|
nickname |
string | 昵称,1-16 字(前后空格自动 strip,strip 后为空判 400) |
出参
响应 200:UserOut(返回更新后的完整用户对象,nickname 字段已更新)。结构见 API 索引。
错误码
401未带 token / token 无效或过期 / 用户被禁用422字段校验失败(nickname缺失 / 长度超 16 字 / 全空白)
说明
- 服务端持久化:写入
user.nickname列。这是昵称的唯一数据源——客户端之前的本地缓存退登即丢,改完后下次登录走/auth/me与登录响应回传仍生效 - strip 行为:服务端会先去除前后空白再校验长度,所以
" bob "等价于"bob"