Notion的页面组织结构非常灵活，但是一直没有找到相关介绍，最近了解到一个使用Notion作为后台CMS的项目，浏览了一下源码和Notion API。通过API也能大致了解下官方开放的能力以及相关数据结构。

page内容主要由两部分构成

指定page的基础信息，基础数据结构详见文档，包括：

所有的page都有一个parent，当其parent为database时（也就是当前page为db中的一条记录时）， properties 格式与db的property格式一致。否则 properties 仅包含一个 title属性。

一个页面的内容由多个块(block)组成。这些块被称为页面的子块。每个块都有一个类型，例如段落( paragraph)、标题( heading)或图像(image)。某些类型的块，例如切换列表(toggle list)，还有自己的嵌套子块。

段落块（Paragraph blocks）是文档结构中的一个基本组成单元，block具有一些通用的属性，包括：

除此之外，块还包含了一些特定于其类型的属性，这些属性存储在paragraph 属性中，其内容与具体的block type有关，具体见文档。

以todo block类型为例，paragraph的内容格式如下：

注意

page相关接口包括：

block相关的接口包括：

数据库是 Notion 工作区中的page集合，可以根据需要过滤、排序和组织。允许用户在 Notion 中创建和操作结构化数据。

目前public API不支持两种db：Linked databases、Wiki databases

database数据结构：

properties 中存储DB字段相关定义map，key为字段名称，value为字段属性object，其定义与属性字段类型相关。

向db中插入一个page时，需要指定其属性定义与db属性定义一致，同时parent信息为database的id。

注意：组织上面的properties数据结构比较麻烦，容易出错。所以更好的方案是在构造page记录前使用database的retrieve接口，先获取到db的properties数据结构后再填充相关字段值。

插入page成功后会返回对应的pageid，这时再使用pageid填充block内容即可。

查询db

通过Query接口可以查询db中的部分page。

客户端中的filter设置

查询接口返回db中已过滤&排序的page数组，格式大致如下：

database相关的接口

notion支持两种形态的comment，对page的评论和对文本内容（block）的评论。

通过API访问时需要有page对应的comment权限，包括：

使用公共API可以实现：

不支持的点：

读取page或者block的评论

请求方式：

应答格式详见文档。

增加评论

重点参数为parent（page或者block）、rich-text。