用途:实现经过验证的 Notion 连接 Webhook 接收流程,涵盖去重、有界处理与拉取当前状态对账,在触发实际动作前产出可审计的决策或产物。
主要能力:Notion 通过一次性令牌验证订阅,对后续原始请求体以 HMAC-SHA256 在 X-Notion-Signature 中签名。事件可能聚合、乱序到达,且不包含完整变更内容,因此需要拉取当前状态进行对账。流程要求先验证原始请求体签名,再进行 JSON 解析或队列确认;持久化去重键、事件时间戳、实体标识、尝试次数与处理状态并绑定租户;快速确认、异步处理、拉取最新状态,并使下游工作保持幂等;定期对账遗漏、聚合、乱序、重复或过期的信号。
使用方式:先确定订阅的事件类型、数据所有者、目标、保留策略和当前订阅 API 版本;实现验证握手,不在门户步骤之外记录或回显令牌;在解析或确认前验证原始请求体签名;使用读取、检索类工具检查文档、配置、代码与证据,仅在获批的仓库产物上写入或编辑。创建、变更或删除订阅需工作区与数据所有者批准;重放、回填及下游写入需另行批准。
适用场景:需对 Notion 工作区事件做出可靠响应、要求可审计与去重、并需处理乱序或聚合事件的集成。
限制:调用本身不授权网络访问、凭据、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、花费或删除。签名缺失或格式错误须在解析前拒绝;不得信任投递顺序或将事件负载当作完整当前内容;未知事件类型应隔离并保留内容安全的回执。需依赖当前第一方文档和所选集成经过测试的 API 版本契约,运行时行为应视为环境特定证据,而非通用保证。具体价格与官方文档未提供。