Webhook 回调
接收带签名的任务、余额和充值事件,同时保留轮询兜底。
Webhook 配置随 API Key 保存,投递的任务和计费事件均属于该 Key 对应的团队工作空间。Webhook 与轮询可以同时使用;当接收方不可用时,轮询仍是恢复路径。
推送事件
- 任务事件:
task.succeeded、task.failed、task.canceled - 计费事件:
balance.low、credits.granted - v1 不推送
running进度 - 负载统一为
{ id, type, created_at, api_version, data }
验签
请求头:
Yeehoo-EventYeehoo-Signature: t=<unix>,v1=<hex>X-Yeehoo-Delivery-ID
用 HMAC-SHA256(secret, "{timestamp}.{raw_body}") 校验 v1。保留原始 body、校验时间戳、按 id 或投递 ID 去重,并在耗时处理前先返回 2xx。
重试
- 超时:5 秒
- 最多 8 次
- 退避:
min(2^n * 10s, 6h),附带 ±20% 抖动 - 仅 429、5xx 和网络超时会重试
- 连续 20 次失败会禁用 endpoint;修复接收方后可重新启用