SuperAPI AI 工具集

polytomic-webhooks

安全与审计

查看项目

更新于 10-15 22:14

技能介绍

用途:本技能用于构建 Polytomic Webhook 目的地接收端。Polytomic 是数据搬运平台,Webhook 作为 Model Sync 的目标,按调度以批量方式 POST 变更记录,应理解为“接收同步记录批次”,而非订阅事件。

主要能力:解析唯一事件类型 sync.records;处理批次负载 object.records,默认每批 100 条且可配置;使用每条记录的 hash 做去重或幂等键;按 event 字段路由,未知事件应返回 200 忽略。

认证与用法:Polytomic 不签名,无 HMAC、摘要或签名密钥。唯一认证是设置连接时提供的静态 Bearer 密钥,需与 Authorization 头做常量时间逐字节比较。Polytomic-Signature-Timestamp 不是签名,只是 RFC 3339/ISO 8601 UTC 时间戳,仅用于新鲜度检查,需用 new Date(value) 或 datetime.fromisoformat 解析,不能用 parseInt。密钥缺失时应 fail closed 返回 500,不匹配返回 401。

响应与限制:收到负载应返回 200 OK,任何 4xx/5xx 会使该同步在 Polytomic 中显示失败;官方未公布重试策略或重试计划。字段 keys 由同步配置定义,无固定 schema,应防御性读取并容忍缺失键。首次同步可能因回填产生巨大批次。官方列出了可加白名单的来源 IP,但不适用于自托管部署,且不应作为认证手段。

本地开发:npx hookdeck-cli listen 3000 polytomic --path /webhooks/polytomic