修改资料

接口说明

提交需要修改的字段即可完成资料更新，未传递的字段保持不变。所有参数均为可选，至少传递一个字段方有实际效果。

请求信息

项目	值
Method	PUT
URL	/api/user/profile
鉴权	Bearer Token（是）

请求参数

参数名	类型	必填	说明
name	string	否	显示名称，最长 50 字符
phone	string	否	手机号，最长 20 字符
email	string	否	邮箱地址，最长 100 字符
position	string	否	职位，最长 50 字符
department_id	int	否	所属部门 ID，须为系统中有效的部门

请求示例

curl -X PUT "https://devapi.fengshengshou.com/api/user/profile" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "张三丰",
    "position": "高级工程师",
    "department_id": 6
  }'

响应参数

字段	类型	说明
code	int	0=成功
message	string	提示信息
data.id	int	用户 ID
data.username	string	登录用户名
data.name	string	显示名称
data.phone	string|null	手机号，可为空
data.email	string|null	邮箱地址，可为空
data.avatar	string|null	头像地址，可为空
data.company_id	int|null	所属公司 ID，可为空
data.company	object|null	公司信息（含 id、name），无则为 null
data.department	object|null	部门信息（含 id、name），无则为 null
data.position	string|null	职位，可为空
data.created_at	string|null	账号创建时间（Y-m-d H:i:s），可为空

成功响应

{
  "code": 0,
  "message": "更新成功",
  "data": {
    "id": 101,
    "username": "zhangsan",
    "name": "张三丰",
    "phone": "13800138000",
    "email": "zhangsan@example.com",
    "avatar": null,
    "company_id": 10,
    "company": { "id": 10, "name": "示例科技有限公司" },
    "department": { "id": 6, "name": "产品部" },
    "position": "高级工程师",
    "created_at": "2026-01-15 10:00:00"
  }
}

失败响应

{ "code": 422, "message": "参数校验失败", "data": null }

{ "code": 422, "message": "部门不存在", "data": null }