跳转至

Notion 凭证#

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

先决条件#

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

支持的认证方法#

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

集成类型

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

相关资源#

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

使用 API 集成令牌#

要配置此凭证,您需要:

  • 一个 内部集成密钥:在您创建 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. 确保保存更改
  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:在您配置公共集成后生成。
  • 一个 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 IDClient Secret 并将它们添加到您的 n8n 凭证中。

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

内部与公共集成#

内部集成是:

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

内部集成使用更简单的认证过程(集成密钥),在发布前不需要任何安全审查。

公共集成是:

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

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

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

此页面是否
💬 微信

🚀 与作者交流

关注公众号
n8n实战笔记公众号
n8n实战笔记
📚 教程 💡 案例 🔧 技巧
添加微信
添加作者微信
1对1 专业指导
⚡ 快答 🎯 定制 🚀 支持