用户认证日志查询

接口说明

请求URL：http[s]://{网关地址}/minos-manager/userLoginLog/v2/query

请求方式： POST

请求内容类型： application/json

响应内容类型： application/json

请求说明

请求体

字段名	参数名	类型	是否必填	描述
pageNumber	页号	int	M	页号，应为正整数
pageSize	页面容量	int	M	页面容量，大于0且小于等于1000，超过1000时按1000处理
startTime	起始时间	String	M	起始时间，格式yyyy-MM-dd HH:mm:ss
endTime	结束时间	String	M	结束时间，应大于起始时间，格式yyyy-MM-dd HH:mm:ss

请求示例

{
    "pageNumber":1,
    "pageSize":10,
    "startTime":"2022-07-01 23:59:59",
    "endTime":"2022-07-05 23:59:59"
}

响应说明

响应体

字段名	参数名	类型	描述
errcode	返回码	String	返回码
errmsg	返回码描述	String	返回码描述
nextPage	下一页页码	int	下一页的页码，不存在下一页时该字段返回null
totalLogs	总条数	int	所有符合查询条件的日志总条数
logs	日志信息列表	List<V2UserLoginLogInfo>	单条日志信息的集合，具体日志信息结构见下表

V2UserLoginLogInfo

字段名	参数名	类型	描述
wid	业务主键	String	业务主键
userName	用户名	String	用户名
userId	学工号	String	学工号
ip	ip地址	String	发起请求的ip地址
loginTime	登录时间	String	用户认证登录的时间
logoutTime	登出时间	String	用户认证登出的时间
loginType	登录方式	String	本次登录用户采用的登录方式类型
loginLocation	登录地点	String	本次登录发生的地点，可能的取值为校内、校外或null
clientType	登录客户端类型	String	本次登录的客户端类型，可能为pc端或移动端
result	登录认证结果	String	本次登录的结果，成功或失败

响应示例

{
    "logs": [
        {
            "wid": "91E89C53CD6E44E38FE57B7DA9091179",
            "userName": "超级管理员",
            "userId": "ampadmin",
            "ip": "172.31.24.20",
            "loginTime": "2022-07-05 20:22:34",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "成功"
        },
        {
            "wid": "6A2D9944543E4A929307A926AB1ABDAE",
            "userName": null,
            "userId": "ampadmin",
            "ip": "172.31.36.185",
            "loginTime": "2022-07-05 18:54:22",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "成功"
        },
        {
            "wid": "6775F9FCB9E042B787F99525267003D6",
            "userName": "wk",
            "userId": "01119253",
            "ip": "172.31.24.116",
            "loginTime": "2022-07-05 17:09:41",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "成功"
        },
        {
            "wid": "62A2963B286D43DAA21CC3308A90141C",
            "userName": "超级管理员",
            "userId": "ampadmin",
            "ip": "172.31.24.152",
            "loginTime": "2022-07-05 17:09:36",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "成功"
        },
        {
            "wid": "09698BBCF31E4AB78DB0C024C1815067",
            "userName": "wk",
            "userId": "01119253",
            "ip": "172.31.24.116",
            "loginTime": "2022-07-05 17:09:01",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "移动端",
            "result": "成功"
        },
        {
            "wid": "17347222BDE4477C88342511504BB408",
            "userName": "wk",
            "userId": "01119253",
            "ip": "172.31.24.116",
            "loginTime": "2022-07-05 17:01:55",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "成功"
        },
        {
            "wid": "A74C9888DCB5499483DD46995AB5ECBB",
            "userName": "act",
            "userId": "testAct",
            "ip": "221.226.41.179",
            "loginTime": "2022-07-05 16:55:39",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "失败"
        },
        {
            "wid": "5B15AE4BDCF74D70B43E499480B13F7B",
            "userName": "hjj",
            "userId": "sysadmin",
            "ip": "172.31.24.104",
            "loginTime": "2022-07-04 13:57:30",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "失败"
        },
        {
            "wid": "C6CF28A99C494333822D822A9E92B7D8",
            "userName": "hjj",
            "userId": "sysadmin",
            "ip": "172.31.24.104",
            "loginTime": "2022-07-04 13:57:24",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "失败"
        },
        {
            "wid": "520928D7A30E48EFA14793AEFAD2EBA7",
            "userName": "gy",
            "userId": "guoyuan",
            "ip": "172.31.24.104",
            "loginTime": "2022-07-04 13:39:27",
            "logoutTime": "",
            "loginType": "帐号密码登录",
            "loginLocation": null,
            "clientType": "pc端",
            "result": "失败"
        }
    ],
    "nextPage": 2,
    "totalLogs": 16,
    "errcode": null,
    "errmsg": null,
    "traceId": null
}

错误码

错误码	描述
221015	查询起始时间应小于结束时间
221016	时间参数格式异常
221017	缺少必填参数
221018	分页参数非法
225002	接口内部执行异常

Demo

java

// 创建客户端
Client client = new DefaultClient(BASE_URL, APP_ID, APP_SECRET);
// 创建请求对象
QueryUserLoginLogRequest request = new QueryUserLoginLogRequest();
request.setPageSize(10);
request.setPageNumber(1);
request.setStartTime("2022-07-20 12:00:00");
request.setEndTime("2025-07-25 12:00:00");

QueryUserLoginLogResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.getLogs() != null && !response.getLogs().isEmpty()) {
	//.....
}