103 lines
2.5 KiB
Markdown
103 lines
2.5 KiB
Markdown
# 查询所有登录成功历史分组数据
|
||
|
||
## 接口信息
|
||
|
||
- **接口路径**: `GET /auth/history/latest-success-grouped`
|
||
- **接口描述**: 查询所有登录成功的历史记录，按username和instanceUrl分组，每组返回最新一条数据
|
||
- **权限要求**: `auth:history:list`
|
||
- **请求类型**: GET
|
||
|
||
## 请求参数
|
||
|
||
无
|
||
|
||
## 响应数据
|
||
|
||
### 成功响应
|
||
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "查询成功",
|
||
"rows": [
|
||
{
|
||
"id": 1,
|
||
"loginType": "password",
|
||
"username": "admin@example.com",
|
||
"passwordEncrypted": null,
|
||
"securityTokenEncrypted": null,
|
||
"clientId": null,
|
||
"clientSecretEncrypted": null,
|
||
"grantType": null,
|
||
"orgAlias": null,
|
||
"privateKeyPath": null,
|
||
"code": null,
|
||
"state": null,
|
||
"sessionId": "xxxxx",
|
||
"environmentCode": null,
|
||
"environmentId": null,
|
||
"instanceUrl": "https://xxx.my.salesforce.com",
|
||
"organizationId": "00Dxxxxxxxxxxxx",
|
||
"orgType": "Source",
|
||
"requestIp": "192.168.1.1",
|
||
"requestPort": 8080,
|
||
"userAgent": "Mozilla/5.0",
|
||
"deviceType": "PC",
|
||
"browserType": "Chrome",
|
||
"osType": "Windows",
|
||
"loginStatus": "success",
|
||
"errorCode": null,
|
||
"errorMessage": null,
|
||
"sessionIdResult": "xxxxx",
|
||
"refreshTokenEncrypted": null,
|
||
"tokenType": "Bearer",
|
||
"expiresIn": 3600,
|
||
"requestTime": "2026-01-16 10:00:00",
|
||
"responseTime": "2026-01-16 10:00:01",
|
||
"durationMs": 1000,
|
||
"operator": "admin",
|
||
"deptId": 1,
|
||
"createBy": "admin",
|
||
"createTime": "2026-01-16 10:00:01",
|
||
"updateBy": "admin",
|
||
"updateTime": "2026-01-16 10:00:01",
|
||
"remark": null
|
||
}
|
||
],
|
||
"total": 1
|
||
}
|
||
```
|
||
|
||
### 失败响应
|
||
|
||
```json
|
||
{
|
||
"code": 500,
|
||
"message": "查询失败",
|
||
"data": null
|
||
}
|
||
```
|
||
|
||
## 功能说明
|
||
|
||
1. **分组逻辑**: 按照用户名（username）和实例URL（instanceUrl）进行分组
|
||
2. **最新记录**: 每个分组只返回创建时间最新的一条记录
|
||
3. **登录状态**: 只返回登录状态为 success 的记录
|
||
4. **数据转换**: 返回的数据会自动转换为 VO 对象
|
||
|
||
## 使用场景
|
||
|
||
- 查看不同用户在不同环境下的最新登录记录
|
||
- 快速了解系统中的活跃用户和环境
|
||
- 用于登录历史分析和统计
|
||
|
||
## 相关接口
|
||
|
||
- [查询登录历史信息列表](./0001-list.md)
|
||
- [获取登录历史信息详细信息](./0003-get-info.md)
|
||
|
||
## 相关文档
|
||
|
||
- [需求文档](../../../requirements/REQ-007.md)
|
||
- [架构决策](../../../decisions/adr/0007-login-history-query-and-auto-login.md)
|