获取会话历史
GET
/web/v1/users/self/security/sessions/history JWT获取已认证用户的分页登录历史记录。支持时间范围筛选。此端点替代旧的 GET /profile/login-history。
鉴权
Auth Chain: WEB Chain — 需要
Authorization: Bearer <jwt>以下请求头由系统自动注入(前端无需处理):X-PORTAL-ACCESS-CODE(Nginx),X-Request-Id(Gateway)
请求参数
| Name | Type | Required | In | Description |
|---|---|---|---|---|
page | Integer | Optional | query | 页码(默认: 0) |
size | Integer | Optional | query | 每页大小(默认: 20) |
startTime | String | Optional | query | 筛选开始时间(ISO 8601) |
endTime | String | Optional | query | 筛选结束时间(ISO 8601) |
成功响应
成功 200
{
"version": "1.3.0",
"timestamp": 1709337600000,
"success": true,
"code": "2000",
"message": "SUCCESS",
"data": {
"content": [
{
"loginTime": "2026-03-23T12:00:00Z",
"ipAddress": "1.2.3.4",
"userAgent": "Mozilla/5.0...",
"location": "San Francisco, US",
"success": true
}
],
"totalElements": 42,
"totalPages": 3,
"number": 0,
"size": 20
}
}错误响应
Unauthorized 401
{
"success": false,
"code": "4010",
"message": "Invalid or expired token"
}说明
- 替代旧的
GET /profile/login-history端点——现归入会话管理模块。 - 支持分页和时间范围筛选。
- 结果按登录时间降序排列(最新优先)。