用户操作日志查询

接口说明

请求URL：http[s]://{网关地址}/minos-manager/userOptLog/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<V2UserOptLogInfo>	单条日志信息的集合，具体日志信息结构见下表

V2UserOptLogInfo

字段名	参数名	类型	描述
wid	业务主键	String	业务主键
userName	用户名	String	用户名
userId	学工号	String	学工号
ip	ip地址	String	发起请求的ip地址
optTime	操作时间	String	操作发起的时间
optType	操作类型	String	具体操作类型
result	操作结果	String	操作结果，成功或失败

响应示例

{
    "logs": [
        {
            "wid": "2f8c93ca508a4812a05f6f554280b2f3",
            "userName": "act",
            "userId": "testAct",
            "ip": "172.16.6.4",
            "optTime": "2022-07-05 16:56:26",
            "optType": "自助修改密码",
            "result": "成功"
        },
        {
            "wid": "4b36b40c97664d30b427aca39ab9e7f1",
            "userName": "act",
            "userId": "testAct",
            "ip": "221.226.41.179",
            "optTime": "2022-07-05 16:56:00",
            "optType": "自助编辑帐号-设置常用帐号",
            "result": "成功"
        },
        {
            "wid": "0c08ba3f56c64d0d8be94ed906a5f5be",
            "userName": "wk",
            "userId": "01119253",
            "ip": "49.93.95.29",
            "optTime": "2022-07-04 14:46:28",
            "optType": "自助编辑帐号-设置常用帐号",
            "result": "失败"
        },
        {
            "wid": "38f4df8cb8cb46639b2d387d5a2d4553",
            "userName": "wk",
            "userId": "01119253",
            "ip": "49.93.95.29",
            "optTime": "2022-07-04 14:46:13",
            "optType": "自助编辑帐号-设置常用帐号",
            "result": "失败"
        },
        {
            "wid": "2e3d1e1cde8647598b848da8f2803817",
            "userName": "wk",
            "userId": "01119253",
            "ip": "49.93.95.29",
            "optTime": "2022-07-04 13:59:46",
            "optType": "自助编辑帐号-设置常用帐号",
            "result": "失败"
        },
        {
            "wid": "2ca6c2fb1bfa4197a778c7a8c0677caa",
            "userName": "gy",
            "userId": "guoyuan",
            "ip": "172.31.24.104",
            "optTime": "2022-07-04 13:36:22",
            "optType": "自助修改密码",
            "result": "成功"
        },
        {
            "wid": "b64c1fa2acf044cc9e94f7c4b40d1a22",
            "userName": "gy",
            "userId": "guoyuan",
            "ip": "172.31.24.104",
            "optTime": "2022-07-04 13:35:55",
            "optType": "自助编辑帐号-绑定手机",
            "result": "成功"
        },
        {
            "wid": "cbfff1de96e743d2ba213317e2123a60",
            "userName": "gy",
            "userId": "guoyuan",
            "ip": "172.31.24.116",
            "optTime": "2022-07-04 13:34:02",
            "optType": "自助编辑帐号-设置常用帐号",
            "result": "成功"
        }
    ],
    "nextPage": null,
    "totalLogs": 8,
    "errcode": null,
    "errmsg": null,
    "traceId": null
}

错误码

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

Demo

java

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

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