YeeHooDevelopers
开发者文档

Webhook 回调

接收带签名的任务、余额和充值事件,同时保留轮询兜底。

Webhook 配置随 API Key 保存,投递的任务和计费事件均属于该 Key 对应的团队工作空间。Webhook 与轮询可以同时使用;当接收方不可用时,轮询仍是恢复路径。

推送事件

  • 任务事件:task.succeededtask.failedtask.canceled
  • 计费事件:balance.lowcredits.granted
  • v1 不推送 running 进度
  • 负载统一为 { id, type, created_at, api_version, data }

验签

请求头:

  • Yeehoo-Event
  • Yeehoo-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;修复接收方后可重新启用

本页目录