SuperAPI AI 工具集

juicebox-webhooks-events

通用与其它

查看项目

更新于 10-15 23:26

技能介绍

用途:Juicebox 通过 Webhook 推送 AI 人员搜索与分析工作流的事件通知,可订阅分析完成、数据集更新、导出就绪、配额预警等事件,构建实时响应的自动化流水线,无需轮询 API。

主要能力:支持注册 Webhook(POST https://api.juicebox.ai/v1/webhooks,携带 url、events、secret);通过 x-juicebox-signature 头与 HMAC-SHA256 校验签名;事件类型包括 analysis.completed、dataset.updated、export.ready、quota.warning、search.alert,各自带不同载荷字段。

使用方式:用 express.raw 接收原始请求体后校验签名,解析事件并按 type 分发处理;用事件 ID 做幂等去重,限制已处理集合大小;导出链接有 1 小时 TTL,需在 export.ready 时立即下载;配额超限后按 reset_date 退避。

限制与注意:需配置密钥管理、来源允许列表、重放窗口策略、来源权威校验、抑制策略与不透明事件账本;先认证来源再解析,校验时间戳与事件 ID,拒绝未知来源、过期投递与畸形载荷;仅存储有界脱敏信封,以事件 ID 加目标修订号作为幂等键;不确定时隔离而非导出或丰富联系人;先在沙箱金丝雀验证再启用;重试耗尽转入人工恢复,不重放非幂等写入。输出事件回执需排除载荷联系人数据与签名。具体收费、价格与平台支持暂未提供。