> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apistable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 任务回调

> 接收任务终态通知。

> 能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务；音乐积分扣除当前未启用。

## 终态通知契约

歌曲成功回调直接发送 SongResult，与查询 data.result 的完整对象一致；其他终态回调使用任务响应外壳，result 为对象/null。投递重试不会重新生成任务。

设计将事件 ID、时间戳和 HMAC-SHA256 签名放在 X-APIstable-\* 头，签名覆盖 timestamp + "." + 原始正文。接收方快速返回 2xx、事件去重，漏收时查任务；投递失败不重生成或再次扣费。投递前校验并固定公开 IP，拒绝重定向。通过 GET /api/v1/webhooks/secret 获取账户签名密钥。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.