針對企業版組織的管理員 API

Notion 的管理員 API 讓您的組織能以程式碼處理管理員工作。這包括常見任務，例如啟動工作空間匯出、建立與解除法務保存、將受管理使用者登出 Notion 等。

您可以在組織設定中進行此項設定。您為組織建立一個管理員機器人，然後給予它僅需的存取權限權杖。

• 您的組織需要使用企業版。

• 您必須是組織擁有者。

• 此功能專為管理員、IT、資安與合規團隊打造。成員與訪客在日常工作中不會察覺任何變動。

1. 開啟您的工作空間切換器並選取 管理組織。

2. 前往 一般，然後開啟 管理組織層級管理員 API 權杖。

3. 選取 建立連接。

4. 為此連接命名一個您的團隊能識別的名稱，例如「合規自動化」，並僅選取其所需的存取權限。如果連接僅用於執行匯出，請勿給予其法務保存存取權。

5. 選取 建立權杖，然後複製該權杖並將其儲存至您的團隊現有的密鑰管理員中。

您會在組織設定中看到新建立的連接，以及建立者與建立時間。您可以隨時回到連接選單中再次複製該權杖。

• 選擇能完成工作所需的最小存取權限集。

• 依照您的資安團隊設定的時程輪替權杖。

• 如果權杖被誤傳或擁有該權杖的人員職務異動，請立即刪除該權杖。任何使用該權杖的指令碼將會立即停止運作。

• 您無法將管理員權杖限制為特定的 IP 位址或網路。請使用您現有的控制措施，例如將權杖儲存在密鑰管理員中，並從您信任的系統執行呼叫。

使用管理員權杖所採取的動作會顯示在您的 稽核記錄檔 中。管理員機器人會被列為執行者，因此您可以區分自動化作業與人工作業。

• 呼叫遭到拒絕。 請檢查您的組織是否使用企業版。

• 您收到權限錯誤。 請檢查該權杖是否具有您所呼叫動作的存取權限。範圍僅限於匯出的權杖無法建立法務保存。

• 登出呼叫無效。 請檢查該帳號是否為 受管理使用者。驗證網域之外的帳號不在涵蓋範圍內。

如需請求格式、參數與程式碼範例，請參閱開發人員文件中的 管理員 API 參考。