Music

Music aggregation: scraping Aiting Music (home/singer/song/search) plus CRUD for the XiaoYing Music library. 2 channels are currently integrated.

/api/music/

Service Description

The music service aggregates two channels: Aiting Music (2t58) provides home charts, singers, song details, playback links with lyrics, and keyword search, making it suitable for building an online music search and playback page; XiaoYing Music is the platform's own library, offering CRUD for music and its playback sources plus JSON bulk import and export.

Both channels require project signature authentication. Data on the 2t58 channel is scraped from an external site in real time and playback links may expire, so avoid caching them on the client for long.

For XiaoYing Music, the import API accepts a single file up to 10 MB and up to 9999 records per call and does not de-duplicate; when an export exceeds 9999 records it returns a zip archive (containing several JSON parts) that can be imported back directly.

Response Format

Every endpoint returns the same JSON envelope; the payload is always inside data:

{
  "code": 10000,
  "msg": "成功",
  "data": { ... }
}

code: business status code. 10000 means success; anything else is an error — see the Error Codes page for the full list.
msg: a human-readable message you can show to end users, but never use it for program logic.
data: the payload; usually null on error. Each endpoint's Response section lists its data fields.

Judge success by code, not by the HTTP status code. View all error codes

Aiting Music 2t58

2t58.com web scraping (read-only) Signature Required

Scrape trending/singer/song/search data. The url parameter must be a 2t58.com domain address.

GET /api/music/2t58/home Total calls: 0

Home Data

Returns three modules: trending singers, song rising chart and pop trend chart.

Response Common envelope

Field	Type	Description
hot_singers	array	Hot singers
hot_singers[].name	string	Singer name
hot_singers[].image	string	Avatar image URL
hot_singers[].singer_url	string	Singer page URL
rising_chart	array	Rising songs chart
rising_chart[].song_name	string	Song name
rising_chart[].artists	array	Singer name list
rising_chart[].song_url	string	Song page URL
trend_chart	array	Trending chart
trend_chart[].song_name	string	Song name
trend_chart[].artists	array	Singer name list
trend_chart[].song_url	string	Song page URL

Example response

{
  "hot_singers": [
    {"name": "示例歌手", "image": "https://img.2t58.com/xxx.jpg",
     "singer_url": "https://www.2t58.com/singer/bm1z/1.html"}
  ],
  "rising_chart": [
    {"song_name": "示例歌曲", "artists": ["示例歌手"],
     "song_url": "https://www.2t58.com/song/d3dkc2t3.html"}
  ],
  "trend_chart": [
    {"song_name": "示例歌曲", "artists": ["示例歌手"],
     "song_url": "https://www.2t58.com/song/d3dkc2t3.html"}
  ]
}

GET /api/music/2t58/singer Total calls: 0

Singer Detail

Singer basic info + song list (paginated).

Singer Page URL url *

Full URL of the 2t58.com singer-song list page (Required)

Response Common envelope

Field	Type	Description
singer	object	Singer basic info
singer.name	string	Singer name
singer.cover	string	Cover image URL
singer.intro	string	Singer bio
songs	array	Song list
songs[].song_name	string	Song name
songs[].artists	array	Singer name list
songs[].song_url	string	Song page URL
pagination	object	Pagination info; null when unavailable
pagination.current	object	Current page {page,url}
pagination.current.page	int	Page Number
pagination.current.url	string	Page URL
pagination.first	object	First page {page,url}; null when absent
pagination.prev	object	Previous page {page,url}; null when absent
pagination.next	object	Next page {page,url}; null when absent
pagination.last	object	Last page {page,url}; null when absent

Example response

