API 参考 / admin

跨组织审计查询（平台超管）

GET /api/v1/admin/audit-logs · adminListAuditLogs

跨组织 / 项目审计日志分页查询，可按操作人邮箱、组织名称、项目名称，或兼容的内部 ID， 动作（action）、时间范围（from~to，RFC3339）过滤。时间倒序。只读控制面库。要求平台超管。

本接口要求浏览器会话。Bearer API Token 无法调用——Token 的生命周期管理必须在网页端完成。

参数

actorUserId
string —— 按操作人用户 id 精确过滤。
actorQuery
string —— 按操作人邮箱模糊过滤。
orgId
string —— 按组织 id 精确过滤。
orgQuery
string —— 按组织名称模糊过滤。
projectId
string —— 按项目 id 精确过滤。
projectQuery
string —— 按项目名称模糊过滤。
action
string —— 按动作模糊过滤（ILIKE，服务端参数化 + 通配转义）。
from
string —— 起始时间（含，RFC3339）。
to
string —— 截止时间（含，RFC3339）。
page
integer —— 页码（1 起）；缺省或非法为 1。平台运营面分页统一 page + pageSize。
pageSize
integer —— 每页条数，默认 20，上限 100。平台运营面分页统一 page + pageSize。

响应字段 · 200

items（必填）
AdminAuditLogEntry[]
items[].id（必填）
string
items[].actorUserId（必填）
string
items[].actorEmail（必填）
string
items[].actorName
string
items[].orgId
string
items[].orgName
string
items[].projectId
string
items[].projectName
string
items[].action（必填）
string
items[].targetType（必填）
string
items[].targetId（必填）
string
items[].targetLabel
string —— 可解析时返回对象可读名称（用户邮箱、组织名、项目名、邀请邮箱）；否则为空。
items[].metadata（必填）
object
items[].createdAt（必填）
string
page（必填）
integer
pageSize（必填）
integer
total（必填）
integer

错误

请求示例（curl）

curl -X GET "https://你的项目.workflow.games/api/v1/admin/audit-logs?actorUserId=…&actorQuery=…" \
  -H "Authorization: Bearer wfp_…"

响应示例

HTTP/1.1 200
{
  "items": [
    {
      "id": "018f3c2e-0000-7000-8000-000000000000",
      "actorUserId": "018f3c2e-0000-7000-8000-000000000000",
      "actorEmail": "[email protected]",
      "action": "示例文本",
      "targetType": "示例文本",
      "targetId": "018f3c2e-0000-7000-8000-000000000000",
      "metadata": {},
      "createdAt": "示例文本"
    }
  ],
  "page": 1,
  "pageSize": 1,
  "total": 1
}

合同真值：OpenAPI 3.1（0.1.0）。

相关：Agent 接入指南 · 使用指南 · API 参考索引

Workflow 正在加载…