v56

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

设置歌单可见性

切换歌单的隐藏状态。内置歌单(收藏、电台收藏)不允许隐藏

put/playlists/{id}/visibility

Path parameters

idinteger required

歌单ID

Request body

hiddenboolean

是否隐藏歌单

Example request

{
  "hidden": true
}

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"
}