退出登录
接口说明:用户退出登录,销毁当前Token和refreshToken,使其立即失效。
1. 接口信息
| 参数 |
说明 |
| 请求方式 |
POST |
| 接口地址 |
/api/v1/auth/logout |
| 是否需要授权 |
是 |
| 请求格式 |
JSON |
2. 请求参数
2.1 Header参数
| 参数名 |
必选 |
类型 |
说明 |
| Authorization |
是 |
string |
Bearer + Token |
| Content-Type |
是 |
string |
application/json |
2.2 Body参数
| 参数名 |
必选 |
类型 |
说明 |
| userId |
是 |
string |
用户ID |
3. 请求示例
POST /api/v1/auth/logout HTTP/1.1
Host: eimsnext.example.com
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
Content-Type: application/json
{
"userId": "10001"
}
4. 响应结果
4.1 成功响应
200 OK
{
"code": 200,
"msg": "退出成功",
"data": null
}
4.2 失败响应
401 Unauthorized
{
"code": 401,
"msg": "Token无效",
"data": null
}
5. 错误码说明
| 错误码 |
说明 |
解决方案 |
| 401 |
Token无效或过期 |
确认Token是否正确 |
| 400 |
用户ID缺失 |
补充userId参数 |
| 500 |
服务器内部错误 |
联系技术支持 |
6. 注意事项
- 退出后当前Token和refreshToken立即失效
- 建议客户端退出时清除本地存储的Token信息
- 即使Token已过期,调用退出接口仍会清理服务端缓存