如何通过Notion API获取「Getting Started」节点的数据库ID？

核心原因 #

「Getting Started」这类页面本质是数据库的前端视图页面，而非数据库本身的直接入口，所以你直接用URL里的UUID或路径段调用数据库API会失败——那个UUID是视图页面的ID，不是底层数据库的ID。

正确获取步骤 #

1. 定位视图页面ID
   调用Notion API的search接口，精准找到这个视图页面：

   POST /v1/search
   Content-Type: application/json
   
   {
     "query": "Getting Started",
     "filter": {
       "property": "object",
       "value": "page"
     }
   }
   

   从返回结果里找到匹配页面的id字段，这就是视图页面的ID。

2. 提取关联的数据库ID
   用拿到的视图页面ID调用页面详情接口：

   GET /v1/pages/{page_id}
   

   从返回的JSON里找以下两种情况：

   • 如果页面是数据库的嵌入视图，查看properties中类型为database_id的属性值；
   • 如果页面的父级是数据库，查看parent字段：当parent.type为database_id时，parent.database_id就是目标数据库ID。

3. 内联数据库的特殊处理
   如果「Getting Started」是Notion默认的引导内联数据库，需要遍历页面的子块：

   GET /v1/blocks/{page_id}/children
   

   找到类型为database的子块，其database_id字段就是你要的数据库ID。

验证方法 #

拿到数据库ID后，调用数据库详情接口验证：

GET /v1/databases/{database_id}

如果成功返回数据库的属性、结构信息，说明ID正确。

内容的提问来源于stack exchange，提问作者Jörn Guy Süß