修改用户信息
接口说明:修改指定用户的基本信息,需携带有效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. 注意事项
- 仅需传递需要修改的参数,无需传递全部参数
- 手机号不支持修改,如需修改请联系管理员
- 禁用用户后,该用户将无法登录系统