Compliance API 讓 Claude Enterprise 客戶能以程式化方式存取其組織的活動動態(Activity Feed)、涵蓋每個已連結組織的使用者、角色和群組目錄、每個組織生效中的設定,以及對於 claude.ai 組織而言的底層對話、檔案、和專案。安全、法務和合規團隊使用它來稽核活動、擷取或刪除內容,並將事件饋送至下游工具。
有兩種金鑰類型可解鎖 Compliance API。Compliance Access Key(在 claude.ai 中建立)可存取所有端點,而 Admin API key(在 Claude Console 中建立)僅能存取活動動態。請參閱您需要哪種金鑰?以了解完整的金鑰類型比較。
以下呼叫會回傳您組織中最近的活動事件。任何具有 read:compliance_activities 範圍的金鑰都可以執行此呼叫。若要建立金鑰並授予該範圍,請參閱設定 Compliance API。
curl --fail-with-body -sS \
"https://api.anthropic.com/v1/compliance/activities?limit=1" \
--header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"成功的回應會回傳一個 JSON 物件,包含 data(Activity 記錄的陣列)、has_more、first_id 和 last_id:
{
"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": "[email protected]",
"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"
}所有端點都位於 https://api.anthropic.com 上的 /v1/compliance/* 之下,並透過 x-api-key 標頭進行驗證。若要佈建金鑰,請參閱設定 Compliance API。
活動動態(GET /v1/compliance/activities)可供任何帶有 read:compliance_activities 範圍的金鑰使用;請參閱查詢活動動態以了解篩選器、分頁和完整的 Activity 物件。其餘端點需要帶有相關範圍的 Compliance Access Key。
一個 Claude Enterprise 租戶有一個父組織(集中管理身分的最上層容器),並有兩種已連結的組織:claude.ai 組織(使用者在此對話和儲存內容)和 Claude Console 組織(使用者在此管理 Claude API 工作負載)。對於涵蓋父組織的金鑰,目錄端點(組織、使用者、角色和群組)會回傳來自任一種類的每個已連結組織的資料。內容端點(對話、檔案、專案和專案附件)僅提供 claude.ai 資料。
所有 /v1/compliance/* 端點共用每個父組織每分鐘 600 個請求的單一速率限制;請參閱 429 Too Many Requests 以了解回應標頭和重試約定。
有兩個相鄰的功能與 Compliance API 有所重疊;以下說明如何選擇。
稽核日誌匯出是 claude.ai > 組織設定 > 資料與隱私中的一個獨立功能,讓擁有者和主要擁有者下載組織事件的 CSV 檔案。它的範圍比 Compliance API 窄得多:有上限的回溯期間、僅限 CSV 下載,且無法存取對話、檔案或專案內容。對於持續性的程式化使用,請以 Compliance API 為標準。
Anthropic 提供兩種分析 API:Claude Enterprise Analytics API 和 Claude Code Analytics API。兩者都為 IT、FinOps 和平台團隊回傳彙總的使用量和成本數據,而 Compliance API 則為安全、法務和合規團隊回傳逐事件記錄。這兩個 API 系列回答不同的問題、使用不同的金鑰,並且是分開佈建的。
為您的組織啟用 Compliance API,然後建立 Compliance Access Key(具有範圍限定的權限)或 Admin API key,並了解該使用哪一種。
擷取、篩選和分頁共用的活動動態。兩種金鑰類型皆支援。
讀取對話內容和附件,然後依需求刪除。需要 Compliance Access Key。
列舉已連結的組織、成員、角色和目錄群組,並讀取每個組織的生效設定。
選擇動態消費模式、規劃 SIEM 關聯,並決定您的保留方法。
Compliance API 回傳的每個 400、401、403、404、409、429 和 5xx 回應,以及各自的修正方法。
每個 Compliance API 呼叫的端點路徑、參數和回應結構描述。
關於金鑰、範圍、可用性和整合的常見問題解答。
Was this page helpful?