获取歌单详情
歌单能看到歌单名字, 但看不到具体歌单内容,调用此接口,传入歌单 id, 可
接口信息
| 项目 | 值 |
|---|---|
| 接口地址 | /playlist/detail |
| 请求方式 | GET / POST |
| 需要登录 | 否 |
| 对应模块 | playlist_detail |
| 文档分类 | 歌单 |
请求参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
id | string | ✅ | - | 歌单 id |
s | string | — | 8 | 歌单最近的 s 个收藏者,默认为 8 |
HTTP 示例
GET /playlist/detail?id=24381616编程式调用
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