用途:使用 Notion API 创建和读取页面、数据库(在 2022-06-28 版本中 API 称为 databases)与块,实现对 Notion 内容的程序化增删改查。
主要能力:搜索页面和数据库;获取页面;获取页面内容(块);在数据库中创建页面;查询数据库;创建数据库;更新页面属性;向页面添加块。资料列出了常见属性类型格式,包括标题、富文本、单选、多选、日期、复选框、数字、URL、邮箱、关联。
配置方式:在 https://notion.so/my-integrations 创建集成并复制 API 密钥(以 ntn_ 或 secret_ 开头);用命令 mkdir -p ~/.config/notion 与 echo "ntn_your_key_here" > ~/.config/notion/api_key 保存;并把目标页面或数据库共享给该集成。
请求要点:所有请求需带 Authorization: Bearer $NOTION_KEY、Notion-Version: 2022-06-28 和 Content-Type: application/json,其中 Notion-Version 为必需。资料给出搜索、获取页面、获取块、创建页面、查询数据库、创建数据库、更新页面属性、添加块的 curl 示例,以及标题、富文本、单选等属性写法。
版本说明:2022-06-28 中数据库有 database_id 与 data_source_id 两个 ID;创建页面时用 database_id,查询时用 data_source_id 并调用 POST /v1/databases/{id}/query;搜索结果中数据库以 object 为 data_source 返回。
限制:页面与数据库 ID 为 UUID,可带或不带连字符;API 无法设置数据库视图筛选,只能在界面操作;平均速率约每秒 3 次请求;创建数据库嵌入页面时使用 is_inline: true。其余费用、平台与使用步骤资料暂未提供。