Notion 凭证#

您可以使用这些凭证来验证以下节点：

• Notion
• Notion触发器

先决条件#

创建一个具有管理员权限的Notion账户。

支持的认证方法#

• API集成令牌：用于内部集成。
• OAuth2：用于公共集成。

相关资源#

更多关于该服务的信息，请参考Notion的API文档。

使用API集成令牌#

要配置此凭证，您需要：

• 一个内部集成密钥：创建Notion集成时自动生成。

要生成集成密钥，创建Notion集成并从密钥选项卡中获取集成密钥：

1. 前往您的Notion 集成仪表盘。
2. 点击+ 新建集成按钮。
3. 为您的集成输入一个名称，例如n8n integration。如果需要，可以添加一个徽标。
4. 选择提交来创建您的集成。
5. Open the Capabilities tab. Select these capabilities:
   • 读取内容
   • Update content
   • 插入内容
   • 不含邮箱地址的用户信息
6. 请确保保存更改。
7. 选择Secrets选项卡。
8. 复制内部集成令牌并将其添加为您的n8n内部集成密钥。

有关服务认证的更多信息，请参阅内部集成认证流程设置文档。

与集成共享Notion页面#

为了让您的集成能与Notion交互，您必须授予您的集成页面权限以与Notion工作区中的页面进行交互：

1. 访问您Notion工作区中的该页面。
2. 选择页面右上角的三点菜单。
3. 在连接中，选择连接到。
4. 使用搜索栏在下拉列表中找到并选择您的集成。

一旦您与集成共享至少一个页面，就可以开始发起API请求。如果页面未共享，任何API请求都会返回错误响应。

更多信息请参考集成权限。

使用OAuth2认证#

要配置此凭证，您需要：

• 一个客户端ID：在配置公共集成时生成。
• 一个客户端密钥：在配置公共集成时生成。

您必须创建一个Notion集成并将其设置为公开分发：

1. 前往您的Notion 集成仪表盘。
2. 点击+ 新建集成按钮。
3. 为您的集成输入一个名称，例如n8n integration。如果需要，可以添加一个徽标。
4. 选择提交来创建您的集成。
5. Open the Capabilities tab. Select these capabilities:
   • 读取内容
   • 更新内容
   • 插入内容
   • 不含邮箱地址的用户信息
6. 选择保存更改。
7. 前往分发选项卡。
8. 开启是否要将此集成设为公开？控制选项。
9. 在组织信息部分输入您的公司名称和网站。
10. 复制n8n的OAuth重定向URL，并将其作为重定向URI添加到Notion集成的OAuth域名和URL部分中。
11. 前往Secrets选项卡。
12. 复制客户端ID和客户端密钥并将其添加到您的n8n凭证中。

有关服务认证的更多信息，请参考Notion的公共集成认证流程设置。

内部与公共集成#

内部集成包括：

• 特定于单个工作区。
• 仅限该工作区成员访问。
• 非常适合自定义工作区增强功能。

内部集成采用更简单的认证流程（集成密钥），发布前无需任何安全审查。

公开 集成包括：

• 可在多个不相关的Notion工作区中使用。
• 任何Notion用户均可访问，无论其所属的工作区。
• 非常适合满足广泛的用例需求。

公共集成使用OAuth 2.0协议进行身份验证。在发布前需要通过Notion的安全审核。

如需详细了解这两种集成类型的区别，请参阅Notion的内部与公共集成文档。