头像上传

接口说明

以 multipart/form-data 格式上传图片文件作为用户头像。上传成功后返回头像的相对 URL，可拼接基础域名后在前端展示。支持常见图片格式，文件大小不得超过 2MB。

请求信息

项目	值
Method	POST
URL	/api/user/avatar
鉴权	Bearer Token（是）
Content-Type	multipart/form-data

请求参数

参数名	类型	必填	说明
avatar	file	是	头像图片文件，须为图片类型，最大 2MB

请求示例

curl -X POST "https://devapi.fengshengshou.com/api/user/avatar" \
  -H "Authorization: Bearer your_token_here" \
  -F "avatar=@/path/to/avatar.png"

响应参数

字段	类型	说明
code	int	0=成功
message	string	提示信息
data.avatar	string	头像相对 URL

成功响应

{
  "code": 0,
  "message": "上传成功",
  "data": {
    "avatar": "/storage/avatars/101_1720137600.png"
  }
}

失败响应

{ "code": 422, "message": "头像文件不能为空", "data": null }

{ "code": 422, "message": "上传文件须为图片格式", "data": null }

{ "code": 422, "message": "文件大小不能超过 2MB", "data": null }