---
title: 查詢 Activity Feed
url: https://platform.claude.com/docs/zh-TW/manage-claude/compliance-activity-feed
description: 擷取、篩選並分頁瀏覽您組織的 Compliance API Activity Feed。
---
若要啟用 Compliance API，請參閱[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access)。
**所需「scope」（範圍）：** Compliance Access Key 或 Admin API 金鑰上的 `read:compliance_activities`。
具備此範圍的 Compliance Access Key（`sk-ant-api01-...`）與 Admin API 金鑰（`sk-ant-admin01-...`）皆可呼叫 Activity Feed。請參閱[設定 Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api-access)，了解各類金鑰在哪些條件下具備此範圍。
「Activity Feed」（活動動態）會記錄您組織中的驗證、聊天、檔案、專案、管理及平台活動，並以時間倒序傳回。活動在發生後 1 分鐘內即可查詢，並保留 6 年。記錄不具追溯性：記錄從您的組織首次啟用 Compliance API 時開始，啟用之前的活動不會被回填。
```bash cURL
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=1" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01"
```
```json Response
{
"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"
}
```
## 篩選活動
您可以依組織、「actor」（執行者）、活動類型，或使用點號子參數 `created_at.gte`、`.gt`、`.lte` 和 `.lt` 指定的 `created_at` 時間範圍進行篩選。請參閱 [API 參考文件](https://platform.claude.com/docs/zh-TW/api/compliance/activities/list)，了解各參數的類型與可接受的值。
可重複的參數使用陣列方括號查詢語法：每個值各傳入一次 `activity_types[]=...`、`actor_ids[]=...` 或 `organization_ids[]=...`。
```bash cURL
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" \
--header "anthropic-version: 2023-06-01"
```
Activity Feed 會產生數百種不同的活動類型。請參閱 API 參考文件中的[查詢合規活動](https://platform.claude.com/docs/zh-TW/api/compliance/activities/list)，取得 `activity_types[]` 可接受值的完整清單。
## 分頁瀏覽結果
活動會以最新的優先傳回，`created_at` 相同時依活動 ID 排序，且每個回應最多傳回 `limit` 筆結果（預設 100，上限 5,000）。請參閱 [API 參考文件](https://platform.claude.com/docs/zh-TW/api/compliance/activities/list)，了解完整的回應結構描述。
Compliance API 依端點系列使用兩種「pagination」（分頁）機制：
| 端點系列 | 排序方式 | 機制 | 參數 |
| ------------------------------ | --------------------- | ---- | ------------------------------------------------- |
| 活動 | 最新的優先 | 游標 | `after_id`、`before_id`（以 `first_id`、`last_id` 傳回） |
| 聊天與聊天訊息 | 最舊的優先 | 游標 | `after_id`、`before_id`（以 `first_id`、`last_id` 傳回） |
| 組織、專案、專案附件、使用者、角色、角色權限、群組、群組成員 | 依端點而定 | 頁面權杖 | `page`（以 `next_page` 傳回） |
| 本機與遠端工作階段及工作階段訊息 | 工作階段為最新的優先；訊息預設為最舊的優先 | 頁面權杖 | `page`（以 `next_page` 傳回） |
檔案不進行分頁：檔案是依 ID 個別擷取。
分頁用的「cursor」（游標）與「page token」（頁面權杖）皆為不透明字串：請原封不動地傳回。其內部格式並不穩定，若加以解析，可能會在未經通知的情況下失效。每個請求中只能設定 `after_id` 或 `before_id` 其中之一，且兩種機制都會傳回 `has_more`，讓您知道何時停止。工作階段端點（本機與遠端）是例外：它們會傳回 `next_page` 但不傳回 `has_more`，因此請在 `next_page` 為 `null` 時停止。
若要分頁瀏覽活動：
* 將回應中的 `last_id` 作為 `after_id` 傳入，以依結果順序前進到下一頁。由於活動以最新的優先排序，下一頁會包含較舊的項目。
* 將 `first_id` 作為 `before_id` 傳入，以返回上一頁。
* 當 `has_more` 為 `false` 時停止。
游標參數決定頁面方向；端點的排序方式決定時間方向。在此，同一個 `after_id` 參數會取得較舊的活動。聊天則以最舊的優先排序；請參閱[擷取與刪除聊天、檔案和專案](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-content-data)，了解該處的游標語意。
**游標可在重試時安全地重複使用。** 來自成功傳回頁面的游標或頁面權杖 仍然有效；失敗的請求（5xx、逾時、網路錯誤）不會推進您的位置。 請使用相同的游標重試相同的請求。只有在您已儲存游標所指向之前的頁面後， 才移至下一個游標。
本機工作階段端點上的頁面權杖在較長的暫停期間是例外。在[本機工作階段訊息端點](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-a-local-session-transcript)上，一次走訪（walk，即完整瀏覽一遍所有頁面）的 `page` 權杖會在其第一頁之後 24 小時到期，因此請在該時間範圍內完成或繼續，或不帶 `page` 參數重新開始。在[本機工作階段清單](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-sessions#retrieve-local-sessions)上，較舊的 `page` 權杖仍會被接受，但會依據目前的保留期限邊界重新評估，並可能略過部分工作階段，因此清單走訪也請在 24 小時內完成。
```bash cURL
# 擷取第一頁（最新的活動在前），並記下其結尾的 cursor。
last_id=$(curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=2" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01" | jq -er '.last_id')
# 將 cursor 原封不動傳回，以擷取下一頁（較舊的）。
curl --fail-with-body -sS -G \
"https://api.anthropic.com/v1/compliance/activities" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
--header "anthropic-version: 2023-06-01" \
--data-urlencode "limit=2" \
--data-urlencode "after_id=${last_id}"
```
正式環境的「**backfill**」（回填）迴圈會以 `has_more` 和 `last_id` 驅動迭代，分頁瀏覽較舊的活動：
1. 從您儲存的游標開始（或省略 `after_id` 以從頭開始）。
2. 使用 `after_id=` 分頁瀏覽，直到 `has_more` 為 `false`。
3. 只有在您已儲存最後一個 `last_id` 所涵蓋的每一頁之後，才將其持久保存。
```text
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：
| 欄位 | 類型 | 說明 |
| ------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | string | 活動的唯一識別碼。 |
| `created_at` | RFC 3339 string | 活動發生的時間。 |
| `organization_id` | string 或 null | 活動發生所在的組織；若事件未與組織綁定（登入、登出、Compliance API 呼叫），則為 `null`。 |
| `organization_uuid` | string 或 null | 與 `organization_id` 的範圍相同，以 UUID 表示。 |
| `actor` | Actor union | 執行該活動的人或事物。請參閱下方的執行者表格。 |
| `type` | string | 活動類型，例如 `claude_chat_created`。 |
| *其他欄位* | 不一 | 特定類型的欄位，例如聊天事件上的 `claude_chat_id` 或檔案事件上的 `claude_file_id`。請參閱 API 參考文件中的[查詢合規活動](https://platform.claude.com/docs/zh-TW/api/compliance/activities/list)，取得各類型的欄位清單。 |
`actor` 欄位是一個「discriminated union」（可辨識聯集）。`type` 辨識欄位會告訴您還有哪些其他欄位存在：
| `actor.type` | 出現時機 | 主要欄位 |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------- |
| `user_actor` | 已登入的 claude.ai 或 Claude Console 使用者執行了該動作，或 Anthropic 代表該使用者執行的程序執行了該動作（請參閱此表格後的段落）。 | `email_address`、`user_id`、`ip_address`、`user_agent` |
| `api_actor` | 某個請求使用客戶核發的 API 金鑰呼叫了 Claude API 或 Compliance API。無論使用 Compliance Access Key 或 Admin API 金鑰，Compliance API 呼叫都會產生此執行者類型。 | `api_key_id`、`ip_address`、`user_agent` |
| `admin_api_key_actor` | 組織管理員使用 Admin API 金鑰管理使用者、邀請、工作區或 API 金鑰。 | `admin_api_key_id`、`ip_address`、`user_agent` |
| `unauthenticated_user_actor` | 動作發生在登入完成之前，例如 `sso_login_initiated`。 | `unauthenticated_email_address`、`ip_address`、`user_agent` |
| `anthropic_actor` | Anthropic 對組織執行了動作，例如透過內部工具。 | `email_address`（一律為 `null`；為了與 `user_actor` 的結構保持一致而存在，因為 Anthropic 操作人員不以個人電子郵件表示） |
| `system_actor` | 由 Anthropic 系統執行的自動化背景處理，未使用使用者或客戶憑證。 | `service`（可為 null；已知時為執行該動作的自動化程序名稱） |
| `scim_directory_sync_actor` | 身分識別提供者（例如 Okta、Microsoft Entra ID 或 JumpCloud）透過 SCIM 目錄同步推送了變更。 | `workos_event_id`、`directory_id`、`idp_connection_type`（可為 null；例如 `OktaSCIMV2`、`AzureSCIMV2`） |
`user_actor` 活動並不一定代表使用者本人執行了該動作。Anthropic 代表使用者執行的程序目前可能會以受影響使用者的 `user_actor` 而非 `system_actor` 出現，且此歸屬方式可能會變更。例如，來自遷移的記憶活動，如 `platform_memory_store_created`、`platform_memory_created` 和 `platform_memory_deleted`，就是以此方式歸屬。無論由誰執行，記憶活動都可能顯示 `0.0.0.0` 的 `ip_address`，因此僅憑此值無法識別來自平台程序的活動。
`claude_*_viewed` 活動表示 Claude 應用程式載入了內容，而非有人檢視了該內容。`claude_chat_viewed`、`claude_file_viewed` 和 `claude_project_viewed` 等類型，會在每次 Claude 應用程式從 Anthropic 伺服器載入聊天、檔案或專案時記錄。重複的載入不會被去除重複。網頁版、桌面版和行動版應用程式會在不同時機載入內容，有時是在背景中進行，也可能在不載入的情況下顯示快取副本。因此，這些活動的數量會因平台而異，且不對應於已傳送的訊息或已檢視的畫面。
關於檔案、專案文件或 artifact 的活動不包含其名稱或標題。自 2026 年 9 月 24 日起，這些活動上的 `filename` 和 `title` 欄位一律為 `null`、空字串或被省略，包括該日期之前記錄的活動。若要查詢名稱或標題，請使用具有 `read:compliance_user_data` 範圍的 Compliance Access Key，將活動的 `claude_file_*`、`claude_proj_doc_*` 或 `claude_artifact_version_*` ID 傳入[擷取檔案與 artifacts](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-content-data#retrieve-files-and-artifacts) 中對應的中繼資料端點。在檔案、文件或 artifact 被刪除後，或活動沒有此類 ID 時，您無法查詢名稱或標題。
**建立具前向相容性的處理常式。** 請直接傳遞無法辨識的 `type` 和 `actor.type` 值，並忽略處理常式未預期的欄位，讓您的整合在新的活動類型 推出時仍能持續運作。
## 後續步驟
`GET /v1/compliance/activities` 的完整請求與回應結構描述，包括所有支援的 `activity_types[]` 值。
查詢並刪除您在動態中找到之活動的底層內容（需要 Compliance Access Key）。
選擇輪詢或批次取用模式，並規劃 SIEM 關聯分析。
完整的錯誤目錄。