v56

latestSwagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0616186383.8 KB
歌单管理

批量删除歌单

根据歌单 ID 列表批量删除歌单,内置歌单会被跳过。请求体 delete_songs=true 时,同时删除仅属于这些歌单的孤儿歌曲(不属于任何其他歌单)——本地歌曲连同磁盘文件一并删除。

post/playlists/batch-delete

Request body

delete_songsboolean

为 true 时,一并删除仅属于被删歌单的孤儿歌曲(含本地歌曲及其磁盘文件)

idsinteger[]

要删除的歌单 ID 列表

Example request

{
  "ids": [
    1
  ]
}

Response

删除成功

deletedinteger

实际删除的歌单数量

deleted_songsinteger

连带清理的孤儿歌曲数量

Example response

{
  "deleted": 3,
  "deleted_songs": 12
}