访问日志接口

保存访问日志

接口地址：http://{IP}:{PORT}/server-log/services/rest/v1/accessLog/save

请求方法：POST

Content-Type: application/json

描述: 保存访问日志

Body-parameters:

参数名	参数类型	是否必须	描述	引入版本	示例
tenantId	string	true	租户id	-
personId	string	true	人员id	-
userHostIp	string	true	用户ip	-
logTime	string	true	日志记录时间	-
systemName	string	true	系统名称	-
modularName	string	true	模块名称，比如：公文就转-发文-授权管理	-
elapsedTime	int64	true	用时（毫秒）	-
operateName	string	true	操作名称	-
success	string	true	操作状态：成功、出错	-
requestUrl	string	false	访问路径	-
operateType	string	false	操作类别： 查看，增加，修改，删除，发送，活动，登录，退出，检查，导出，导入，下载，上传 ……	-
methodName	string	false	方法类和名称	-
paramsJson	string	false	参数	-
logLevel	string	false	日志级别： 普通日志、管理日志、错误日志、警告日志、信息日志、调试日志、跟踪日志	-
serverIp	string	false	服务器ip	-
errorMessage	string	false	错误信息	-
logMessage	string	false	日志信息	-
throwable	string	false	异常信息	-
userAgent	string	false	浏览器信息	-
macAddress	string	false	mac地址	-

Request-example:

curl -X POST -k -H "Content-Type: application/json" -i 'http://{IP}:{PORT}/server-log/services/rest/v1/accessLog/asyncSaveLog' --data '{
  "tenantId": "1600827872962940928",
  "personId": "1600827919817510912",
  "userHostIp": "192.168.3.33",
  "logTime": "2026-06-17 15:17:16",
  "systemName": "testSystem1",
  "modularName": "用户模块",
  "operateName": "获取用户详情",
  "elapsedTime": 100,
  "success": "成功"
}'

Response-fields:

字段	类型	描述	引入版本	示例
success	boolean	操作是否成功	-	true
code	int32	错误代码	-	0
msg	string	操作描述	-
data	object	操作成功返回的数据	-
└─any object	object	any object.	-

响应示例:

{
  "success": true,
  "code": 0,
  "msg": "操作成功",
  "data": null
}

多条件分页查询访问日志

接口地址: https://demo.youshengyun.com/server-log/services/rest/v1/accessLog/search

请求方法: GET

Content-Type: application/x-www-form-urlencoded

描述: 多条件分页查询访问日志

查询参数:

参数名	参数类型	是否必须	描述	引入版本	示例
size	int32	true	每页的条数	-
page	int32	true	页数	-
userName	string	false	用户名称	-
userHostIp	string	false	客户端IP	-
success	string	false	操作状态	-
startTime	string	false	开始时间	-
endTime	string	false	结束时间	-
modularName	string	false	模块名称	-
operateName	string	false	操作名称	-
operateType	string	false	操作类型	-
logLevel	string	false	日志级别	-

Request-example:

curl -X GET -k -i 'http://{IP}:{PORT}/server-log/services/rest/v1/accessLog/search?systemName=testSystem&page=0&size=10'

响应字段:

字段	类型	描述	引入版本	示例
currPage	int32	当前页	-	0
totalPages	int32	总页数	-	0
total	int64	总条数	-	0
rows	array	数据项	-
└─id	string	唯一标识	-
└─logTime	string	日志记录时间	-	" 2025-12-09 10:09:47"
└─systemName	string	系统名称	-
└─modularName	string	模块名称，比如：公文就转-发文-授权管理	-
└─methodName	string	方法类和名称	-
└─logLevel	string	日志级别： 普通日志、管理日志、错误日志、警告日志、信息日志、调试日志、跟踪日志	-
└─operateType	string	操作类别： 查看，增加，修改，删除，发送，活动，登录，退出，检查	-
└─operateName	string	操作名称	-
└─elapsedTime	int64	用时	-	0
└─serverIp	string	服务器ip	-
└─success	string	是否成功	-
└─requestUrl	string	访问路径	-
└─errorMessage	string	错误信息	-
└─logMessage	string	日志信息	-
└─throwable	string	异常信息	-
└─userHostIp	string	用户ip	-
└─userAgent	string	浏览器信息	-
└─macAddress	string	mac地址	-
└─tenantId	string	租户id	-
└─tenantName	string	租户名称	-
└─userId	string	用户id	-
└─userName	string	用户名称	-
└─loginName	string	登录名称	-
└─dn	string	用户的承继关系	-
└─guidPath	string	用户的由ID组成的父子关系列表，之间用逗号分隔	-
└─managerLevel	int32	三员级别：0：一般用户，1：系统管理员，2：安全保密员，3：安全审计员，4：云系统管理员，5：云安全保密员，6：云安全审计员	-	0
code	int64	错误代码	-	0
msg	string	调用信息	-
success	boolean	操作是否成功	-	true

响应示例:

{
  "currPage": 0,
  "totalPages": 1,
  "total": 1,
  "rows": [
    {
      "id": "1956762893339279360",
      "logTime": "2026-06-17 15:17:16",
      "systemName": "testSystem1",
      "modularName": "用户模块",
      "methodName": null,
      "paramsJson": null,
      "logLevel": null,
      "operateType": null,
      "operateName": "获取用户详情",
      "elapsedTime": 100,
      "serverIp": null,
      "success": "成功",
      "requestUrl": null,
      "errorMessage": null,
      "logMessage": null,
      "throwable": null,
      "userHostIp": "192.168.3.33",
      "userAgent": null,
      "macAddress": null,
      "tenantId": "1600827872962940928",
      "tenantName": "演示租户",
      "userId": "1600827919817510912",
      "userName": "系统管理员",
      "loginName": "systemManager",
      "dn": "cn=系统管理员,o=虚拟组织",
      "guidPath": "1600827919490355200,1600827919817510912",
      "managerLevel": 1
    }
  ],
  "code": 0,
  "msg": "操作成功",
  "success": true
}