Skip to content

Notion 凭据#

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

先决条件#

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

支持的认证方法#

  • API integration token：用于内部集成。
  • OAuth2：用于公共集成。

集成类型

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

相关资源#

参考 Notion 的 API 文档了解有关该服务的更多信息。

使用 API integration token#

要配置此凭据，您需要：

  • 一个 Internal Integration Secret 内部集成密钥：创建 Notion 集成后生成。

要生成集成密钥，创建 Notion 集成并从 Secrets 标签页获取集成密钥：

  1. 转到您的 Notion 集成仪表板。
  2. 选择 + New integration 按钮。
  3. 为您的集成输入 Name，例如 n8n integration。如果需要，添加 Logo。
  4. 选择 Submit 创建您的集成。
  5. 打开 Capabilities 标签页。选择这些功能：
    • Read content
    • Update content
    • Insert content
    • User information without email addresses
  6. 确保 Save changes。
  7. 选择 Secrets 标签页。
  8. 复制 Internal Integration Token 并将其作为您的 n8n Internal Integration Secret 添加。

参考内部集成认证流程设置文档了解有关该服务身份验证的更多信息。

与集成共享 Notion 页面#

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

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

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

参考集成权限了解更多信息。

使用 OAuth2#

要配置此凭据，您需要：

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

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

  1. 转到您的 Notion 集成仪表板。
  2. 选择 + New integration 按钮。
  3. 为您的集成输入 Name，例如 n8n integration。如果需要，添加 Logo。
  4. 选择 Submit 创建您的集成。
  5. 打开 Capabilities 标签页。选择这些功能：
    • Read content
    • Update content
    • Insert content
    • User information without email addresses
  6. 选择 Save changes。
  7. 转到 Distribution 标签页。
  8. 开启 Do you want to make this integration public? 控制。
  9. 在 Organization Information 部分输入您的公司名称和网站。
  10. 复制 n8n OAuth Redirect URL 并将其作为 Redirect URI 添加到 Notion 集成的 OAuth Domain & URLs 部分。
  11. 转到 Secrets 标签页。
  12. 复制 Client ID 和 Client Secret 并将它们添加到您的 n8n 凭据中。

参考 Notion 的公共集成认证流程设置了解有关该服务身份验证的更多信息。

内部集成与公共集成#

内部集成：

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

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

公共集成：

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

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

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