API 接口

公共 API

搜索歌曲

POST /api/search

{ "keyword": "歌曲名", "page": 1 }

获取播放 URL

POST /api/play_url

{ "song_data": { "mid": "歌曲MID" }, "prefer_flac": true }

下载歌曲

POST /api/download

{
  "song_data": { "mid": "...", "name": "...", "raw_data": {...} },
  "prefer_flac": true,
  "add_metadata": true
}

获取歌词

GET /api/lyric/<song_mid>

获取封面

POST /api/cover

{ "song_data": { "raw_data": {...} }, "size": 800 }

图片代理

GET /api/image_proxy?url=https://y.gtimg.cn/...

凭证状态

GET /api/credential/status

健康检查

GET /api/health

---

管理 API

管理页面

GET /admin/

生成登录二维码

GET /admin/api/get_qrcode/<type>

type: qq 或 wx

查询二维码状态

GET /admin/api/qr_status/<session_id>

取消二维码会话

POST /admin/api/qr_cancel/<session_id>

检查凭证状态

GET /admin/api/credential/status

刷新凭证

POST /admin/api/credential/refresh

获取凭证信息

GET /admin/api/credential/info

清空音乐文件夹

POST /admin/api/clear_music

完整文档

更详细的请求/响应格式，请参考 API doc.md