更新用户头像接口

允许用户上传自定义头像图片,支持常见的图片格式,用于更新用户个人资料中的头像信息。

注意事项

  • 该接口采用POST方法,需要以form-data格式提交数据
  • 需要用户登录后才能调用此接口
  • 上传的文件必须是图片格式(如JPG、PNG、WEBP等)
  • 文件大小和格式可能有限制,具体取决于系统配置
  • 上传成功后会自动更新当前登录用户的头像

请求地址

{域名地址}/api/user/avatar

说明:{域名地址} 需要替换成你的域名地址,如 https://www.anqicms.com/api/user/avatar

请求语法

POST {域名地址}/api/user/avatar
Content-Type: multipart/form-data

请求头

此接口还涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求参数

字段名 类型 必填 说明
file File 要上传的头像图片资源,支持常见图片格式

响应头

此接口仅涉及公共响应头。更多信息,请参见公共请求头(Common Request Headers)

返回参数

字段名 类型 说明
code int 错误码
msg string 错误原因说明
data object 结果内容

data 参数

字段名 类型 说明
avatar_url string 上传后的头像图片访问地址

使用示例

请求示例

POST /api/user/avatar HTTP/1.1
Host: www.anqicms.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="avatar.jpg"
Content-Type: image/jpeg

<二进制图片数据>
------WebKitFormBoundary7MA4YWxkTrZu0gW--

响应示例

{
  "code": 0,
  "msg": "上传成功",
  "data": {
    "avatar_url": "https://www.anqicms.com/uploads/user/1.webp"
  }
}

错误代码

错误码 说明
0 OK
-1 错误,错误原因在 msg 中指出
1001 未登录
1002 未授权
200 API 请求 OK