为开发者提供稳定、高效的汽水音乐开放接口。通过 REST API 与 WebSocket 实时通道,将海量正版音乐数据、智能推荐算法和用户授权体系集成到你的应用中。
所有接口遵循 RESTful 设计规范,使用 JSON 格式交换数据,支持 OAuth 2.0 授权码流程和 API Key 两种认证方式。
全站搜索接口,支持按歌曲名、歌手、专辑、歌词关键词进行综合搜索。返回结构化歌曲信息包括封面、时长、播放地址等。
获取单首歌曲的完整元数据,包括高音质播放链接、歌词(逐行动态歌词 + 静态文本)、关联歌单、相似歌曲推荐。
获取歌单详情及歌曲列表,支持分页加载。返回歌单创建者信息、播放量、收藏数、标签分类等社交属性数据。
获取歌手/艺术家资料页数据,包括热门歌曲TOP50、专辑列表、相似歌手推荐、艺人简介及高清头像资源。
基于用户画像和听歌历史的个性化推荐Feed流。返回混合内容:单曲、歌单、专辑及推荐理由,支持无限下拉加载。
获取各类排行榜数据:热歌榜、新歌榜、飙升榜、原创榜。支持按地区和语种筛选,每小时更新一次排名数据。
上报用户听歌行为数据(需用户授权),用于构建个人听歌画像。支持批量上报,单次最多提交100条听歌记录。
WebSocket 实时歌词通道。订阅歌曲播放进度后,服务端按时间轴推送当前歌词行,延迟低于50ms,用于实现逐行高亮效果。
官方维护的客户端 SDK,覆盖主流编程语言,开箱即用,持续更新。
关注 API 和 SDK 的最新变化,确保你的应用始终运行在最佳状态。
新增 /ws/v2/lyrics 端点,支持按时间轴推送滚动歌词。同步优化了搜索接口的响应速度,平均延迟降低 22%。修复了歌单接口在大数据量场景下的分页偏移 Bug。
Java SDK 升级至 v2.2.0,支持响应式编程模型(Reactor/RxJava)。推荐 Feed 接口新增场景标签参数,可按运动、学习、通勤等场景返回定制化推荐结果。
发布 Go 语言 SDK v2.1.0。新增 Webhook 回调机制,开发者可订阅用户授权变更、歌曲状态更新等事件。API 文档新增交互式调试控制台。
全面升级至 v2 架构,采用 JSON:API 规范,统一错误码体系,新增请求链路追踪(x-request-id)。废弃 v1 部分旧接口,提供一键迁移工具。
接入汽水音乐开放平台时的常见问题与解答。