跳到主要内容

修改用户基础信息

POST 
/auth/v1/user/basic/edit

接口说明​

修改用户基础信息，支持修改昵称、用户名、手机号、邮箱、头像、性别、描述等基本信息

入参要求：​

  • Authorization: 当前登录用户的access_token（必填，请求头中传入，格式为Bearer xxx）
  • client_id: 应用对应的客户端id（可选，默认为环境id）
  • x-device-id: 设备id（可选，当前登录设备的id）
  • 请求体参数：
    • user_id: 用户id（可选，修改其他用户信息时需要管理员权限）
    • nickname: 昵称（可选，2-48位）
    • username: 用户名（可选，2-48位，支持英文大小写、数字、特殊字符）
    • phone: 手机号（可选，格式：+86 13000000000）
    • description: 描述（可选，用户个人简介）
    • avatar_url: 头像URL（可选）
    • gender: 性别（可选，MALE-男，FEMALE-女）
    • email: 邮箱（可选，有效的邮箱格式）

前置条件：​

  • 需要有效的access_token
  • 只能修改自己的信息，除非有管理员权限
  • 用户名修改需要验证唯一性
  • 手机号、邮箱修改可能需要验证码验证

出参：​

  • 返回空对象表示修改成功
  • 错误时返回错误信息

修改用户信息请求示例​

POST /auth/v1/user/basic/edit
Authorization: Bearer your_access_token
x-device-id: device_123456
Content-Type: application/json

{
  "nickname": "张三",
  "username": "zhangsan",
  "phone": "+86 13000000000",
  "description": "这是一位热爱技术的开发者",
  "avatar_url": "https://example/avatar.jpg",
  "gender": "MALE",
  "email": "zhangsan@example"
}

修改用户信息响应示例（成功）​

{}

修改用户信息响应示例（失败）​

{
  "error": "username_already_exists",
  "error_code": 409,
  "error_description": "用户名已存在"
}

使用场景：​

  • 用户修改个人资料
  • 管理员修改用户信息
  • 用户绑定或更换手机号、邮箱
  • 更新用户头像和基本信息

注意事项：​

  • 用户名修改需要验证唯一性
  • 手机号、邮箱修改需要发送验证码
  • 敏感信息修改可能需要二次验证
  • 管理员可以修改其他用户信息，普通用户只能修改自己的信息

Request​

Responses​

A successful response.

Response Headers