查询活动动态

检索、筛选和分页浏览您组织的 Compliance API 活动动态。

活动动态记录组织中发生的每一次身份验证、聊天、文件、项目、管理和平台操作，按时间倒序排列。活动在发生后 1 分钟内即可查询，保留期限为 6 年。

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
      "created_at": "2026-04-10T08:09:10Z",
      "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
      "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
      "actor": {
        "type": "user_actor",
        "email_address": "user@example.com",
        "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
        "ip_address": "192.0.2.34",
        "user_agent": "Mozilla/5.0..."
      },
      "type": "claude_chat_created",
      "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    }
  ],
  "has_more": true,
  "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
  "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}

筛选活动

按组织、操作者、活动类型或使用点分隔的子参数 created_at.gte、.gt、.lte 和 .lt 设置的 created_at 时间窗口进行筛选。请参阅 API 参考文档了解每个参数的类型和可接受的值。

可重复参数使用数组括号查询语法：为每个值传入一次 activity_types[]=...、actor_ids[]=... 或 organization_ids[]=...。

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --data-urlencode "activity_types[]=claude_file_uploaded" \
  --data-urlencode "activity_types[]=claude_chat_created" \
  --data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

活动动态产生数百种不同的活动类型。请参阅 API 参考文档中的查询合规活动了解 activity_types[] 接受的完整值列表。

分页结果

活动按最新优先排序，created_at 相同时按活动 ID 排序，每次响应最多返回 limit 条结果（默认 100，最大 5,000）。请参阅 API 参考文档了解完整的响应架构。

Compliance API 根据端点系列使用两种分页方案：

组织和文件不分页：列出组织在一个响应中返回所有结果，文件通过 ID 单独检索。

分页游标和页面令牌是不透明字符串：请原样传回。它们的内部格式不稳定，解析它们会在没有通知的情况下失效。每次请求只能设置 after_id 或 before_id 中的一个，两种方案都返回 has_more 以便您知道何时停止。

要逐页浏览活动：

• 将响应的 last_id 作为 after_id 传入以前进到结果顺序中的下一页。由于活动按最新优先排序，下一页包含更早的条目。
• 将 first_id 作为 before_id 传入以返回上一页。
• 当 has_more 为 false 时停止。

游标参数设置页面方向；端点的排序方式设置时间方向。此处相同的 after_id 参数访问更早的活动。聊天按最早优先排序；请参阅检索和删除聊天、文件和项目了解那里的游标语义。

# 获取第一页（最新活动优先）并捕获其末尾游标。
last_id=$(curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=2" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" | jq -er '.last_id')

# 原样传回游标以获取下一页（更早的）页面。
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=2" \
  --data-urlencode "after_id=${last_id}"

生产环境中的回填循环通过驱动 has_more 和 last_id 的迭代来逐页浏览更早的活动：

1. 从您存储的游标开始（或省略 after_id 从头开始）。
2. 使用 after_id=<last_id> 逐页浏览，直到 has_more 为 false。
3. 仅在存储了它所覆盖的每个页面之后才持久化最终的 last_id。

cursor = stored_cursor
loop:
  if cursor is not null:
    page = GET /v1/compliance/activities?after_id={cursor}&limit=100
  else:
    page = GET /v1/compliance/activities?limit=100
  store(page.data)
  if page.last_id is not null:
    cursor = page.last_id
  if not page.has_more: break
persist(cursor)

理解 Activity 对象

data 中的每个条目都是一个 Activity，具有以下顶层结构：

actor 字段是一个可区分联合类型。type 判别器告诉您存在哪些其他字段：

后续步骤