活动日志

6 endpoints.

删除选中的活动记录

DELETEhttp://localhost:3000/api/activity

按 ID 批量删除。仅限会话调用——任何角色的 API 令牌都会被拒绝，因此令牌无法抹掉自己的审计记录。

请求体

application/json

响应

200移除了多少条记录。

null

服务器地址

该端点只接受网页会话（登录本站所用实例后浏览器自动携带的 cookie）。API 令牌会被服务端拒绝，因此这里不提供令牌输入框，上面的命令行也不带 Authorization 头。

填写你自己的实例地址，请求由浏览器直接发往该地址。

列出活动记录

GEThttp://localhost:3000/api/activity

一页活动记录，最新的在前，范围限定为调用者有权看到的内容（见本文件头部的说明）。

目标为某个档案的记录会附带该档案是否仍然存在的标注，这样客户端可以显示「此后已被删除」，而不是一个死链接。

查询参数

cursorstring可选: 来自上一次响应 next_cursor 的不透明分页游标。
limitinteger · min: 1 · max: 200 · default: 50可选: 无论请求多少都会被夹到一个小固定范围内——不设上限的话，单个请求就能强制触发任意大的扫描。
start_tsinteger可选: 只返回该 Unix 秒级时间戳（含）之后的活动记录。
end_tsinteger可选: 只返回该 Unix 秒级时间戳（含）之前的活动记录。
actorstring可选: 逗号分隔的操作者键；多个值是「或」的关系。
action_typestring可选: 逗号分隔的操作类型；多个值是「或」的关系。
outcomestring可选: 逗号分隔的结果；多个值是「或」的关系。

响应

200一页记录。

{
  "entries": [
    {}
  ],
  "next_cursor": "",
  "total_estimate": 0
}

服务器地址API 令牌

cursorquerylimitquerystart_tsqueryend_tsqueryactorqueryaction_typequeryoutcomequery

填写你自己的实例地址，请求由浏览器直接发往该地址。

删除单条活动记录

DELETEhttp://localhost:3000/api/activity/{id}

按 ID 删除单条记录。仅限会话调用，原因与批量删除相同。

路径参数

idstring必填

响应

200已删除。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

404没有该 ID 的记录。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

服务器地址

idpath

填写你自己的实例地址，请求由浏览器直接发往该地址。

列出活动记录的筛选项

GEThttp://localhost:3000/api/activity/facets

日志中出现过的操作类型与操作者，各自带计数——这样客户端可以按「实际存在的内容」来构建筛选界面，而不是按一份写死的列表。

与列表端点一样，范围限定为调用者可见的内容：只有当调用者有权读取某操作者的记录时，该操作者才会出现。

响应

200可用的分面。

{
  "action_types": [
    {}
  ],
  "actors": [
    {}
  ]
}

服务器地址API 令牌

填写你自己的实例地址，请求由浏览器直接发往该地址。

读取活动记录的保留窗口

GEThttp://localhost:3000/api/activity/retention

活动记录保留多久，单位为秒。

响应

200当前时间窗口。

{
  "retention_secs": 0
}

服务器地址API 令牌

填写你自己的实例地址，请求由浏览器直接发往该地址。

设置活动记录的保留窗口

PUThttp://localhost:3000/api/activity/retention

修改活动记录的保留时长。仅限会话调用：令牌不能缩短自己留下的痕迹能存活多久。

请求体

application/json

响应

200已保存。

{
  "error": "",
  "operation": "",
  "success": 0,
  "successMessage": ""
}

服务器地址

填写你自己的实例地址，请求由浏览器直接发往该地址。