v56

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

更新歌单

更新歌单信息。支持通过 cover_song_id 从指定歌曲复制封面,与 cover_path/cover_url 互斥且优先级更高

put/playlists/{id}

Path parameters

idinteger required

歌单ID

Request body

cover_pathstring

封面图片本地路径(传空字符串清除)

cover_song_idinteger

从指定歌曲复制封面(与 cover_path/cover_url 互斥,优先级更高)

cover_urlstring

封面图片 URL(传空字符串清除)

descriptionstring

歌单描述

namestring

歌单名称

Example request

{
  "cover_song_id": 42,
  "description": "收藏的经典歌曲",
  "name": "我的最爱"
}

Response

更新成功

cover_urlstring

封面图片 URL

created_atstring

创建时间

descriptionstring

歌单描述

idinteger

歌单 ID

labelsstring[]

歌单标签,如 ["built_in"]

namestring

歌单名称

song_countinteger

歌曲数量

type'normal' | 'radio'

歌单类型:normal/radio

updated_atstring

最后更新时间

Example response

{
  "cover_url": "https://example.com/playlist.jpg",
  "created_at": "2024-01-01T12:00:00Z",
  "description": "收藏的经典歌曲",
  "id": 1,
  "labels": [
    "[\"built_in\"]"
  ],
  "name": "我的最爱",
  "song_count": 10,
  "type": "normal",
  "updated_at": "2024-01-01T12:00:00Z"
}