获取统一身份认证登录次数
最近更新时间: 2025年11月28日 02时34分47秒
能力接口
开放平台
描述
根据系统编号(systemId)获取统一身份认证的登录次数、用户登录次数
支持的模式
客户端模式
请求方法
GET
请求地址
请求参数
| 参数名 | 是否必填 | 备注 |
|---|---|---|
| systemIds | 是 | 系统编号,支持批量获取 |
| year | 是 | 年份 |
| month | 否 | 月份 |
| startDate | 否 | 开始时间,格式yyyy-MM-dd |
| endDate | 否 | 结束时间,格式yyyy-MM-dd |
返回参数
| 参数名 | 类型 | 备注 | 码表 |
|---|---|---|---|
code | string | 响应状态码 | |
msg | string | 响应信息 | |
data | object | 相应数据 | |
stats | array[object] | 统计次数 | |
systemId | string | 系统编号信息 | |
loginCount | number | 登录次数 | 登录记录的数量(同一用户多次登录会重复计数) |
uniqueUsers | number | 登录用户数量 | 在某时间范围内,有多少不同的用户至少登录过一次(按学工号去重) |
解释说明
只支持查询2025年的数据 登录次数:登录记录的数量(同一用户多次登录会重复计数) 登录用户数量:在某时间范围内,有多少不同的用户至少登录过一次(按学工号去重)。
请求示例
curl --request GET 'https://api.tongji.edu.cn/v1/infra/iam/auth_statistics?systemIds=SYS0001,SYS0002&year=2025' \
返回示例
{
"code": "A00000",
"msg": "成功",
"data": {
"stats": [
{
"systemId": "SYS0001",
"loginCount": 723517,
"uniqueUsers": 60035
},
{
"systemId": "SYS0002",
"loginCount": 34,
"uniqueUsers": 15
}
]
}
}