Skip to content

获取歌单详情 ​

歌单能看到歌单名字, 但看不到具体歌单内容,调用此接口,传入歌单 id, 可

接口信息 ​

项目值
接口地址/playlist/detail
请求方式GET / POST
需要登录否
对应模块playlist_detail
文档分类歌单

请求参数 ​

参数类型必填默认值说明
idstring✅-歌单 id
sstring—8歌单最近的 s 个收藏者,默认为 8

HTTP 示例 ​

bash
GET /playlist/detail?id=24381616

编程式调用 ​

ts
import { playlistDetail } from 'hana-music-api';

const result = await playlistDetail({
  id: '24381616',
});

console.log(result.body);

返回内容 ​

声明了 body.playlist 的 id、name、coverImgUrl、description、trackCount、trackIds(每项声明了 id)、creator(userId、nickname)、subscribed(Cookie 里的 MUSIC_U 已经失效时是 null)、updateTime、trackUpdateTime,以及 PlaylistSummary 的其余宽松字段。

只有 code、playlist、playlist.id、playlist.trackIds、playlist.trackIds[].id 收紧;其余字段宽松,creator、subscribers 里的用户字段也全部宽松。tracks 是歌单里套着的歌曲,tracks[].id 和正文 privileges[].id 同样是宽松字段,类型不对只丢这个编号。正文另外声明了宽松的 fromUserCount、privileges。trackIds 是整张歌单的歌曲编号,tracks 最多只有 1,000 首。要拿全部歌曲的信息,用 获取歌单中的歌曲 按页取。结构定义和类型是 PlaylistDetailBody,见 返回体结构。

补充说明 ​

说明 : 歌单能看到歌单名字, 但看不到具体歌单内容,调用此接口,传入歌单 id, 可 以获取对应歌单内的所有的音乐(未登录状态只能获取不完整的歌单,登录后是完整的),但是返回的 trackIds 是完整的,tracks 则是不完整的,可拿全部 trackIds 请求一次 song/detail 接口获取所有歌曲的详情 (https://github.com/Binaryify/NeteaseCloudMusicApi/issues/452)

必选参数 : id : 歌单 id

可选参数 : s : 歌单最近的 s 个收藏者,默认为 8

接口地址 : /playlist/detail

调用例子 : /playlist/detail?id=24381616

Released under the MIT License.