SuperAPI AI 工具集

attio-webhooks-events

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:实现 Attio 事件投递边界的完整流程——校验原始载荷、在投递窗口内确认、安全地至少一次处理,并对遗漏或延迟事件进行对账。

主要能力:读取 Attio-Signature(旧版可能为 X-Attio-Signature);用 webhook secret 对精确的原始 UTF-8 请求体计算 SHA-256 HMAC 并安全比较十六进制签名;校验通过并持久接收后快速返回 2xx(Attio 文档为 5 秒超时);投递为至少一次,使用 Idempotency-Key 去重;文档称最多重试 10 次、约三天,单目标 URL 限 25 请求/秒,上线前需重新核实。

使用方式:在 body 解析中间件之前捕获原始字节;读取签名头、解码期望十六进制并拒绝畸形或长度不等值;用定时安全等长比较;校验事件信封并以事务方式预留 Idempotency-Key;持久化入队后按时限返回 2xx;以有界并发幂等处理,含死信处理与脱敏遥测;测试有效、无效、重复、乱序、延迟、突发、队列失败与密钥轮换等场景;对账权威 Attio 状态以防永久漂移。密钥须服务端存储,签名校验先于 JSON 解析、日志、入队或任何状态变更,并支持受控轮换。

限制:未经负责人与回滚控制,不得创建生产订阅、轮换密钥、重放事件或变更下游客户状态。签名缺失或无效应拒绝且不解析、无副作用;幂等键已提交则返回成功不重复工作;持久队列不可用应返回失败以便重试;处理超时应将工作移至队列后方并提前确认。具体官方文档与 REST API 细节暂未提供。