修改用户信息

接口说明:修改指定用户的基本信息,需携带有效Token且拥有对应权限。

1. 接口信息

参数 说明
请求方式 PATCH
接口地址 /api/v1/users/{userId}
是否需要授权 是
请求格式 JSON

2. 请求参数

2.1 Header参数

参数名 必选 类型 说明
Authorization 是 string Bearer + Token
Content-Type 是 string application/json

2.2 Path参数

参数名 必选 类型 说明
userId 是 string 用户ID

2.3 Body参数

参数名 必选 类型 说明
userName 否 string 用户名
email 否 string 邮箱
deptId 否 string 部门ID
position 否 string 职位
status 否 int 状态:1-启用,2-禁用

3. 请求示例

PATCH /api/v1/users/10003 HTTP/1.1
Host: eimsnext.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json

{
  "userName": "王五",
  "email": "wangwu_new@example.com",
  "deptId": "D002",
  "position": "高级后端开发",
  "status": 1
}
    

4. 响应结果

4.1 成功响应

200 OK

{
  "code": 200,
  "msg": "修改成功",
  "data": null
}
    

4.2 失败响应

404 Not Found

{
  "code": 404,
  "msg": "用户不存在",
  "data": null
}
    

5. 错误码说明

错误码 说明 解决方案
401 Token无效或过期 重新获取Token
403 无修改权限 分配对应权限
404 用户ID不存在 检查用户ID是否正确
500 服务器内部错误 联系技术支持

6. 注意事项