SuperAPI AI 工具集

notion

办公与效率

查看项目

更新于 10-16 02:36

技能介绍

用途:该技能提供调用 Notion API 的参考用法,用于读取与写入 Notion 页面、数据库、区块和用户信息,适合在用户提及 Notion、notion.so、notion.site、分享 Notion 链接或要求查询 Notion 时启用。

主要能力:读取页面元数据与页面内容区块;读取嵌套区块;搜索工作区;查询数据库条目并支持单条件与多条件过滤、排序和分页;获取数据库结构;创建数据库;读取、创建、更新、归档页面;获取与追加区块、删除区块;列出用户和获取当前机器人;支持多种属性类型(标题、富文本、数字、单选、多选、日期、复选框、URL、邮箱、电话、人员、关联)和区块类型(段落、标题、引用、callout、列表、待办、折叠、代码块、分隔线)及富文本注释。

使用方式:通过 HTTP 请求访问 https://api.notion.com/v1/ 各端点,请求头携带 Authorization: Bearer $NOTION_TOKEN 与 Notion-Version: 2022-06-28。常用示例包括读取页面、查询数据库、创建页面、追加区块等,命令与请求体需按资料原样使用,其中占位符需替换为实际页面 ID 或数据库 ID。分页采用游标机制,通过 next_cursor 与 start_cursor 翻页。

排查方式:若请求失败,可运行 zero doctor check-connector --env-name NOTION_TOKEN 或 zero doctor check-connector --url https://api.notion.com/v1/pages --method GET。

限制:速率限制平均约每秒 3 次请求,突发可更高,遇到 429 需使用指数退避重试。接口版本固定为 2022-06-28。资料未提供收费、价格或平台支持等信息。集成设置见 https://www.notion.so/profile/integrations,主文档见 https://developers.notion.com。