更新用户头像接口

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

    注意事项

    • 该接口采用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