01 / ONLINE MUSIC SERVICE
把声音,送到
你的设备。
面向 ESP32 的轻量音乐入口。搜索只负责找歌,详情接口负责在播放前解析真实音源、格式和 MIME;每一条 URL 都按需获取,适合固件即时拉流。
FORMAT FIRSTMP3 / AAC 直接播放
FLAC / WAV 明确标记为需额外解码
临时直链 · 获取后尽快使用
FLAC / WAV 明确标记为需额外解码
临时直链 · 获取后尽快使用
Search / Library0 TRACKS
FORMAT STATUS / 点击歌曲后解析
输入 apikey 后搜索
真实格式会在 /detail 响应返回时回填
真实格式会在 /detail 响应返回时回填
Track / Signal ReportNO SIGNAL
选择一首歌
查看来源、MIME、码率和 ESP32 播放状态
查看来源、MIME、码率和 ESP32 播放状态
02 / FIRMWARE CONTRACT
给 ESP32 的最短路径
固件不需要猜扩展名,也不要缓存永久 URL。先搜索拿到 ID,再请求 detail;读取 data.format 后按 MIME 选择解码器,并立即消费 data.url。
01 Header 使用
apikey02 推荐接受
audio/mpeg03
urlKind=temporary-directREQUEST / RESPONSE SHAPE