获取审计日志明细接口

1. 简介

1.1 接口简介

按范围查询当前企业的审计日志明细。

1.2 版本说明

本功能为付费高级功能，简道云旗舰版、独享版可用，其他版本请联系销售增购。详情参见：官网定价。

1.3 接口版本

接口版本	更新时间	版本说明
v1	2026.05.28	原始接口

2. 接口调用

请求地址：https://api.jiandaoyun.com/api/v1/audit_log/list

请求频率：30 次/秒

请求方式：POST

请求参数：

参数	类型	必需	说明
domain	String	是	日志范围。
time_range.start	String	是	查询开始时间，UTC 时间格式示例：2026-04-01T00:00:00.000Z
time_range.end	String	是	查询结束时间，UTC 时间格式示例：2026-04-13T23:59:59.000Z
event_types	String[]	否	事件类型列表。不传表示查询当前日志范围（domain）支持的全部事件类型（event_types）
limit	Number	否	单次返回条数，默认 200，最大 200
cursor	String	否	分页游标首次查询不传；下一页使用上次响应的 cursor
filters	Object	否	过滤条件，取值见【3. 过滤条件】

注：

1）time_range 的跨度不能超过 31 天。

2）一次请求只能查询一个日志范围（ domain）。

3）传入当前日志范围（domain）不支持的 filters 字段会返回参数错误。

4）分页按事件时间倒序。

请求示例：

//查询登录日志
{
  "domain": "login",
  "time_range": {
    "start": "2026-04-01T00:00:00.000Z",
    "end": "2026-04-13T23:59:59.000Z"
  },
  "event_types": [
    "auth.session.login"
  ],
  "filters": {
    "actor_ids": [
      "660000000000000000000010",
      "660000000000000000000011"
    ]
  },
  "limit": 100,
  "cursor": ""
}

//查询平台管理日志
{
  "domain": "platform",
  "time_range": {
    "start": "2026-04-01T00:00:00.000Z",
    "end": "2026-04-13T23:59:59.000Z"
  },
  "event_types": [
    "admin.member.invite",
    "admin.member.remove",
    "admin.dept.create",
    "api.key.create"
  ],
  "filters": {
    "actor_ids": [
      "660000000000000000000020",
      "660000000000000000000021"
    ]
  },
  "limit": 100,
  "cursor": ""
}

//查询应用搭建日志
{
  "domain": "app_builder",
  "time_range": {
    "start": "2026-04-01T00:00:00.000Z",
    "end": "2026-04-13T23:59:59.000Z"
  },
  "event_types": [
    "data.record.create",
    "data.record.update",
    "data.record.batch_update",
    "data.record.delete",
    "data.record.import",
    "data.record.export",
    "admin.form.update",
    "admin.dash.export"
  ],
  "filters": {
    "actor_ids": [
      "660000000000000000000030",
      "660000000000000000000031"
    ],
    "app_ids": [
      "59264073a2a60c0c08e20bfb"
    ],
    "entry_ids": [
      "59264073a2a60c0c08e20bfd"
    ]
  },
  "limit": 100,
  "cursor": ""
}

//查询知识库日志
{
  "domain": "kms",
  "time_range": {
    "start": "2026-04-01T00:00:00.000Z",
    "end": "2026-04-13T23:59:59.000Z"
  },
  "event_types": [
    "admin.kms.enable",
    "admin.kms.space_create",
    "admin.kms.space_update",
    "admin.kms.perm_group_update"
  ],
  "filters": {
    "actor_ids": [
      "660000000000000000000040",
      "660000000000000000000041"
    ]
  },
  "limit": 100,
  "cursor": ""
}

响应参数：

参数	含义
has_more	是否有下一页
cursor	下一页游标 has_more 为 true 时返回
items	审计日志列表
items[].event_id	事件 ID
items[].event_time	事件发生时间，UTC 时间字符串
items[].event_type	标准事件类型
items[].domain	审计日志范围
items[].tenant	企业的租户 ID
items[].actor	操作人信息 type：操作人类型，一般为 user id：操作人 ID name：操作人名称 ip：操作客户端i p 地址 user_agent：客户端用户代理信息 geo：地理位置，仅在日志范围是 login 时有值
items[].event	事件属性 category：事件分类 action：执行动作 outcome：执行结果 severity：严重等级
items[].resource	被操作资源信息 type：被操作资源类型 id：被操作资源 id name：被操作资源名称 parent_id：被操作资源所属父资源 id parent_type：被操作所属父资源类型
items[].detail	事件详情

响应示例：

{
  "has_more": true,
  "cursor": "MTc3NjE1OTAwMDAwMCw2NjExMjIzMzQ0NTU2Njc3ODg5OWFhYmI=",
  "items": [
    {
      "event_id": "681f2de2-9722-34ca-bd2a-dda99b615e46",
      "event_time": "2026-05-11T09:09:38.792Z",
      "event_type": "data.record.print",
      "domain": "app_builder",
      "tenant": {
        "id": "68665cf9f8acef49b8e29917"
      },
      "actor": {
        "type": "user",
        "id": "68665cf9f8acef49b8e29917",
        "name": "z3",
        "ip": "172.24.72.2",
        "user_agent": "Mozilla/5.0",
        "geo": null
      },
      "event": {
        "category": "data",
        "action": "print",
        "outcome": "success",
        "severity": "info"
      },
      "resource": {
        "type": "form",
        "id": "689d59d8d241955ee4908625",
        "name": "车辆信息基础表",
        "parent_id": "68994cb727cc65376feb985d",
        "parent_type": "app"
      },
      "detail": {
        "template": "data_print",
        "params": {
          "template_name": "系统模板",
          "data_label": "A",
          "link": "/dashboard/app/68994cb727cc65376feb985d/form/689d59d8d241955ee4908625/data/69c6297fbf7965a4d21e5ec2/qr_link"
        }
      }
    }
  ]
}

3. 过滤条件

日志范围（domain）	支持的过滤字段	说明
login	actor_ids	按操作人成员 ID 过滤
platform	actor_ids	按操作人成员 ID 过滤
app_builder	actor_ids app_ids entry_ids	按操作人成员 ID、应用 ID、表单/仪表盘 ID、操作对象过滤
kms	actor_ids	按操作人成员 ID 过滤

过滤字段说明：

参数	类型	说明
filters.actor_ids	String[]	操作人成员 ID 列表
filters.app_ids	String[]	应用 ID 列表，仅日志范围为应用管理时支持
filters.entry_ids	String[]	表单、仪表盘等 ID 列表，仅当日志范围为应用管理（app_builder）时支持