v

Swagger 2.0Apache 2.0raw.githubusercontent.com2026-08-0916286386.6 KB
歌单管理

上传歌单封面

上传本地图片作为歌单封面

post/playlists/{id}/cover

Path parameters

idinteger required

歌单ID

Response

上传成功

cover_urlstring

封面图片 URL

created_atstring

创建时间

descriptionstring

歌单描述

idinteger

歌单 ID

labelsstring[]

歌单标签,如 ["built_in"]

namestring

歌单名称

song_countinteger

歌曲数量

sort_bystring

视图排序字段:position/added_at/file_modified_at/title/artist/duration

sort_orderstring

视图排序方向:asc/desc

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,
  "sort_by": "position",
  "sort_order": "asc",
  "type": "normal",
  "updated_at": "2024-01-01T12:00:00Z"
}