跳转到主要内容
能力按服务端配置逐项启用。未启用操作返回 503 且不创建任务;音乐积分扣除当前未启用。

终态通知契约

歌曲成功回调直接发送 SongResult,与查询 data.result 的完整对象一致;其他终态回调使用任务响应外壳,result 为对象/null。投递重试不会重新生成任务。 设计将事件 ID、时间戳和 HMAC-SHA256 签名放在 X-APIstable-* 头,签名覆盖 timestamp + ”.” + 原始正文。接收方快速返回 2xx、事件去重,漏收时查任务;投递失败不重生成或再次扣费。投递前校验并固定公开 IP,拒绝重定向。通过 GET /api/v1/webhooks/secret 获取账户签名密钥。