会员资料

登录后的个人资料查询与昵称、姓名、头像、登录账号、密码、手机号维护。

当前会员资料

接口地址

GET /api/auth/profile

接口说明

手机号脱敏展示；头像为按当前存储配置补全后的访问地址。

接口参数说明

Header 参数	类型	必填	说明
X-Platform-Source	integer	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android
X-App-Version	string	否	客户端版本号，服务端仅透传记录

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 0,
    "sn": "M202609251754509918",
    "account": "",
    "nickname": "",
    "real_name": "",
    "avatar": "",
    "mobile": "138****8001",
    "gender": 1,
    "register_source": 1,
    "registered_at": "2026-09-25T10:00:00+08:00"
  }
}

响应参数说明

响应字段	类型	说明
id	integer	用户ID
sn	string	用户编号，全局唯一
account	string	登录账号，未设置为空串
nickname	string	昵称
real_name	string	姓名
avatar	string	头像访问地址（按当前默认存储动态生成）
mobile	string	手机号（脱敏展示，如 138****8001）
gender	integer	性别 1男 2女 3未知
register_source	integer	注册来源 1微信小程序 2微信公众号 3iOS 4Android
registered_at	string	注册时间

修改资料

接口地址

POST /api/auth/profile/update

接口说明

支持昵称、姓名、头像；头像传当前存储渠道返回的文件地址，服务端转为相对路径保存。

接口参数说明

Header 参数	类型	必填	说明
X-Platform-Source	integer	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android
X-App-Version	string	否	客户端版本号，服务端仅透传记录

Body 参数	类型	必填	说明
nickname	string	否	昵称
real_name	string	否	姓名
avatar	string	否	头像文件地址（保存时转为相对路径）

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "id": 0,
    "sn": "M202609251754509918",
    "account": "",
    "nickname": "",
    "real_name": "",
    "avatar": "",
    "mobile": "138****8001",
    "gender": 1,
    "register_source": 1,
    "registered_at": "2026-09-25T10:00:00+08:00"
  }
}

响应参数说明

响应字段	类型	说明
id	integer	用户ID
sn	string	用户编号，全局唯一
account	string	登录账号，未设置为空串
nickname	string	昵称
real_name	string	姓名
avatar	string	头像访问地址（按当前默认存储动态生成）
mobile	string	手机号（脱敏展示，如 138****8001）
gender	integer	性别 1男 2女 3未知
register_source	integer	注册来源 1微信小程序 2微信公众号 3iOS 4Android
registered_at	string	注册时间

修改登录账号

接口地址

POST /api/auth/account/update

接口说明

账号全表唯一，4-32 位字母、数字或下划线；已被使用时返回业务错误。

接口参数说明

Header 参数	类型	必填	说明
X-Platform-Source	integer	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android
X-App-Version	string	否	客户端版本号，服务端仅透传记录

Body 参数	类型	必填	说明
account	string	是	新登录账号，4-32位字母、数字或下划线，全表唯一

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "",
    "data": null
  }
}

响应参数说明

成功时 data 为 null。

修改登录密码

接口地址

POST /api/auth/password/update

接口说明

密码强度：至少 6 位且必须同时包含字母和数字。 已设置过密码时必须传原密码；修改成功后当前会话立即失效，需重新登录。 未设置过密码（短信验证码注册）可不传原密码直接设置。

接口参数说明

Header 参数	类型	必填	说明
X-Platform-Source	integer	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android
X-App-Version	string	否	客户端版本号，服务端仅透传记录

Body 参数	类型	必填	说明
old_password	string	否	原密码，已设置过密码时必填
new_password	string	是	新密码，至少6位且同时包含字母和数字

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "",
    "data": null
  }
}

响应参数说明

成功时 data 为 null。

修改手机号

接口地址

POST /api/auth/mobile/update

接口说明

需要先对新手机号发送场景 3（换绑手机号）验证码；新手机号不能已被其他账号绑定。

接口参数说明

Header 参数	类型	必填	说明
X-Platform-Source	integer	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android
X-App-Version	string	否	客户端版本号，服务端仅透传记录

Body 参数	类型	必填	说明
mobile	string	是	新手机号
code	string	是	发送到新手机号的短信验证码

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "",
    "data": null
  }
}

响应参数说明

成功时 data 为 null。