otherNoteTb: 1484
This data as json
| id | source | method | user_id |
|---|---|---|---|
| 1484 | notion | # Notion 搬家接口方法 ## 接入方式 Notion 提供官方 REST API（https://api.notion.com/v1）。 ### 获取 Token 1. 访问 https://www.notion.so/developers/connections 创建 Connection，或创建 Personal Access Token。 2. 至少勾选 Read content。 3. 在 keng 账号设置页保存 Token（`ntn_xxx` 或旧格式 `secret_xxx`），不要写入全局 config.ini。 4. Connection Token 只能读取已授权给该 Connection 的页面/数据源；Internal Connection 需要在 Notion 页面右上角 ··· → Connections 添加，Public Connection 需要 OAuth 页面选择器授权，PAT 则按创建者用户权限读取。 ## 接口说明 - Header: `Authorization: Bearer {token}`，`Notion-Version: 2022-06-28` - `POST /v1/search`：搜索所有已授权给当前 token/connection 的 page，body `{"filter":{"value":"page","property":"object"}}` - `GET /v1/blocks/{page_id}/children?page_size=100`：递归获取 page 下所有 block - 常用 block 类型转 Markdown：paragraph、heading_1/2/3、bulleted_list_item、 numbered_list_item、to_do、code、quote、divider、table ## 搬家流程 1. `POST /v1/search` 分页列出当前 token 有权访问的 page。 2. 用户勾选要搬的 page。 3. 后端递归调 `/v1/blocks/{id}/children` 把 block 转 Markdown。 4. 写入 keng `noteTb`；comment 写 `source=notion; source_id={page_id}`。 | 1 |