SuperAPI AI 工具集

hex-webhooks-events

通用与其它

查看项目

更新于 10-15 23:26

技能介绍

用途:该技能面向为 Hex 构建事件驱动集成的场景,说明 Hex 不提供推送 webhook,因此需通过轮询运行状态,或在运行完成时自建通知系统。资料提到可用于设置 webhook 端点、实现签名校验或处理 Hex 事件。

主要能力与用法:给出 runWithCallback 示例,调用 client.runProject 取得 runId,再以 client.getRunStatus 每 5000 毫秒轮询,状态 COMPLETED 时回调 onComplete,ERRORED 或 KILLED 时回调 onError。完成通知示例在回调中 fetch 到 SLACK_WEBHOOK_URL,发送运行完成文本。

前置条件:需 secret-manager webhook secret、origin allowlist、replay-window policy、opaque event ledger,以及沙箱接收端和经过测试的禁用/取消控制。

输出与错误处理:返回事件回执,含 type、opaque event/run ID、signature/timestamp 结果、幂等结果、队列状态、canary 结果与回滚引用,不含 payload、SQL、输出和签名。遇到未知来源、过期或重放投递、畸形 payload、未知项目目的地或非幂等重试时拒绝,并在完整性不确定时隔离 opaque 事件并禁用消费者。示例:type=run.completed; event=evt-opaque-9; signature=pass; replay=absent; project=proj-sandbox-12; enqueue=once; rollback=consumer-disabled。资源指向 Hex API。未提供的收费、价格、平台等事实暂未提供。