- 更新 changelog.md: v0.2.0 记录 M2-M8 全部完成,路线图更新 - 新增 5 篇指南: RBAC、组织管理、审计日志、通知模块、质量横切 - 新增 5 篇 API 文档: RBAC(11)、Org(5)、Audit(1)、Settings(7)、Notification(7) - 更新 api/overview.md: 完整 37 端点列表 - 更新 config.ts: 侧边栏分组 + 11 页 SEO 元数据
1.4 KiB
1.4 KiB
| title |
|---|
| 审计日志 API | 操作审计查询接口 - MengStack官方文档 |
审计日志接口
所有接口需要认证,并携带 X-Tenant-ID 头。
查询审计日志
GET /api/v1/audit/logs
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
user_id |
int | 否 | 按操作人 ID 筛选 |
action |
string | 否 | 按操作类型筛选(create / update / delete / login / assign) |
resource |
string | 否 | 按资源类型筛选(user / role / tenant / setting / auth) |
page |
int | 否 | 页码,默认 1 |
page_size |
int | 否 | 每页条数,默认 20 |
响应
{
"code": 0,
"data": {
"items": [
{
"id": 1,
"tenant_id": "550e8400-...",
"user_id": 1,
"action": "create",
"resource": "role",
"resource_id": "5",
"detail": "{\"name\":\"editor\"}",
"ip": "192.168.1.100",
"created_at": "2026-10-03T10:00:00+08:00"
}
],
"total": 42,
"page": 1
}
}
示例
# 查询所有删除操作
curl "http://localhost:2222/api/v1/audit/logs?action=delete" \
-H "Authorization: Bearer <token>" \
-H "X-Tenant-ID: <tenant_id>"
# 查询指定用户的日志
curl "http://localhost:2222/api/v1/audit/logs?user_id=1&page_size=10" \
-H "Authorization: Bearer <token>" \
-H "X-Tenant-ID: <tenant_id>"