针对企业组织的管理 API

在此帮助文档中

使用代码而非配置设置来执行管理工作。

跳转到常见问题

提示:此功能仅适用于企业版,且仅限组织所有者进行设置。

Notion 的管理 API 让你的组织能够通过代码处理管理工作。这包括常见的任务,例如启动工作空间导出、创建和解除依法保留、将受管理的用户从 Notion 注销等。

你可以在组织设置中进行此项设置。你需要为组织创建一个管理机器人,然后为其提供仅包含所需访问权限的令牌。

  • 你的组织需要使用企业版。

  • 你必须是组织所有者。

  • 此功能专为管理、IT、安全和合规团队打造。成员和访客不会察觉到日常工作有任何变化。

  1. 打开工作空间切换(器)并选择 管理组织

  2. 前往 常规,然后打开 管理组织级管理 API 令牌

  3. 选择 创建连接

  4. 为该连接起一个团队能识别的名称,例如“合规自动化”,并仅选择其所需的访问权限。如果连接仅用于运行导出,请勿授予其依法保留访问权限。

  5. 选择 创建令牌,然后复制该令牌并将其保存在团队现有的密钥管理器中。

你将在组织设置中看到新列出的连接,以及创建者和创建时间。你可以随时回到连接菜单中再次复制该令牌。

提示:为每个自动化流程提供其专属的连接和令牌。如果需要停用某个令牌,其余的自动化流程仍可继续运行。

  • 选择能完成工作所需的最小访问权限集。

  • 按照安全团队设定的时间表轮换令牌。

  • 如果令牌被误共享或令牌所有者更换了角色,请立即删除该令牌。任何使用该令牌的脚本都将立即停止工作。

  • 你无法将管理令牌限制为特定的 IP 地址或网络。请使用你现有的控制措施,例如将令牌存储在密钥管理器中,并从你信任的系统中运行调用。

使用管理令牌执行的操作会显示在你的 审计日志中。管理机器人会被列为执行者,因此你可以区分自动化工作与人工工作。

  • 调用被拒绝。请检查你的组织是否处于企业版。

  • 你收到权限错误。请检查该令牌是否具有你所调用操作的访问权限。仅限于导出操作的令牌无法创建依法保留。

  • 注销调用无效。请检查该账户是否为受管理的用户。你已验证域之外的账户不在覆盖范围内。

有关请求格式、参数和代码示例,请参阅开发者文档中的管理 API 参考


常见问题

这与 Notion API 连接令牌相同吗?

不相同。连接令牌在单个工作空间内工作,用于读取或写入页面内容。管理员令牌属于你的组织,仅用于处理管理操作,例如导出、依法保留和注销用户。

这会取代组织设置吗?

不会。你通过管理 API 执行的所有操作,仍然可以在组织设置中手动完成。API 的作用在于当你需要大规模重复相同工作时提供便利。

我可以将令牌限制在特定的 IP 地址吗?

目前还不行。IP 地址限制适用于登录的用户,而不适用于管理员令牌。

仍有更多问题?给支持部门留言

给予反馈

这个资源有帮助吗?


Powered by Fruition