2.5 KiB
2.5 KiB
查询所有登录成功历史分组数据
接口信息
- 接口路径:
GET /auth/history/latest-success-grouped - 接口描述: 查询所有登录成功的历史记录，按username和instanceUrl分组，每组返回最新一条数据
- 权限要求:
auth:history:list - 请求类型: GET
请求参数
无
响应数据
成功响应
{
"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
}
失败响应
{
"code": 500,
"message": "查询失败",
"data": null
}
功能说明
- 分组逻辑: 按照用户名（username）和实例URL（instanceUrl）进行分组
- 最新记录: 每个分组只返回创建时间最新的一条记录
- 登录状态: 只返回登录状态为 success 的记录
- 数据转换: 返回的数据会自动转换为 VO 对象
使用场景
- 查看不同用户在不同环境下的最新登录记录
- 快速了解系统中的活跃用户和环境
- 用于登录历史分析和统计