用途:在集成 Notion 时构建带版本感知的 SDK 边界层,用领域术语封装官方 JavaScript SDK,而不是直接导出整个客户端。适合编写或审查 Notion 客户端代码。
主要能力:定义窄接口;固定 SDK 与已测试 API 版本并维护升级矩阵;实现数据源身份解析、完整分页、属性解码与未知字段容错;对结构化错误和 Retry-After 分类后再做有界重试;在写入边界加入幂等与回读;用固定样本和非生产契约通道测试适配器。官方 JS SDK 提供数据库、数据源、页面、块、文件、搜索和认证操作。
用法要点:客户端从密钥提供方和绑定租户的连接配置构建,凭证不通过业务方法参数传入或出现在错误中。用 Read、Glob、Grep 检查文档、配置、代码与样本;只有获批的仓库产物才可写。调用本身不授权网络访问、凭证、工作区内容、文件传输、部署、权限变更、写入或删除。新增操作、能力、用户字段、内容类型或实时写入测试前需评审。
验证路径:多页、未知字段、错误 ID 类型、429、写入超时、SDK 升级,记录预期与实际结果。
限制:需当前第一方文档与已测试 API 版本契约、指定负责人、去除密钥与工作区内容的合成样本;不得把旧数据库查询响应强制转换为当前数据源类型,不得重试所有异常,不得让 SDK 默认值静默决定生产契约;观察到的租户行为只是环境证据。资料未提供具体安装命令、收费与价格。