获取用户详情
接口说明:根据用户ID获取指定用户的详细信息,需携带有效Token访问。
1. 接口信息
| 参数 |
说明 |
| 请求方式 |
GET |
| 接口地址 |
/api/v1/users/{userId} |
| 是否需要授权 |
是 |
| 请求格式 |
Path + Query |
2. 请求参数
2.1 Header参数
| 参数名 |
必选 |
类型 |
说明 |
| Authorization |
是 |
string |
Bearer + Token |
2.2 Path参数
| 参数名 |
必选 |
类型 |
说明 |
| userId |
是 |
string |
用户ID |
3. 请求示例
GET /api/v1/users/10001 HTTP/1.1
Host: eimsnext.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
4. 响应结果
4.1 成功响应
200 OK
{
"code": 200,
"msg": "查询成功",
"data": {
"userId": "10001",
"userName": "张三",
"mobile": "13800138000",
"email": "zhangsan@example.com",
"deptId": "D001",
"deptName": "技术部",
"position": "前端开发",
"status": 1,
"statusName": "启用",
"createTime": "2025-01-01 10:00:00",
"updateTime": "2025-01-10 15:30:00",
"lastLoginTime": "2025-01-20 09:00:00"
}
}
4.2 失败响应
404 Not Found
{
"code": 404,
"msg": "用户不存在",
"data": null
}
5. 错误码说明
| 错误码 |
说明 |
解决方案 |
| 401 |
Token无效或过期 |
重新获取Token |
| 403 |
无权限查看该用户 |
分配对应权限 |
| 404 |
用户ID不存在 |
检查用户ID是否正确 |
| 500 |
服务器内部错误 |
联系技术支持 |
6. 注意事项
- 仅能查看当前用户有权限访问的用户详情
- 敏感字段(如密码)不会返回
- 接口调用频率限制:20次/分钟