Skip to content

Notion 凭证

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

先决条件

创建具有管理员级别访问权限的Notion帐户。

支持的身份验证方法

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

集成类型

不确定要使用哪种集成类型？请参阅下方的内部集成与公共集成了解更多信息。

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

使用 API 集成令牌

要配置此凭据，您需要：

  • 内部集成秘密：创建 Notion 集成后生成。

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

  1. 转到您的 Notion集成仪表板。
  2. 选择+ 新建集成按钮。
  3. 输入集成的名称，例如。如果需要，可以添加徽标。
  4. 选择“提交”以创建您的集成。
  5. 打开“功能”选项卡。选择以下功能：
  6. 请务必保存更改。
  7. 选择“机密”选项卡。
  8. 复制内部集成令牌并将其添加为您的 n8n内部集成密钥。

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

通过集成分享 Notion 页面

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

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

至少共享一个页面后，即可开始发出 API 请求。如果页面未共享，则任何 API 请求都会返回错误。

有关详细信息，请参阅集成权限。

使用 OAuth2

要配置此凭据，您需要：

  • 客户端ID ：配置公共集成后生成。
  • 客户端密钥：配置公共集成后生成。

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

  1. 转到您的 Notion集成仪表板。
  2. 选择+ 新建集成按钮。
  3. 输入集成的名称，例如。如果需要，可以添加徽标。
  4. 选择“提交”以创建您的集成。
  5. 打开“功能”选项卡。选择以下功能：
  6. 选择“保存更改” 。
  7. 转到“分发”选项卡。
  8. 打开“您是否要将此集成公开？”控制。
  9. 在组织信息部分输入您的公司名称和网站。
  10. 复制 n8n OAuth 重定向 URL并将其作为重定向 URI添加到Notion 集成的OAuth 域和 URL部分。
  11. 转到“秘密”选项卡。
  12. 复制客户端 ID和客户端密钥并将其添加到您的 n8n 凭证中。

有关服务身份验证的更多信息，请参阅 Notion 的公共集成身份验证流程设置。

内部集成与公共集成

内部集成包括：

  • 特定于单个工作区。
  • 仅该工作区的成员可访问。
  • 非常适合自定义工作空间增强。

内部集成使用更简单的身份验证过程（集成密钥），并且在发布之前不需要任何安全审查。

公共集成包括：

  • 可在多个不相关的 Notion 工作区中使用。
  • 任何 Notion 用户都可以访问，无论他们的工作空间在哪里。
  • 非常适合满足广泛的使用案例。

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

有关这两种集成类型的更详细分类，请参阅 Notion 的内部集成与公共集成文档。