对接概览
合作方实现接收接口并校验 Bearer 密钥即可完成对接。完整字段与示例见桌面端文档。
鉴权方式
Authorization: Bearer <push_api_key>
建议支持双密钥过渡，便于轮换。
接收曲目 API
你们提供：POST /api/receive-track
POST https://your-site.com/api/receive-track Content-Type: application/json
{"track_id":"7617","title":"Track Title","audio_file_url":"https://official.example.com/api/stream/7617/compressed"}
字段说明
核心字段：track_id、title、artist、audio_file_url、is_preorder、artwork_url、price、metadata；预购曲目可能含 preview_file_url。
渠道跳转链接（可选）
GET https://official.example.com/track/7617?from=partner&partner_site_id=12
事件回传（可选）
POST https://official.example.com/api/partner/report/event
{"partner_site_id":12,"event_id":"evt_xxx","event_type":"click","track_id":7617}
下载授权（可选）
POST https://official.example.com/api/partner/fulfillment/download-token
签名与验签（可选）
推荐 HMAC-SHA256；拼接规则以合作约定为准。
错误码与重试
- 2xx：成功
- 401/403：鉴权问题
- 5xx：可重试（需幂等）
常见问题
请使用 track_id 做幂等；详见桌面端完整说明。