跳转到主要内容

终态通知契约

通用终态回调使用任务响应外层结构,result 为对象/null。部分模型另有成功回调正文格式,须按所选模型的回调契约解析,不能假定所有回调均与任务查询同构。投递重试不会重新生成任务。 设计将事件 ID、时间戳和 HMAC-SHA256 签名放在 X-APIstable-* 头,签名覆盖 timestamp + ”.” + 原始正文。接收方快速返回 2xx、事件去重,漏收时查任务;投递失败不重生成或再次扣费。投递前校验并固定公开 IP,拒绝重定向。从控制台 → 账户设置 → Webhook 安全复制账户签名密钥;24 小时重置过渡期内,逗号分隔的 v1 签名任一匹配即可。 签名密钥与验签示例