{
  "singer": {"name": "示例歌手", "cover": "https://img.2t58.com/xxx.jpg",
             "intro": "歌手简介"},
  "songs": [
    {"song_name": "示例歌曲", "artists": ["示例歌手"],
     "song_url": "https://www.2t58.com/song/d3dkc2t3.html"}
  ],
  "pagination": {
    "current": {"page": 1, "url": "https://www.2t58.com/singer/bm1z/1.html"},
    "first": null,
    "prev": null,
    "next": {"page": 2, "url": "https://www.2t58.com/singer/bm1z/2.html"},
    "last": {"page": 5, "url": "https://www.2t58.com/singer/bm1z/5.html"}
  }
}

GET /api/music/2t58/song Total calls: 0

Song Detail

Song basic info + playback URL + lyrics + daily recommendations.

Song Page URL url *

Full URL of the 2t58.com song detail page (Required)

Response Common envelope

Field	Type	Description
song	object	Song basic info
song.song_name	string	Song name
song.artists	array	Singer name list
song.cover	string	Cover image URL
play_url	string	Play URL (decrypted); empty string on failure
lyrics	string	Lyrics in LRC format; empty string on failure
daily_recommend	array	Random recommendations
daily_recommend[].song_name	string	Song name
daily_recommend[].artists	array	Singer name list
daily_recommend[].song_url	string	Song page URL

Example response

{
  "song": {"song_name": "示例歌曲", "artists": ["示例歌手"],
           "cover": "https://img.2t58.com/xxx.jpg"},
  "play_url": "https://music.2t58.com/xxx.mp3",
  "lyrics": "示例歌词",
  "daily_recommend": [
    {"song_name": "示例歌曲", "artists": ["示例歌手"],
     "song_url": "https://www.2t58.com/song/d3dkc2t3.html"}
  ]
}

GET /api/music/2t58/search Total calls: 0

Search Music

Search songs by keyword (paginated).

Keyword keyword *

Search keyword (Required)

Page Number page

Optional: page number, a positive integer, Default 1

Response Common envelope

Field	Type	Description
songs	array	Search result songs
songs[].song_name	string	Song name
songs[].artists	array	Singer name list
songs[].song_url	string	Song page URL
pagination	object	Pagination info; null when unavailable
pagination.current	object	Current page {page,url}
pagination.current.page	int	Page Number
pagination.current.url	string	Page URL
pagination.first	object	First page {page,url}; null when absent
pagination.prev	object	Previous page {page,url}; null when absent
pagination.next	object	Next page {page,url}; null when absent
pagination.last	object	Last page {page,url}; null when absent
total	int	Total search results

Example response

{
  "songs": [
    {"song_name": "示例歌曲", "artists": ["示例歌手"],
     "song_url": "https://www.2t58.com/song/d3dkc2t3.html"}
  ],
  "pagination": {
    "current": {"page": 1, "url": "https://www.2t58.com/so/%E7%8E%8B%E5%B0%8F%E8%8D%89/1.html"},
    "first": null,
    "prev": null,
    "next": {"page": 2, "url": "https://www.2t58.com/so/%E7%8E%8B%E5%B0%8F%E8%8D%89/2.html"},
    "last": {"page": 3, "url": "https://www.2t58.com/so/%E7%8E%8B%E5%B0%8F%E8%8D%89/3.html"}
  },
  "total": 30
}

XiaoYing Music

Own music library (Music/MusicSource data) Signature Required

RESTful CRUD for music and its playback sources; the music detail API also returns all of its playback sources.

GET /api/music/xiaoying/musics Total calls: 0

Query Music List

Query music by keyword/online status (paginated); when online is omitted, only online music is returned by default.

Keyword keyword

Optional: match music name/singer

Online Status online

Optional: true/false

Page Number page

Optional: defaults to 1

Page Size page_size

Optional: 1-100, Default 10

Response Common envelope

Field	Type	Description
items	array	Music list
items[].id	string	Music UUID
items[].name	string	Music Name
items[].singer	array	Singer list
items[].online	bool	Is online
items[].create_time	string	Created
items[].updated_time	string	Updated time
total	int	Total count
page	int	Current page
page_size	int	Page Size
total_pages	int	Total pages

