如何通过Notion API检查页面是否共享给整个工作区？

核心结论 #

目前Notion公开API（包括你使用的2022-06-28版本）没有直接提供字段或端点来读取页面的通用共享权限状态（仅限受邀人员/工作区全员/拥有链接的任何人）。

关于你尝试操作的补充说明 #

• 页面检索、块列表、搜索等公开端点返回的响应数据中，确实不存在permissions、sharing、visibility这类直接关联全局共享设置的字段。Notion公开API的设计逻辑聚焦于集成自身的授权访问范围，而非页面的全局共享配置。
• parent.type仅标识页面的归属层级（如工作区根目录、数据库子页面等），和页面的共享权限完全无关——即使页面处于工作区根目录，也可能仅对特定受邀人员开放。

非官方替代思路（谨慎使用） #

如果必须实现该需求，有两种非官方方式，但均存在风险：

• 内部API调用：Notion有未公开的内部API可获取共享权限信息，但这类接口无官方文档支持，随时可能变更/失效，且违反Notion API使用条款，不推荐。
• 间接权限验证：若工作区允许，可创建一个无特殊权限的测试用户，用其授权的集成尝试访问目标页面，通过访问结果间接判断页面是否对全员开放。但这种方法需要额外账号资源，且无法区分“工作区全员”和“拥有链接的任何人”两种共享状态。

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