Notion 凭据
您可以使用这些凭据来验证以下节点:
先决条件
创建一个具有管理员级别访问权限的 Notion{:target=_blank .external-link} 账户。
支持的认证方式
- API 集成令牌:用于内部集成。
- OAuth2:用于公共集成。
提示
Integration type 一体化型
不确定要使用哪种集成类型?有关更多信息,请参阅下面的内部与公共集成。
相关资源
参考 Notion 的 API 文档{:target=_blank .external-link}了解有关该服务的更多信息。
使用API集成令牌
要配置此凭据,您需要:
- Internal Integration Secret 内部整合秘密:在创建 Notion 集成后生成。
要生成集成密钥,创建 Notion 集成{:target=_blank .external-link}并从 Secrets 标签页获取集成密钥:
- 转到您的 Notion 集成仪表板。
- Select the + New integration + 新集成 button.
- 输入集成的 Name 名称,例如
n8n integration。如果需要,请添加 Logo 标志。 - 选择 Submit 提交 创建您的集成。
- 打开 Capabilities 能力 选项卡。选择这些功能:
*
Read content*Update content*Insert content*User information without email addresses - 务必Save changes 保存更改。
- 选择 Secrets 秘密 选项卡。
- 复制 Internal Integration Token 内部集成令牌 并将其添加为您的 n8n Internal Integration Secret 内部整合秘密。
参考内部集成认证流程设置文档{:target=_blank .external-link}了解有关该服务身份验证的更多信息。
通过集成 共享概念页面
要使您的集成与 Notion 交互,您必须为您的集成授予页面权限{:target=_blank .external-link}以与您 Notion 工作区中的页面交互:
- 访问您 Notion 工作区中的页面。
- 选择页面右上角的三点菜单。
- 在 Connections 中,选择 Connect to。
- 使用搜索栏从下拉列表中查找并选择您的集成。
一旦您与集成共享至少一个页面,就可以开始发出 API 请求。如果页面未共享,任何 API 请求都会返回错误。
参考集成权限{:target=_blank .external-link}了解更多信息。
Using OAuth2
要配置此凭据,您需要:
- A Client ID 客户ID:配置公共集成后生成。
- A Client Secret 客户秘密:配置公共集成后生成。
您必须创建 Notion 集成{:target=_blank .external-link}并将其设置为公共分发:
- 转到您的 Notion 集成仪表板。
- Select the + New integration + 新集成 button.
- 输入集成的 Name 名称,例如
n8n integration。如果需要,请添加 Logo 标志。 - 选择 Submit 提交 创建您的集成。
- 打开 Capabilities 能力 选项卡。选择这些功能:
*
Read content*Update content*Insert content*User information without email addresses - 选择 Save changes 保存更改。
- 转到 Distribution 分布 选项卡。
- 打开 Do you want to make this integration public? 您想公开此集成吗? 控制器。
- 在 Organization Information 组织信息 部分输入您的公司名称和网站。
- 复制 n8n OAuth Redirect URL OAuth 重定向 URL 并将其作为 Redirect URI 重定向URI 添加到 Notion 集成的 OAuth Domain & URLs OAuth 域和 URL 部分中。
- 转到 Secrets 秘密 选项卡。
- 复制 Client ID 客户ID 和 Client Secret 客户秘密 并将它们添加到您的 n8n 凭证中。
参考 Notion 的公共集成认证流程设置{:target=_blank .external-link}了解有关该服务身份验证的更多信息。
内部集成与公共集成
内部集成:
- 特定于单个工作区。
- 仅该工作区的成员可访问。
- 非常适合自定义工作区增强。
内部集成使用更简单的身份验证过程(集成密钥),在发布前不需要任何安全审查。
公共集成:
- 可在多个不相关的 Notion 工作区中使用。
- 任何 Notion 用户都可访问,无论其工作区如何。
- 非常适合满足广泛的用例。
公共集成使用 OAuth 2.0 协议进行身份验证。它们在发布前需要 Notion 安全审查。
有关两种集成类型的更详细分解,请参考 Notion 的内部集成与公共集成文档{:target=_blank .external-link}。