Notion / 效率工具
Notion 协作工作区 API
通过官方版本化 Notion API 管理页面、块、数据源/数据库、评论、文件上传、视图、用户与搜索,并支持 OAuth 与异步任务。完整边界为官方 OpenAPI 快照中的 49 个 Endpoint;工作区数据为私有用户内容,Pontx 不代理、缓存或聚合,调用方使用本地 SDK/CLI 直连。
鉴权设置
先完成当前浏览器会话的凭证与授权设置,再进入请求调试。
以 Workspace Owner 身份在 Notion Creator Dashboard 创建 Internal connection。
在 Configuration 中复制 installation access token,并只授予最低必要 capabilities。
把需要访问的页面通过 Add connections 分享给该连接,再将 token 仅保存到 NOTION_ACCESS_TOKEN。
在 Notion Creator Dashboard 创建 Public connection,并设置安装范围、回调地址和最低必要 capabilities。
从 Configuration 复制 OAuth Client ID 与 Client Secret,并只在服务端保存。
让用户完成授权,再由服务端使用 HTTP Basic 交换授权码;不要把 Client Secret 暴露给浏览器。
GET /v1/users/me
查询当前连接身份
返回当前访问令牌对应的连接(机器人或用户)资料;个人访问令牌返回创建该令牌的用户。