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.

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.

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

Singer Detail

Singer basic info + song list (paginated).

Singer Page URL *

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

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

Song Detail

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

Song Page URL *

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

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

Search Music

Search songs by keyword (paginated).

Keyword *

Search keyword (Required)

Page Number

Optional: page number, a positive integer, Default 1

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

Optional: match music name/singer

Online Status

Optional: true/false

Page Number

Optional: defaults to 1

Page Size

Optional: 1-100, Default 10

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 *

Music name (Required)

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

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.

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

Get Music Detail

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

Music UUID *

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

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

Update Music

Partially update music (singer replaces the whole list).

Music UUID *

Path parameter: UUID of the music to update

Music Name

Optional: new name

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

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.

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

Delete Music

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

Music UUID *

Path parameter: UUID of the music to delete

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

Create Playback Source

Add a playback URL to a music record.

Music UUID *

Music UUID (Required, must already exist)

Playback URL *

Playback URL (Required, must be a valid URL)

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

Update Playback Source

Partially update a playback source (music_id/url).

Playback Source UUID *

Path parameter: playback source UUID

Playback URL

Optional: new playback URL

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

Delete Playback Source

Delete a playback source by UUID.

Playback Source UUID *

Path parameter: playback source UUID

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 *

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.

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

Optional: match music name/singer

Online Status

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.