文档 / 用户 User / 更新资料

更新资料

POST|PATCH /api/me 需登录

至少传一个字段；返回更新后的完整 user。切换 APP 语言时建议同步 PATCH locale（及 device_lang/timezone）。

模拟请求

已预填本接口参数，可直接改 Body 后发送。验证码 mock：1111；注册/登录成功后自动缓存 token。

POST

携带 Authorization

Body（JSON）

占位符 {{refresh_token}} / {{access_token}} 发送时自动替换。

响应

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

请求 Body 字段

字段	说明
`username`	string, 可选, 用户名（唯一）
`nickname`	string, 可选, 昵称
`avatar_url`	string, 可选, 直接设 URL（上传文件请用 /me/avatar）
`signature`	string, 可选, 个性签名 ≤100
`bio`	string, 可选, 自我介绍 ≤500
`country`	string, 可选, ISO 3166-1 alpha-2
`device_lang`	string, 可选, 设备语言 BCP 47
`locale`	string, 可选, APP 使用语言
`timezone`	string, 可选, IANA 时区

响应 `data` 字段说明

字段	类型 / 说明
`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": {
        "user": {
            "id": 1,
            "email": "[email protected]",
            "username": "bead_lover",
            "nickname": "新昵称",
            "avatar_url": "/uploads/avatars/u1_a8fdeec9ac68d6ff.jpg",
            "signature": "今天也要认真串珠",
            "bio": "喜欢分享材料与成品。",
            "country": "KR",
            "device_lang": "ko-KR",
            "locale": "ko",
            "timezone": "Asia/Seoul",
            "status": 1,
            "email_verified_at": "2026-08-01 10:00:00",
            "created_at": "2026-08-01 10:00:00"
        }
    }
}