Z Tag
管理组织服务与凭证配置

Notion

创建 Notion integration 并向它开放页面。

适用于组织 Owner / Admin;成员的个人连接器同样适用

在连接器的 访问内容 → 添加访问 中,从 服务预设 选择 Notion,使用 推荐配置。

获取与填写凭证

  1. 在 Notion 的 My integrations 创建对应 workspace 的 integration。
  2. 按用途选择读取、更新或插入内容能力,复制 integration 的内部访问 Token。
  3. 在需要访问的页面中添加该 integration 作为 Connection,分享页面给它;仅创建 Token 不会自动开放所有页面。
  4. 将 Token 填入 API Key / Token。

官方说明:Notion 身份认证。

服务地址

推荐配置固定使用 https://api.notion.com,路径为 /v1;其他地址改用 自定义。请求需要在 Notion-Version 请求头中指定所用的 API 版本。

验证

保存后请 ZAI 读取一次这个 integration 的 bot 用户(GET /v1/users/me),确认凭证可用。请求失败时,检查 Token 是否仍然有效、integration 是否具备所需的读取、更新或插入能力、页面是否已分享给该 integration,以及请求是否带了 Notion-Version。其余排查见验证与排错。

本页目录