API Reference

Public API

Search Songs

POST /api/search

{ "keyword": "song name", "page": 1 }

Get Play URL

POST /api/play_url

{ "song_data": { "mid": "song_mid" }, "prefer_flac": true }

Download Song

POST /api/download

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

Get Lyrics

GET /api/lyric/<song_mid>

Get Cover

POST /api/cover

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

Image Proxy

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

Credential Status

GET /api/credential/status

Health Check

GET /api/health

---

Admin API

Admin Page

GET /admin/

Generate Login QR Code

GET /admin/api/get_qrcode/<type>

type: qq or wx

Query QR Code Status

GET /admin/api/qr_status/<session_id>

Cancel QR Code Session

POST /admin/api/qr_cancel/<session_id>

Check Credential Status

GET /admin/api/credential/status

Refresh Credential

POST /admin/api/credential/refresh

Get Credential Info

GET /admin/api/credential/info

Clear Music Folder

POST /admin/api/clear_music

Full Documentation

For detailed request/response formats, refer to API doc.md