使用Notion API创建/检索数据库时遇到的问题

一、检索数据库404错误的解决方案 #

• 核心原因：Notion集成无权访问目标数据库。即便API认证通过，集成必须被明确共享到目标数据库。
• 操作步骤：
  1. 打开目标Notion数据库页面
  2. 点击右上角「分享」按钮
  3. 在分享面板中搜索你的Notion集成名称，添加并赋予对应权限（编辑/只读）
• 格式提示：Notion API要求数据库ID为带连字符的格式（1e840ea2-2827-4c6d-8c84-f085b527a6b3），无连字符ID会被自动转换，但权限问题才是404的主要诱因。

二、获取数据库/页面响应为空的问题 #

• 本质仍是权限问题：集成未被共享到目标资源时，API会返回空列表而非错误，这是Notion API的默认逻辑。
• 验证方法：先调用GET /v1/users/me确认认证正常，再检查所有需访问的数据库/页面是否已共享给集成。

三、创建新数据库提示Page ID错误的问题 #

• 你对API要求存在误解：创建数据库的POST /v1/databases接口必须指定父页面ID，数据库必须依附于某个Notion页面，无法独立创建。
• 关键请求参数示例：

{
  "parent": {
    "type": "page_id",
    "page_id": "你的父页面ID"
  },
  "title": [
    {
      "type": "text",
      "text": {
        "content": "新数据库"
      }
    }
  ],
  "properties": {
    "Name": {
      "title": {}
    }
  }
}

内容的提问来源于stack exchange，提问作者Steven