Skip to main content
GET
查询审计日志
本接口要求 Admin Key 具备 audit:read 作用域。审计日志按组织开关启用:组织管理员在「控制台 → 组织管理 → Admin Key 管理 → 审计日志卡片」开启。未开启时本接口返回空列表(与「没有事件」同形,无法区分)。开启后事件自开启时点起可查:开启前不回溯,关闭期间的空白不可恢复。每次调用本接口自身也会记录一条 audit_log.read 审计事件。

授权

Authorization
string
header
必填

Authorization 请求头携带 Admin API secret 作为 Bearer 令牌,格式为 Bearer sk-admin-***。Admin Key 可在「控制台 → 组织管理 → Admin API Keys」创建。

查询参数

start
integer<int64>
必填

起始时间(epoch 毫秒),含边界。例如 1790784000000(2026-10-01 00:00 CST)。

必填范围: x >= 0
end
integer<int64>
必填

结束时间(epoch 毫秒),不含边界。例如 1792598400000(2026-10-22 00:00 CST)。

必填范围: x >= 0
event_types
enum<string>[]

事件类型过滤。只返回 event_type 属于本列表的事件。支持重复传参(event_types=a&event_types=b)或逗号拼接(event_types=a,b)。

审计事件类型。枚举值可能随版本新增。

可用选项:
api_key.created,
api_key.updated,
api_key.deleted,
admin_api_key.created,
admin_api_key.updated,
admin_api_key.deleted,
organization.member_invited,
organization.member_joined,
organization.member_role_updated,
organization.member_removed,
organization.ip_whitelist_updated,
organization.audit_log_enabled,
organization.audit_log_disabled,
project.created,
project.updated,
project.archived,
project.member_added,
project.member_role_updated,
project.member_removed,
project.spend_limit_updated,
project.rate_limit_updated,
audit_log.read,
auth.login_succeeded,
auth.login_failed
actor_id
string

操作者 ID 过滤(uid 或 Admin Key ID)。

actor_type
enum<string>

操作者类型过滤。

可用选项:
user,
api_key
target_type
enum<string>

对象类型过滤。 审计事件对象类型。

可用选项:
api_key,
admin_api_key,
member,
project,
invite,
ip_whitelist,
user,
organization,
audit_log
target_id
string

对象 ID 过滤。

result
enum<string>

结果过滤。

可用选项:
success,
failed
limit
integer
默认值:20

页大小。默认 20,最大 100。

必填范围: 1 <= x <= 100
cursor
string

上一次响应 next 字段返回的游标。游标只携带页位置;每次翻页都需原样重复全部查询参数(limit 除外),服务端不校验参数一致性。

响应

审计事件列表,按事件时间倒序。

data
object[]
必填

审计事件列表。

has_more
boolean
必填

是否还有下一页。

next
string | null
必填

下一页游标。翻页时将其原样作为 cursor 参数传回。