Notion API 连接
通过 Notion 的 API,你将能够创建自定义内部连接。我们的一些合作伙伴可能还需要 API 令牌,才能将他们的平台链接到你的 Notion 工作空间——下面,我们将指导你如何设置。
您可以从 Notion 管理个人访问令牌。请从 设置 中开启开发者模式,然后从侧边栏的开发者部分打开个人访问令牌。访问我们的 开发者中心 以获取文档、资源和连接管理工具。
提示:每个连接都有一个或多个所有者,每位所有者都可以管理连接并获取其 API 令牌。哪些人可以创建连接,取决于你的方案和工作空间设置。了解企业连接设置的更多信息 →
正在寻找管理员令牌?此页面上的令牌在单个工作空间内有效,用于处理页面内容。如果你需要执行导出、依法保留或注销用户等组织管理工作,请参阅 企业组织的管理 API。
我需要哪种令牌?Notion 使用几种不同的令牌。你为内部连接拷贝的令牌是 API 令牌,本文介绍的就是它。个人访问令牌与你自己的帐号绑定。OAuth 用于你登录的应用。如果合作伙伴平台要求你提供自己创建的连接令牌,请使用 API 令牌。
在左侧边栏中,导航至
设置,然后点击连接选项卡。谁可以创建连接取决于你的工作空间。在免费版和 Plus 版中,只有工作空间所有者可以创建连接。在商业版和企业版中,工作空间所有者还可以允许成员或特定群组中的成员创建连接。如果你无法创建连接,请咨询工作空间所有者。
开启 开发者模式,然后从侧边栏的开发者部分打开个人访问令牌。
点击
+ 新建连接。为你的连接提供一个
名称。你也可以选择上传一张图片作为徽标。使用下拉菜单指定你希望将此连接用于哪个
关联工作空间。
注意: 请确保你在网页会话中登录 Notion 时所使用的帐号与桌面端使用的帐号相同。否则,你将无法看到正确的帐号和工作空间!

你的内部连接已成功添加!你现在可以在工作空间的
设置菜单 →连接中看到它。点击内部连接旁边的
•••,复制其 API 令牌。团队创建基于 API 的自动化或工作流程,或将工作空间连接到某些合作伙伴平台时,都需要用到这个令牌。

注意: 内部连接是工作空间特定的,因此要更改关联的工作空间,你必须创建一个新的连接.

每个内部连接至少有一名所有者。所有者可以更改连接的设置并获取其 API 令牌。你可以共享所有权,以便多人可以管理同一个连接。这样,如果有人更换职位或离职,工作就不会中断。
要添加或移除所有者:
打开开发者门户并选择你的连接。
打开
连接所有者选项卡。添加成员或群组作为所有者,或移除现有所有者。
关于连接所有者,请注意以下事项:
只有正式成员和工作空间所有者才能成为连接所有者。访客和访问权限受限的成员不能成为连接所有者。
你能添加哪些所有者,也取决于工作空间中关于谁可以创建连接的设置。
连接始终至少保留一名所有者,因此你不能移除最后一名所有者。
如果你是工作空间所有者并需要接管连接,请先将自己添加为所有者。
如果最后一名所有者离开工作空间,该连接的 API 令牌将立即停止工作。
在 Plus 版、商业版和企业版中,你可以通过浏览器或 Notion 桌面应用共享连接的所有权。
所有新添加的连接最初都是内部连接。如果你是正在开发公共连接的开发者,请先按照上述指令创建内部连接。
然后,按照我们 开发者使用手册 中的说明将其转换为公共连接。
创建公共连接时,你可以选择允许谁安装:
任何工作空间:任何人都可以将你的连接安装到自己的 Notion 工作空间。选定的工作空间:只有你列出的工作空间才能安装你的连接。
如果你只为自己的公司开发,不希望其他组织安装,就选择选定的工作空间。
每次有人安装你的连接时,Notion 都会检查其工作空间是否在你的列表中。如果不在,安装就会中止,并显示错误提示。
只有任何人都能安装的连接才能出现在连接库中。仅限选定工作空间安装的连接不会出现在连接库中。
提示:创建连接时,你需要做出这个选择。如果之后想更改这项设置,就需要创建新连接。
你拥有的连接会显示在以下工作空间的开发者门户中:获准安装该连接、已安装该连接,或你用来构建该连接的工作空间。
每个公共连接都有一个用于构建和测试的工作空间。你可以切换到其他工作空间,无需从头开始。
在开发者门户中打开你的连接。
打开连接设置。
选择你要用于构建的工作空间。
Notion 会将你的连接关联到你选择的工作空间。你无需创建新连接。
在应用设置过程中,开发者将能够选择用户所需的访问权限级别。
内容功能:
仅读取内容
仅写入内容
插入内容
用户功能
没有用户信息
读取用户信息(不包括用户的电子邮件地址)
读取用户信息(包括电子邮件)
当用户安装连接时,将显示此访问级别。它还会显示在已添加该连接的任何页面的 共享 菜单中。了解更多关于在工作空间中安装连接的信息 →
连接 Webhook 使连接能够实时监控 Notion 工作空间中的更改并做出响应。
当与你的 连接 共享的页面或数据库发生更改时,Notion 会自动向你的 Webhook 端点发送通知,从而允许你的连接立即更新其他工具、运行自动化任务或显示最新更改。
有关说明,请访问我们的 开发者文档。
Webhook 操作与连接 Webhook 有一些相似之处——两者都有触发器,并且可以将事件发送到第三方服务。但是,连接 Webhook 提供了更广泛的功能:
它们可以监控多个工作空间中的活动。
它们可以处理无限数量的操作。
相比之下,Webhook 操作专为更简单的用例而设计,并通过具有有限触发器集的数据库自动化进行配置。