Example response

{
  "items": [
    {"id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b", "name": "示例歌曲",
     "singer": ["示例歌手"], "online": true,
     "create_time": "2026-10-01 12:00:00", "updated_time": "2026-10-01 12:00:00"}
  ],
  "total": 1,
  "page": 1,
  "page_size": 10,
  "total_pages": 1
}

POST /api/music/xiaoying/musics Total calls: 0

Create Music

Create a music record and return music_id (UUID), for use in detail lookups / playback source association.

Music Name name *

Music name (Required)

Singer singer *

Singer (Required, at least one)

Multiple values: Separate multiple singers with commas or line breaks (the server splits repeated parameters into a singer list)

Online Status online

Optional: Default true

Deduplication rule: the same name and same singer (ignoring order, case and leading/trailing spaces) counts as a duplicate and returns 20031; the same name with a different singer (extra, missing or changed) can be stored normally.

Response Common envelope

Field	Type	Description
id	string	Music UUID (music_id)
name	string	Music Name
singer	array	Singer list
online	bool	Is online
create_time	string	Created
updated_time	string	Updated time

Example response

{
  "id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b",
  "name": "示例歌曲",
  "singer": ["示例歌手"],
  "online": true,
  "create_time": "2026-10-01 12:00:00",
  "updated_time": "2026-10-01 12:00:00"
}

GET /api/music/xiaoying/musics/<uuid> Total calls: 0

Get Music Detail

Get a single music record by music UUID, returning all of its playback sources (music_sources) as well.

Music UUID music_id *

Path parameter: music UUID (when testing from this doc page, replace <uuid> in the URL)

Response Common envelope

Field	Type	Description
id	string	Music UUID
name	string	Music Name
singer	array	Singer list
online	bool	Is online
create_time	string	Created
updated_time	string	Updated time
music_sources	array	Play sources of this music
music_sources[].id	string	Playback Source UUID
music_sources[].music_id	string	Owning music UUID
music_sources[].url	string	Playback URL
music_sources[].create_time	string	Created
music_sources[].updated_time	string	Updated time

Example response

{
  "id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b",
  "name": "示例歌曲",
  "singer": ["示例歌手"],
  "online": true,
  "create_time": "2026-10-01 12:00:00",
  "updated_time": "2026-10-01 12:00:00",
  "music_sources": [
    {"id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
     "music_id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b",
     "url": "https://music.example.com/xxx.mp3",
     "create_time": "2026-10-01 12:00:00", "updated_time": "2026-10-01 12:00:00"}
  ]
}

PATCH /api/music/xiaoying/musics/<uuid> Total calls: 0

Update Music

Partially update music (singer replaces the whole list).

Music UUID music_id *

Path parameter: UUID of the music to update

Music Name name

Optional: new name

Singer singer

Optional: replace the entire singer list

Multiple values: Separate multiple singers with commas or line breaks (the server splits repeated parameters into a singer list)

Online Status online

Optional: true/false

Deduplication rule: if after the update it matches another record with the same name and singer it returns 20031 (excluding itself); changing only the name or only the singer to a non-conflicting combination updates normally.

Response Common envelope

Field	Type	Description
id	string	Music UUID
name	string	Music Name
singer	array	Singer list
online	bool	Is online
create_time	string	Created
updated_time	string	Updated time

Example response

{
  "id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b",
  "name": "示例歌曲",
  "singer": ["示例歌手"],
  "online": false,
  "create_time": "2026-10-01 12:00:00",
  "updated_time": "2026-10-02 09:30:00"
}

DELETE /api/music/xiaoying/musics/<uuid> Total calls: 0

Delete Music

Delete music by UUID (its playback sources are deleted in cascade).

Music UUID music_id *

Path parameter: UUID of the music to delete

Response Common envelope

On success data is null (no data returned).

