针对企业组织的管理 API
使用代码而非配置设置来执行管理工作。
跳转到常见问题提示:此功能仅适用于企业版,且仅限组织所有者进行设置。
Notion 的管理 API 让你的组织能够通过代码处理管理工作。这包括常见的任务,例如启动工作空间导出、创建和解除依法保留、将受管理的用户从 Notion 注销等。
你可以在组织设置中进行此项设置。你需要为组织创建一个管理机器人,然后为其提供仅包含所需访问权限的令牌。
你的组织需要使用企业版。
你必须是组织所有者。
此功能专为管理、IT、安全和合规团队打造。成员和访客不会察觉到日常工作有任何变化。
打开工作空间切换(器)并选择
管理组织。前往
常规,然后打开管理组织级管理 API 令牌。选择
创建连接。为该连接起一个团队能识别的名称,例如“合规自动化”,并仅选择其所需的访问权限。如果连接仅用于运行导出,请勿授予其依法保留访问权限。
选择
创建令牌,然后复制该令牌并将其保存在团队现有的密钥管理器中。
你将在组织设置中看到新列出的连接,以及创建者和创建时间。你可以随时回到连接菜单中再次复制该令牌。
提示:为每个自动化流程提供其专属的连接和令牌。如果需要停用某个令牌,其余的自动化流程仍可继续运行。
选择能完成工作所需的最小访问权限集。
按照安全团队设定的时间表轮换令牌。
如果令牌被误共享或令牌所有者更换了角色,请立即删除该令牌。任何使用该令牌的脚本都将立即停止工作。
你无法将管理令牌限制为特定的 IP 地址或网络。请使用你现有的控制措施,例如将令牌存储在密钥管理器中,并从你信任的系统中运行调用。
使用管理令牌执行的操作会显示在你的 审计日志中。管理机器人会被列为执行者,因此你可以区分自动化工作与人工工作。
调用被拒绝。请检查你的组织是否处于企业版。
你收到权限错误。请检查该令牌是否具有你所调用操作的访问权限。仅限于导出操作的令牌无法创建依法保留。
注销调用无效。请检查该账户是否为受管理的用户。你已验证域之外的账户不在覆盖范围内。
有关请求格式、参数和代码示例,请参阅开发者文档中的管理 API 参考。
