Skip to content

Notion 凭证#

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

先决条件#

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

支持的认证方式#

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

集成类型

不确定该使用哪种集成类型？请参考下方的内部与公共集成获取更多信息。

相关资源#

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

使用 API 集成令牌#

配置此凭证需要：

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

要生成集成密钥，请先创建 Notion 集成，然后从 Secrets 选项卡获取集成密钥：

  1. 访问您的 Notion 集成仪表板。
  2. 点击 + New integration 按钮。
  3. 输入集成名称，例如 n8n integration。如需可添加徽标。
  4. 点击 Submit 创建集成。
  5. 打开 Capabilities 选项卡。选择以下功能：
    • 读取内容
    • 更新内容
    • 插入内容
    • 不含邮箱的用户信息
  6. 务必保存更改。
  7. 选择 Secrets 选项卡。
  8. 复制内部集成令牌并将其添加为 n8n 的内部集成密钥。

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

与集成共享 Notion 页面#

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

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

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

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

使用 OAuth2#

配置此凭证需要以下信息：

  • Client ID：在配置公共集成时生成
  • Client Secret：在配置公共集成时生成

您需要先创建 Notion 集成并设置为公开分发：

  1. 访问您的 Notion 集成仪表板
  2. 点击 + New integration 按钮
  3. 输入集成名称，例如 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 并添加到 Notion 集成的 OAuth Domain & URLs 部分作为 Redirect URI
  11. 进入 Secrets 选项卡
  12. 复制 Client ID 和 Client Secret 并添加到 n8n 凭证中

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

内部集成与公共集成#

内部集成具有以下特点： * 仅限单个工作区使用 * 仅对该工作区成员可见 * 适合定制化工作区增强功能

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

公共集成具有以下特点：

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

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

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