更新用户头像

接口说明

更新当前登录用户的头像

该接口需要在APP后台启用登录

注意事项

  1. 接口需要在请求头中携带有效的Authorization Token
  2. 头像文件必须是jpg、png或jpeg格式
  3. 头像文件大小不能超过2MB
  4. 上传成功后，头像会被自动调整为等比例缩放，最大尺寸为300x300像素
  5. 旧的头像文件会被自动删除
  6. 返回的头像URL为完整的可访问地址

请求路径

Method URI Path 鉴权方式
POST /v1/user/avatar Token认证

请求参数

公共参数

参数名 类型 取值范围 是否必须 说明
Authorization string Bearer + token 是 登录令牌，Header传值，格式：Bearer eyJxx...

业务参数

参数名 类型 取值范围 是否必须 说明
avatar file jpg/png/jpeg 是 头像文件，大小不超过2MB

请求示例代码

  • multipart/form-data方式
curl --location --request POST 'https://api.zaihangyun.com/v1/user/avatar' \
--header 'User-Agent: Apifox/1.0.0 (https://apifox.com)' \
--header 'Authorization: Bearer ZaihangyunToken' \
--header 'Accept: */*' \
--header 'Host: api.zaihangyun.com' \
--header 'Connection: keep-alive' \
--header 'Content-Type: multipart/form-data; boundary=--------------------------727991052611410691319631' \
--form 'avatar=@"/Users/xxxx/Pictures/img-2.jpg"'

返回响应

  • 成功返回
{
    "code": 200,
    "msg": "success",
    "data": {
        "avatar": "http://www.zaihangyun.com/storage/mch/avatar/D5fceA1sxxxmaMY1F/1851248324/03d62725bc91xxx07f9115092160a8cb.jpg"
    }
}
  • 错误返回
{
    "code": 400102,
    "msg": "avatar size must be less than 2MB"
}

错误码说明

查看全局错误码

错误码 说明
400101 头像文件不能为空
400102 头像文件大小不能超过2MB
400103 头像文件格式必须是jpg、png或jpeg
400199 用户不存在
400250 更新用户信息失败