支援與設定
使用管理 API
The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
管理 API 允許您以程式化方式管理您組織的資源,包括組織成員、工作區和 API 金鑰。這提供了對管理任務的程式化控制,否則這些任務需要在 Anthropic 控制台 中手動配置。
管理 API 需要特殊存取權限
管理 API 需要一個特殊的管理 API 金鑰(以 sk-ant-admin...
開頭),它與標準 API 金鑰不同。只有具有管理員角色的組織成員才能通過 Anthropic 控制台提供管理 API 金鑰。
管理 API 的工作原理
當您使用管理 API 時:
- 您使用
x-api-key
標頭中的管理 API 金鑰發出請求 - API 允許您管理:
- 組織成員及其角色
- 組織成員邀請
- 工作區及其成員
- API 金鑰
這對以下情況很有用:
- 自動化用戶入職/離職
- 以程式化方式管理工作區存取
- 監控和管理 API 金鑰使用情況
組織角色和權限
有五種組織級別的角色。
角色 | 權限 |
---|---|
user | 可以使用 Workbench |
claude_code_user | 可以使用 Workbench 和 Claude Code |
developer | 可以使用 Workbench 和管理 API 金鑰 |
billing | 可以使用 Workbench 和管理帳單詳情 |
admin | 可以執行以上所有操作,並管理用戶 |
關鍵概念
組織成員
您可以列出組織成員、更新成員角色和移除成員。
組織邀請
您可以邀請用戶加入組織並管理這些邀請。
工作區
創建和管理工作區以組織您的資源:
工作區成員
管理用戶對特定工作區的存取:
API 金鑰
監控和管理 API 金鑰:
最佳實踐
要有效使用管理 API:
- 為工作區和 API 金鑰使用有意義的名稱和描述
- 為失敗的操作實施適當的錯誤處理
- 定期審核成員角色和權限
- 清理未使用的工作區和過期的邀請
- 監控 API 金鑰使用情況並定期輪換金鑰