文档 / 用户 User / 上传头像

上传头像

POST /api/me/avatar 需登录

multipart 字段名 file。成功后 users.avatar_url 已更新，user 为最新资料。

模拟请求

本接口为 multipart/form-data 上传，选择图片后发送。需先登录拿到 token。

POST

携带 Authorization

上传图片（字段名 file）

选择图片文件

未选择文件

支持 jpg / jpeg / png / webp / gif，最大 2MB。点「发送请求」才会上传。

响应

点击「发送请求」查看结果

请求 Body 字段

字段	说明
`file`	file, 必填, jpg/jpeg/png/webp/gif，最大 2MB

响应 `data` 字段说明

字段	类型 / 说明
`avatar_url`	string, 可访问路径，如 /uploads/avatars/u1_xxx.jpg
`user.id`	int, 用户 ID
`user.email`	string, 登录邮箱
`user.username`	string, 用户名；可空串
`user.nickname`	string, 昵称
`user.avatar_url`	string, 头像路径/URL；可空串
`user.signature`	string, 个性签名；可空串
`user.bio`	string, 自我介绍；可空串
`user.country`	string, 国家/地区 ISO 3166-1 alpha-2，如 US / JP / KR；可空串
`user.device_lang`	string, 设备系统语言 BCP 47，如 en-US / ja-JP；可空串
`user.locale`	string, 当前 APP 使用语言：en/zh/ja/ko/de/fr/es/it/pt/nl/pl；可空串
`user.timezone`	string, 设备时区 IANA，如 America/New_York / Asia/Tokyo；可空串
`user.status`	int, 0待验证 1正常 2禁用 3注销
`user.email_verified_at`	string\|null, 邮箱验证时间 UTC
`user.created_at`	string\|null, 注册时间 UTC

完整响应示例

成功时的整包 JSON（APP 可按此解析）。统一外壳 code / message / data。

{
    "code": 0,
    "message": "ok",
    "data": {
        "avatar_url": "/uploads/avatars/u1_a8fdeec9ac68d6ff.jpg",
        "user": {
            "id": 1,
            "email": "[email protected]",
            "username": "demo_user",
            "nickname": "Demo",
            "avatar_url": "/uploads/avatars/u1_a8fdeec9ac68d6ff.jpg",
            "signature": "热爱串珠的手作人",
            "bio": "分享串珠作品与材料心得。",
            "country": "US",
            "device_lang": "en-US",
            "locale": "en",
            "timezone": "America/New_York",
            "status": 1,
            "email_verified_at": "2026-08-01 10:00:00",
            "created_at": "2026-08-01 10:00:00"
        }
    }
}