Sign in
Swagger 2.0Apache 2.0raw.githubusercontent.com2026-08-2016888409.4 KB

3597db751d49

歌单管理

设置歌单置顶状态

置顶/取消置顶歌单。置顶歌单在歌单列表中始终排在最前，多个置顶歌单按置顶时间倒序（最近置顶的排最前）。内置歌单（收藏、电台收藏）同样允许置顶，不做特殊限制。

put/playlists/{id}/pin

Path parameters

idinteger required

歌单ID

Request body

pinnedboolean

是否置顶歌单

Example request

{
  "pinned": true
}

Response

更新后的歌单

cover_urlstring

封面图片 URL

created_atstring

创建时间

descriptionstring

歌单描述

idinteger

歌单 ID

labelsstring[]

歌单标签，如 ["built_in"]

namestring

歌单名称

pinned_atstring

置顶时间，nil 表示未置顶；多个置顶歌单按此字段倒序排列

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": "我的最爱",
  "pinned_at": "2024-01-01T12:00:00Z",
  "song_count": 10,
  "sort_by": "position",
  "sort_order": "asc",
  "type": "normal",
  "updated_at": "2024-01-01T12:00:00Z"
}