操作日志

管理端操作日志的查询与清理，查询本身不会产生新日志。

操作日志分页列表

接口地址

GET /admin/log/operation/list

接口说明

记录方法、路由、参数、响应、IP、UA、耗时与操作人；敏感字段（password/token/secret/*_key）已脱敏。

接口参数说明

Query 参数	类型	必填	说明
username	string	否	操作账号
start_time	string	否	开始时间，如 2026-09-01 00:00:00
end_time	string	否	结束时间，如 2026-09-30 23:59:59
page	integer	否	页码，默认 1
page_size	integer	否	每页数量，默认 20，最大 100

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [
      {
        "id": 0,
        "created_at": "2026-09-25T10:00:00+08:00",
        "updated_at": "2026-09-25T10:00:00+08:00",
        "user_id": 0,
        "username": "",
        "method": "POST",
        "path": "/admin/user/add",
        "request_params": "",
        "response_params": "",
        "ip": "",
        "user_agent": "",
        "code": 0,
        "cost_ms": 0,
        "client": ""
      }
    ],
    "total": 0
  }
}

响应参数说明

响应字段	类型	说明
list	array<OperationLogItem>
list[].id	integer	主键ID
list[].created_at	string	操作时间
list[].updated_at	string	更新时间
list[].user_id	integer	操作人ID
list[].username	string	操作账号
list[].method	string	请求方法
list[].path	string	请求路由（ Gin 路由模板）
list[].request_params	string	请求参数（敏感字段已脱敏）
list[].response_params	string	响应内容
list[].ip	string	客户端IP
list[].user_agent	string	用户代理
list[].code	integer	业务响应码
list[].cost_ms	integer	耗时（毫秒）
list[].client	string	客户端类型 admin/api
total	integer	数据总数

删除操作日志

接口地址

POST /admin/log/operation/delete

接口说明

支持按 ID 列表删除。

接口参数说明

Body 参数	类型	必填	说明
ids	array<integer>	是	日志ID列表

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明

成功时 data 为 null。

清空操作日志

接口地址

POST /admin/log/operation/clear

接口说明

清空全部操作日志，不可恢复，执行前请确认。

接口参数说明

无请求参数。

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "code": 0,
    "msg": "success",
    "data": null
  }
}

响应参数说明

成功时 data 为 null。