管理员操作日志查询

接口说明

请求URL：http[s]://{网关地址}/log/v2/queryAdminOptLogs

请求方式： 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":3,
    "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<V2LogInfo>	单条日志信息的集合，具体日志信息结构见下表

V2LogInfo

字段名	参数名	类型	描述
wid	业务主键	String	业务主键
userName	用户名	String	用户名
userId	学工号	String	学工号
userIp	IP地址	String	请求发起的IP地址
optContent	操作内容	String	管理员操作的内容
optObjs	操作对象	String	管理员操作的对象
optType	操作类型	String	管理员操作的类型，可能为新增、删除、修改或其他
createTime	操作日志记录时间	String	管理员操作日志记录时间
result	操作结果	String	管理员操作结果，取值可能为成功或者失败

响应示例

{
    "errcode": "0",
    "errmsg": "success",
    "traceId": null,
    "nextPage": 2,
    "totalLogs": 152,
    "logs": [
        {
            "wid": "993960947687559168",
            "userId": "sysadmin",
            "userName": "超级管理员",
            "userIp": "172.31.24.116",
            "optContent": "用户关联用户组",
            "createTime": "2022-07-05 19:26:08",
            "optObjs": "cc12234(cc123)",
            "result": "成功",
            "optType": "修改"
        },
        {
            "wid": "993960857136730112",
            "userId": "sysadmin",
            "userName": "超级管理员",
            "userIp": "172.31.24.116",
            "optContent": "创建用户组",
            "createTime": "2022-07-05 19:25:38",
            "optObjs": "【测试用户组】",
            "result": "成功",
            "optType": "新增"
        },
        {
            "wid": "993952640490999808",
            "userId": "sysadmin",
            "userName": "超级管理员",
            "userIp": "172.31.28.233",
            "optContent": "编辑用户信息",
            "createTime": "2022-07-05 18:53:08",
            "optObjs": "act(testAct)",
            "result": "失败",
            "optType": "修改"
        }
    ]
}

错误码

错误码	描述
121001	缺少必填参数
121002	查询起始时间应小于结束时间
121003	时间参数格式异常
121004	分页参数非法

Demo

java

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

BaseResponse response = client.execute(request);
//调用成功，则处理业务逻辑
if (response.isSuccess()) {
	//.....
}