type
Post
status
Published
date
slug
summary
tags
category
icon
password
Property
Feb 25, 2026 01:30 PM
文章来源
一、 核心范式转移：从“数据库”到“数据源”
在 2025 年 9 月之后的 API 版本中，Notion 彻底解耦了展示层与数据层。
- 旧逻辑（2025以前）：Database = Data。操作 ID 即可完成所有增删改查。
- 新逻辑（2025以后）：
- 数据库 (Database)：仅作为前端展示的“外壳”容器。
- 数据源 (Data Source)：数据的真实“灵魂”与存储地。所有涉及数据行（Pages）的增删改查，必须通过 Data Source ID 进行。
二、 关键参数对照表 (CRUD 实战)
场景 | 接口 (Endpoint) | 关键参数设置 | 备注 |
查询数据 | POST /v1/data_sources/{id}/query | 必须使用 Data Source ID | 以前是 databases/{id}/query |
新增数据 | POST /v1/pages | parent: { type: "data_source_id", data_source_id: "..." } | 最核心变化： parent 类型不再是 database_id |
修改数据 | PATCH /v1/pages/{page_id} | 直接操作 Page ID 即可 | 与旧版保持一致 |
修改结构 | PATCH /v1/data_sources/{id} | 用于修改列名、属性类型 (Schema) | 以前操作对象是数据库 |
- 作者:Blacksmith
- 链接:https://www.lhuafmaof.cn//article/3122fd79-8cf0-8025-b91f-e89539863fae
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