POST /api/music/xiaoying/music_sources Total calls: 0

Create Playback Source

Add a playback URL to a music record.

Music UUID music_id *

Music UUID (Required, must already exist)

Playback URL url *

Playback URL (Required, must be a valid URL)

Response Common envelope

Field	Type	Description
id	string	Playback Source UUID
music_id	string	Owning music UUID
url	string	Playback URL
create_time	string	Created
updated_time	string	Updated time

Example response

{
  "id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "music_id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b",
  "url": "https://music.example.com/xxx.mp3",
  "create_time": "2026-10-01 12:00:00",
  "updated_time": "2026-10-01 12:00:00"
}

PATCH /api/music/xiaoying/music_sources/<uuid> Total calls: 0

Update Playback Source

Partially update a playback source (music_id/url).

Playback Source UUID source_id *

Path parameter: playback source UUID

Playback URL url

Optional: new playback URL

Response Common envelope

Field	Type	Description
id	string	Playback Source UUID
music_id	string	Owning music UUID
url	string	Playback URL
create_time	string	Created
updated_time	string	Updated time

Example response

{
  "id": "9c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
  "music_id": "5f8e0b2c-1a3d-4e5f-8a9b-0c1d2e3f4a5b",
  "url": "https://music.example.com/new.mp3",
  "create_time": "2026-10-01 12:00:00",
  "updated_time": "2026-10-02 09:30:00"
}

DELETE /api/music/xiaoying/music_sources/<uuid> Total calls: 0

Delete Playback Source

Delete a playback source by UUID.

Playback Source UUID source_id *

Path parameter: playback source UUID

Response Common envelope

On success data is null (no data returned).

POST /api/music/xiaoying/import Total calls: 0

Bulk Import

Upload a JSON file to bulk-import music + playback sources (single file ≤10MB, up to 9999 records per call, no deduplication).

JSON file file *

multipart file field file, whose content is a JSON array. Online debugging on this page does not support file upload yet; call it from your code.

Example record: {"name":"Sunny Day","singer":["Jay Chou"],"online":true,"music_sources":["https://..."]}
Partial success: a failing record only rolls back that record; duplicate records with the same name and singer (compared against existing rows or earlier accepted ones in the same file, ignoring order/case) are counted in failures while the rest are stored normally.

Response Common envelope

Field	Type	Description
total	int	Total submitted
success_count	int	Imported count
failed_count	int	Failed count
failures	array	Failure details
failures[].index	int	Record index in the array (0-based)
failures[].name	string	Record name; empty string if unavailable
failures[].msg	string	Failure reason

Example response

{
  "total": 2,
  "success_count": 1,
  "failed_count": 1,
  "failures": [
    {"index": 1, "name": "示例歌曲", "msg": "资源已存在: 同名且同歌手的音乐已存在"}
  ]
}

GET /api/music/xiaoying/export Total calls: 0

Batch Export

Export all music (same format as import, so it can be fed straight back in): up to 9999 records returns a single .json; beyond that returns a .zip containing several json files of at most 9999 records each.

Keyword keyword

Optional: match music name/singer

Online Status online

Optional: omit to export everything (including offline items)

The response is a file download (Content-Disposition: attachment) rather than the unified JSON wrapper; with curl use -OJ or -o to save the file.
The exported content matches the JSON array format of Batch Import exactly (name / singer / online / music_sources) and can be fed straight back in.
Up to 9999 records returns a single .json; beyond that returns a .zip containing xiaoying_music_1.json, xiaoying_music_2.json and so on, each with at most 9999 records.
The online debugger on the docs page only shows garbled text for binary zips, so download with curl or code.

Response Common envelope

This endpoint returns a file download (Content-Disposition: attachment) and does not use the unified {code,msg,data} envelope: the content is a JSON array in the same format as "Bulk import"; a single .json when <=9999 records, otherwise a split .zip archive.