跳到主要内容

operation_log_list 获取操作日志列表

POST /api/v1/system/operation_log_list​

描述​

获取操作日志列表，用于操作审计。该接口按照操作日志从新到旧进行排序。 优于操作日志中携带了请求参数信息，单条记录日志记录长度较大，查询全部数据可能超出CGI响应缓存容量，因此该接口需要分页查询。 建议每页数据条数不要超过40条。

访问权限​

需要登录，具备以下权限：

system:operation_log_list

请求参数​

请求参数如下：

{
  "skip": 0,
  "limit": 0
}
提示
  • skip: 跳过的数据条数。
  • limit: 返回的数据条数，当设为0时返回剩余的全部数据。

示例：

{
  "skip": 0,
  "limit": 20
}

响应结果​

请求返回的HTTP状态码为200

返回结果为JSON格式的数据，您可以通过解析JSON数据来获取API调用的结果信息。结构如下：

{
  "success": true|false,
  "data": {
    "list": [
      {
        "trace_id": number,
        "username": string,
        "user_type": "root"|"admin"|"guest",
        "request_method": string,
        "request_params": string,
        "user_agent": "broswer",
        "begin_time": number,
        "end_time": number,
        "f_duration": number,
        "result_code": 200|500,
        "result_msg": string
      },
      ...
    ],
    "total": number
  },
  "errorCode"?: "option string",
  "errorMessage"?: "option string",
  "showType"?: 0|1|2|4|9,
  "traceId"?: "option string"
}
提示
  • list: 日志列表。
    • trace_id: 链路id。
    • username: 用户名。
    • user_type: 用户类型。
    • request_method: 请求方法。
    • request_params: 请求参数。
    • user_agent: 用户终端类型。
    • begin_time: 请求开始时间，单位为毫秒。
    • end_time: 请求结束时间，单位为毫秒。
    • f_duration: 请求耗时，单位为毫秒。
    • result_code: 响应状态码，200表示成功，500表示失败。
    • result_msg: 响应信息。
  • total: 日志条数。

正确结果示例：

{
  "success": true,
  "data": {
    "list": [
      {
        "trace_id": 1,
        "username": "admin",
        "user_type": "admin",
        "request_method": "v1_clock_save_time_sources",
        "request_params": "{\"frequencySelectionMethod\":\"priority\",\"timeSourceSelectionMethod\":\"priority\",\"ssmE1_2m\":0,\"ssmE1_E1\":0,\"ssmE1_ssmPosition\":\"sa4\",\"ssmInner10m\":4,\"ssmThreshold\":4,\"timeSourcePriority\":[\"GNSS1\", \"GNSS2\", \"PPS_TOD\", \"PTP1\", \"PTP2\", \"PTP3\", \"PTP4\", \"Local\"],\"timeSourceSelected\":\"Local\",\"frequencyPriority\":[\"GNSS1\", \"GNSS2\", \"PPS_TOD\", \"SyncE1\", \"SyncE2\", \"SyncE3\", \"SyncE4\", \"E1_2Mb\", \"E1_2M\", \"inner10MHz\"],\"frequencySelected\":\"inner10MHz\"}",
        "user_agent": "broswer",
        "begin_time": 1756350677215,
        "end_time": 1756350677257,
        "f_duration": 42,
        "result_code": 200,
        "result_msg": "{\"success\":true}"
      },
      {
        "trace_id": 1,
        "username": "admin",
        "user_type": "admin",
        "request_method": "v1_clock_save_time_sources",
        "request_params": "{\"frequencySelectionMethod\":\"priority\",\"timeSourceSelectionMethod\":\"priority\",\"ssmE1_2m\":0,\"ssmE1_E1\":0,\"ssmE1_ssmPosition\":\"sa4\",\"ssmInner10m\":4,\"ssmThreshold\":4,\"timeSourcePriority\":[\"GNSS2\", \"GNSS1\", \"PPS_TOD\", \"PTP1\", \"PTP2\", \"PTP3\", \"PTP4\", \"Local\"],\"timeSourceSelected\":\"Local\",\"frequencyPriority\":[\"GNSS2\", \"GNSS1\", \"PPS_TOD\", \"SyncE1\", \"SyncE2\", \"SyncE3\", \"SyncE4\", \"E1_2Mb\", \"E1_2M\", \"inner10MHz\"],\"frequencySelected\":\"inner10MHz\"}",
        "user_agent": "broswer",
        "begin_time": 1756350627397,
        "end_time": 1756350627625,
        "f_duration": 228,
        "result_code": 200,
        "result_msg": "{\"success\":true}"
      },
      ...
    ],
    "total": 11
  }
}

错误结果示例, 返回false时候需要带上错误码和错误信息：
```json
{
  "success": false,
  "errorCode": "40000",
  "errorMessage": "no.blank.params",
}

错误码​

错误码说明错误信息显示类型
40007缺少请求参数error.request.format4
40007缺少skip参数或格式错误skip.must.be.integer4
40007skip参数值必须大于等于0skip.must.be.greater.or.equal.zero4
40007缺少limit参数或格式错误limit.must.be.integer4
40007limit参数值必须大于等于0limit.must.be.greater.or.equal.zero4
40007服务器处理异常error.server4
提示

4 表示弹框提示错误信息。