README.md 42.1 KB
Newer Older
B
binaryify 已提交
1 2 3
# NeteaseCloudMusicApi

网易云音乐 NodeJS 版 API
B
binaryify 已提交
4

B
binaryify 已提交
5
## 灵感来自
B
improve  
binaryify 已提交
6

B
binaryify 已提交
7 8 9 10
[disoul/electron-cloud-music](https://github.com/disoul/electron-cloud-music)

[darknessomi/musicbox](https://github.com/darknessomi/musicbox)

11
[sqaiyan/netmusic-node](https://github.com/sqaiyan/netmusic-node)
B
binaryify 已提交
12

B
binaryify 已提交
13
## 工作原理
B
improve  
binaryify 已提交
14 15

跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API
B
binaryify 已提交
16

17
## 功能特性
B
improve  
binaryify 已提交
18

19
1. 登录
20
2. 刷新登录
B
improve  
binaryify 已提交
21
3. 获取用户信息 , 歌单,收藏,mv, dj 数量
22 23 24 25 26 27 28 29
4. 获取用户歌单
5. 获取用户电台
6. 获取用户关注列表
7. 获取用户粉丝列表
8. 获取用户动态
9. 获取用户播放记录
10. 获取精品歌单
11. 获取歌单详情
B
binaryify 已提交
30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49
12. 搜索
13. 搜索建议
14. 获取歌词
15. 歌曲评论
16. 收藏单曲到歌单
17. 专辑评论
18. 歌单评论
19. mv 评论
20. 电台节目评论
21. banner
22. 获取歌曲详情
23. 获取专辑内容
24. 获取歌手单曲
25. 获取歌手 mv
26. 获取歌手专辑
27. 获取歌手描述
28. 获取相似歌手
29. 获取相似歌单
30. 相似 mv
31. 获取相似音乐
B
improve  
binaryify 已提交
50
32. 获取最近 5 个听了这首歌的用户
B
binaryify 已提交
51 52 53 54 55 56
33. 获取每日推荐歌单
34. 获取每日推荐歌曲
35. 私人 FM
36. 签到
37. 喜欢音乐
38. 垃圾桶
B
improve  
binaryify 已提交
57
39. 歌单 ( 网友精选碟 )
B
binaryify 已提交
58 59 60 61 62 63 64 65 66 67 68
40. 新碟上架
41. 热门歌手
42. 最新 mv
43. 推荐 mv
44. 推荐歌单
45. 推荐新音乐
46. 推荐电台
47. 推荐节目
48. 独家放送
49. mv 排行
50. 获取 mv 数据
69
51. 播放 mv/视频
B
binaryify 已提交
70
52. 排行榜
H
hzw758 已提交
71 72
53. 歌手榜
54. 云盘
B
improve  
binaryify 已提交
73 74 75 76 77 78
55. 电台 - 推荐
56. 电台 - 分类
57. 电台 - 分类推荐
58. 电台 - 订阅
59. 电台 - 详情
60. 电台 - 节目
H
hzw758 已提交
79 80
61. 给评论点赞
62. 获取动态
B
binaryify 已提交
81
63. 获取热搜
B
binaryify 已提交
82 83
64. 发送私信
65. 发送私信歌单
84 85
66. 新建歌单
67. 收藏/取消收藏歌单
B
binaryify 已提交
86
68. 歌单分类
87 88
69. 收藏的歌手列表
70. 订阅的电台列表
89 90
71. 相关歌单推荐
72. 付费精选接口
91 92
73. 音乐是否可用检查接口
74. 登录状态
93
75. 获取视频数据
B
binaryify 已提交
94
76. 发送/删除评论
95 96
77. 热门评论
78. 视频评论
B
v2.20.3  
binaryify 已提交
97
79. 退出登录
B
v3.0.0  
binaryify 已提交
98 99 100 101 102
80. 所有榜单内容摘要
81. 收藏视频
82. 收藏 MV
83. 视频详情
84. 相关视频
B
binaryify 已提交
103 104
85. 关注用户
86. 新歌速递
105
87. 喜欢音乐列表(无序)
B
v3.0.0  
binaryify 已提交
106

B
improve  
binaryify 已提交
107
## 安装
B
improve  
binaryify 已提交
108 109

```shell
110
$ git clone git@github.com:Binaryify/NeteaseCloudMusicApi.git
111 112 113



114
$ npm install
115 116 117



B
binaryify 已提交
118
```
B
improve  
binaryify 已提交
119

120
## 运行
B
improve  
binaryify 已提交
121 122

```shell
N
nujhong 已提交
123
$ node app.js
124 125 126



B
binaryify 已提交
127 128
```

B
improve  
binaryify 已提交
129 130
服务器启动默认端口为 3000, 若不想使用 3000 端口 , 可使用以下命令 : Mac/Linux

B
binaryify 已提交
131 132
```shell
$ PORT=4000 node app.js
133 134 135



B
binaryify 已提交
136 137
```

B
improve  
binaryify 已提交
138 139
windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :

B
binaryify 已提交
140 141
```shell
$ set PORT=4000 && node app.js
142 143 144



B
binaryify 已提交
145
```
B
binaryify 已提交
146

147 148 149 150 151 152
## 可以使用代理

在 query 参数中加上 proxy=your-proxy 即可让这一次的请求使用 proxy

```javascript
// 例子
B
v3.0.0  
binaryify 已提交
153
const url = `http://localhost:3000/song/url?id=33894312&proxy=http://121.196.226.246:84`
154 155 156 157 158 159 160
fetch(url).then(function() {
  // do what you want
})

// 结果
// {"data":[{"id":33894312,"url":"http://m10.music.126.net/20180104125640/930a968b3fb04908b733506b3833e60b/ymusic/0fd6/4f65/43ed/a8772889f38dfcb91c04da915b301617.mp3","br":320000,"size":10691439,"md5":"a8772889f38dfcb91c04da915b301617","code":200,"expi":1200,"type":"mp3","gain":-2.0E-4,"fee":0,"uf":null,"payed":0,"flag":0,"canExtend":false}],"code": 200}
```
B
binaryify 已提交
161

B
binaryify 已提交
162
## 更新到 v3.0 说明
B
binaryify 已提交
163

B
binaryify 已提交
164
!>2018.10.14 更新到 3.0.0,使用了模块化机制,因为部分接口参数和 url 做了调整,如还不想升级到 3.0.0,请查看 [v2 的文档](http://binaryify.github.io/NeteaseCloudMusicApi/#/v2), [更新日志](https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/CHANGELOG.MD), [2.0+下载地址](https://github.com/Binaryify/NeteaseCloudMusicApi/releases/tag/v2.20.5), 同时 2.0+ 将不再维护
165

B
improve  
binaryify 已提交
166 167
## Docker 容器运行

B
binaryify 已提交
168
> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
169 170 171

request 相关的环境变量

172 173 174 175 176 177 178
1. http_proxy
2. https_proxy
3. HTTP_PROXY
4. HTTPS_PROXY
5. no_proxy
6. NO_PROXY

179
```shell
180
docker pull twesix/netease-cloud-music
181 182 183



184 185
docker run -d -p 3000:3000 --name netease-cloud-music twesix/netease-music-api

186 187 188 189 190 191






192
// 去掉或者设置相关的环境变量
193 194 195



196
docker run -d -p 3000:3000 --name netease-cloud-music -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= netease-cloud-music
197 198 199



200
```
B
binaryify 已提交
201

202 203 204 205
> 由于 docker 镜像更新不是很及时,推荐自己 build, 以下为 build 镜像的方式

```
$ git clone https://github.com/Binaryify/NeteaseCloudMusicApi && cd NeteaseCloudMusicApi
206 207 208



209
$ sudo docker build . -t netease-music-api
210 211 212



213
$ sudo docker run -d -p 3000:3000 netease-music-api
214 215 216



217
```
B
binaryify 已提交
218

219
## 接口文档
B
improve  
binaryify 已提交
220

B
binaryify 已提交
221
### 调用前须知
B
improve  
binaryify 已提交
222

B
binaryify 已提交
223
!> 为使用方便,降低门槛,登录接口直接使用了 get 明文请求,请按实际需求对源码修改
B
binaryify 已提交
224

225
!> 由于接口做了缓存处理 ( 缓存 2 分钟,不缓存数据极容易引起网易服务器高频ip错误 , 可在 app.js 设置 , 可能会导致登陆后获取不
B
binaryify 已提交
226 227 228
到 cookie), 相同的 url 会在两分钟内只向网易服务器发一次请求 , 如果遇到不需要缓
存结果的接口 , 可在请求 url 后面加一个时间戳参数使 url 不同 , 例子 :
`/simi/playlist?id=347230&timestamp=1503019930000`
B
improve  
binaryify 已提交
229

B
binaryify 已提交
230
!> 如果是跨域请求 , 请在所有请求带上 `xhrFields: { withCredentials: true }` 否则
B
binaryify 已提交
231
可能会因为没带上 cookie 导致 301, 具体例子可看 `public/test.html`, 例子使用 jQuery, axios 版本也类似
B
improve  
binaryify 已提交
232

B
binaryify 已提交
233
!> 301 错误基本都是没登录就调用了需要登录的接口,如果登陆了还是提示 301, 基本都是缓存把数据缓存起来了,解决方法是等待 2 分钟或者重启服务重新登录后再调用接口
B
binaryify 已提交
234

B
binaryify 已提交
235
!> 部分接口如登录接口不能调用太频繁 , 否则可能会触发 503 错误或者 ip 高频错误 ,若需频繁调用 , 需要准备 IP 代理池 (更新:已加入缓存机制,但仍需注意).
B
improve  
binaryify 已提交
236

B
binaryify 已提交
237
!> 本项目仅供学习使用 , 文档可能会有缓存 , 如果文档版本和 github 上的版本不一致,请清除缓存再查看
B
improve  
binaryify 已提交
238

B
binaryify 已提交
239
!> 由于网易限制,此项目在国外服务器上使用会受到限制,如需解决 , 可使用大陆服务器或者使用代理 , 感谢 [@hiyangguo](https://github.com/hiyangguo)提出的[解决方法](https://github.com/Binaryify/NeteaseCloudMusicApi/issues/29#issuecomment-298358438):
B
binaryify 已提交
240 241
在 'util.js' 的 'headers' 处增加 `X-Real-IP':'211.161.244.70' // 任意国内 IP`
即可解决
B
binaryify 已提交
242 243

### 登录
B
improve  
binaryify 已提交
244 245 246

说明 : 登录有两个接口

B
improve  
binaryify 已提交
247
#### 1. 手机登录
248

B
improve  
binaryify 已提交
249
**必选参数 :** `phone`: 手机号码 `password`: 密码
250

B
improve  
binaryify 已提交
251
**接口地址 :** `/login/cellphone`
252

B
improve  
binaryify 已提交
253
**调用例子 :** `/login/cellphone?phone=xxx&password=yyy`
254

B
improve  
binaryify 已提交
255
#### 2. 邮箱登录
B
binaryify 已提交
256

B
binaryify 已提交
257 258
~~ 注意 : 此接口被网易和谐了 , 待修复 , 暂时使用手机登录 (2017.05.20)~~

B
binaryify 已提交
259
> 更新 : 此接口已经可以正常使用(2018.07.03)
260

B
improve  
binaryify 已提交
261
**必选参数 :** `email`: 163 网易邮箱 `password`: 密码
262

B
improve  
binaryify 已提交
263
**接口地址 :** `/login`
264

B
improve  
binaryify 已提交
265
**调用例子 :** `/login?email=xxx@163.com&password=yyy`
B
binaryify 已提交
266

B
improve  
binaryify 已提交
267 268
返回数据如下图 :
![登录](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E7%99%BB%E5%BD%95.png)
B
binaryify 已提交
269

B
improve  
binaryify 已提交
270 271
完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个
Cookies
B
binaryify 已提交
272

B
binaryify 已提交
273
#### 注意
B
improve  
binaryify 已提交
274 275

调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法
B
binaryify 已提交
276

277
### 刷新登录
N
nujhong 已提交
278

B
improve  
binaryify 已提交
279 280 281
说明 : 调用此接口 , 可刷新登录状态

**调用例子 :** `/login/refresh`
282

B
v2.20.3  
binaryify 已提交
283 284 285 286 287 288
### 退出登录

说明 : 调用此接口 , 可退出登录

**调用例子 :** `/logout`

289
### 登录状态
B
binaryify 已提交
290

291 292 293 294 295 296
说明 : 调用此接口,可获取登录状态

**接口地址 :** `/login/status`
返回数据如下图:
![数据](https://ws2.sinaimg.cn/large/006tNbRwgy1fup6q18kk6j316i0nw0wa.jpg)

B
binaryify 已提交
297 298
### 获取用户详情

B
improve  
binaryify 已提交
299
说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户详情
B
binaryify 已提交
300

B
improve  
binaryify 已提交
301
**必选参数 :** `uid` : 用户 id
B
binaryify 已提交
302

B
improve  
binaryify 已提交
303
**接口地址 :** `/user/detail`
B
binaryify 已提交
304

B
improve  
binaryify 已提交
305
**调用例子 :** `/user/detail?uid=32953014`
B
binaryify 已提交
306

B
improve  
binaryify 已提交
307
### 获取用户信息 , 歌单,收藏,mv, dj 数量
308

B
improve  
binaryify 已提交
309
说明 : 登陆后调用此接口 , 可以获取用户信息
310

B
improve  
binaryify 已提交
311
**接口地址 :** `/user/subcount`
312

B
improve  
binaryify 已提交
313
**调用例子 :** `/user/subcount`
314

315 316 317 318 319
### 更新用户信息

说明 : 登陆后调用此接口 , 传入相关信息,可以更新用户信息

**必选参数 :**
B
binaryify 已提交
320

321 322
```
gender: 性别 0:保密 1:男性 2:女性
323 324 325



326
birthday: 出生日期,时间戳 unix timestamp
327 328 329



330
nickname: 用户昵称
331 332 333



334
province: 省份id
335 336 337



338
city: 城市id
339 340 341



342
signature:用户签名
343 344 345



346 347 348 349 350 351
```

**接口地址 :** `/user/subcount`

**调用例子 :** `/user/update/?gender=0&signature=测试签名&city=440300&nickname=binary&birthday=1525918298004&province=440000`

B
binaryify 已提交
352
### 获取用户歌单
353

B
improve  
binaryify 已提交
354
说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户歌单
355

B
improve  
binaryify 已提交
356
**必选参数 :** `uid` : 用户 id
357

B
improve  
binaryify 已提交
358
**接口地址 :** `/user/playlist`
359

B
improve  
binaryify 已提交
360 361 362
**调用例子 :** `/user/playlist?uid=32953014`

返回数据如下图 :
B
binaryify 已提交
363 364
![用户歌单](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E7%94%A8%E6%88%B7%E6%AD%8C%E5%8D%95.png)

365 366 367 368
### 更新歌单

说明 : 登陆后调用此接口,可以更新用户歌单
参数:
B
binaryify 已提交
369

370 371
```
id:歌单id
372 373 374



375
name:歌单名字
376 377 378



379
desc:歌单描述
380 381 382



383
tags:歌单tag
384 385 386



387
```
B
binaryify 已提交
388

389 390 391 392
**接口地址 :** `/playlist/update`

**调用例子 :** `/playlist/update/?id=24381616&name=新歌单&desc=描述&tags=学习`

B
binaryify 已提交
393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424
### 发送私信

说明 : 登陆后调用此接口 , 传入用户 id 和要发送的信息, 可以发送私信,返回内容为历史私信,包含带歌单的私信信息(注:不能发送私信给自己)

**必选参数 :**

`user_ids` : 用户 id,多个需用逗号隔开

`msg` : 要发送的信息

**接口地址 :** `/send/text`

**调用例子 :** `/send/text?user_ids=32953014&msg=test`,`/send/text?user_ids=32953014,475625142&msg=test`
返回数据如下图:
![数据](https://ws1.sinaimg.cn/large/006tKfTcgy1fr3p3hfeudj31kw1aek2e.jpg)

### 发送私信(带歌单)

说明 : 登陆后调用此接口 , 传入用户 id 和要发送的信息和歌单 id, 可以发送带歌单的私信(注:不能发送重复的歌单)

**必选参数 :**

`user_ids` : 用户 id,多个需用逗号隔开

`msg` : 要发送的信息

**接口地址 :** `/send/playlist`

**调用例子 :** `/send/playlist?msg=test&user_ids=475625142&playlist=705123491`,`/send/playlist?msg=test2&user_ids=475625142,32953014&playlist=705123493`
返回数据如下图:
![数据](https://ws1.sinaimg.cn/large/006tKfTcgy1fr3p1z7qmcj30v409adg5.jpg)

425 426
### 获取用户电台

B
improve  
binaryify 已提交
427 428 429
说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户电台

**必选参数 :** `uid` : 用户 id
430

B
improve  
binaryify 已提交
431
**接口地址 :** `/user/dj`
432

B
improve  
binaryify 已提交
433
**调用例子 :** `/user/dj?uid=32953014`
434

B
improve  
binaryify 已提交
435
### 获取用户关注列表
436

B
improve  
binaryify 已提交
437 438 439
说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户关注列表

**必选参数 :** `uid` : 用户 id
N
nujhong 已提交
440

B
binaryify 已提交
441
**可选参数 :**
442

B
binaryify 已提交
443 444 445
`limit` : 返回数量 , 默认为 30

`offset` : 偏移数量,用于分页 , 如
B
improve  
binaryify 已提交
446
: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
447

B
improve  
binaryify 已提交
448
**接口地址 :** `/user/follows`
449

B
improve  
binaryify 已提交
450
**调用例子 :** `/user/follows?uid=32953014`
451

B
improve  
binaryify 已提交
452
### 获取用户粉丝列表
453

B
improve  
binaryify 已提交
454
说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户粉丝列表
455

B
improve  
binaryify 已提交
456
**必选参数 :** `uid` : 用户 id
457

B
improve  
binaryify 已提交
458 459
**可选参数 :** `limit` : 返回数量 , 默认为 30 `offset` : 偏移数量,用于分页 , 如
: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
460

B
improve  
binaryify 已提交
461 462 463
**接口地址 :** `/user/followeds`

**调用例子 :** `/user/followeds?uid=32953014`
464 465 466

### 获取用户动态

B
improve  
binaryify 已提交
467 468 469
说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户动态

**必选参数 :** `uid` : 用户 id
470

B
improve  
binaryify 已提交
471
**接口地址 :** `/user/event`
472

B
improve  
binaryify 已提交
473
**调用例子 :** `/user/event?uid=32953014`
474

B
v3.0.0  
binaryify 已提交
475 476 477 478 479 480
### 关注/取消关注用户

说明 : 登陆后调用此接口 , 传入用户 id, 和操作 t,可关注/取消关注用户

**必选参数 :**

B
binaryify 已提交
481
`id` : 用户 id
B
v3.0.0  
binaryify 已提交
482

B
binaryify 已提交
483
`t` : `1`为关注,其他为取消关注
B
v3.0.0  
binaryify 已提交
484 485 486 487 488

**接口地址 :** `/follow`

**调用例子 :** `/follow?id=32953014&t=1`

489 490
### 获取用户播放记录

B
improve  
binaryify 已提交
491 492 493
说明 : 登陆后调用此接口 , 传入用户 id, 可获取用户播放记录

**必选参数 :** `uid` : 用户 id
494

B
improve  
binaryify 已提交
495
**可选参数 :** `type` : type=1 时只返回 weekData, type=0 时返回 allData
496

B
improve  
binaryify 已提交
497
**接口地址 :** `/user/record`
498

B
improve  
binaryify 已提交
499
**调用例子 :** `/user/record?uid=32953014&type=1`
500

Z
zhixuan 已提交
501 502
### 获取动态消息

B
improve  
binaryify 已提交
503 504
说明 : 调用此接口 , 可获取各种动态 , 对应网页版网易云,朋友界面里的各种动态消息
,如分享的视频,音乐,照片等!
Z
zhixuan 已提交
505

B
improve  
binaryify 已提交
506
**必选参数 :** 未知
Z
zhixuan 已提交
507

B
improve  
binaryify 已提交
508 509 510
**接口地址 :** `/event`

**调用例子 :** `/event`
Z
zhixuan 已提交
511

512
### 歌手分类列表
B
binaryify 已提交
513

514 515 516
说明 : 调用此接口,可获取歌手分类列表
**必选参数 :** `cat` : 即 category Code,歌手类型,默认 1001,返回华语男歌手数据
**可选参数 :**
517

518 519 520 521
`limit` : 返回数量 , 默认为 30

`offset` : 偏移数量,用于分页 , 如
: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
B
binaryify 已提交
522
`initial`: 按首字母索引查找参数,如 `/artist/list?cat=1001&initial=b` 返回内容将以 name 字段开头为 b 或者拼音开头为 b 为顺序排列
523

524
category Code 取值:
B
binaryify 已提交
525

526 527
```
入驻歌手 5001
528 529 530



531
华语男歌手 1001
532 533 534



535
华语女歌手 1002
536 537 538



539
华语组合/乐队 1003
540 541 542



543
欧美男歌手 2001
544 545 546



547
欧美女歌手 2002
548 549 550



551
欧美组合/乐队 2003
552 553 554



555
日本男歌手 6001
556 557 558



559
日本女歌手 6002
560 561 562



563
日本组合/乐队 6003
564 565 566



567
韩国男歌手 7001
568 569 570



571
韩国女歌手 7002
572 573 574



575
韩国组合/乐队 7003
576 577 578



579
其他男歌手 4001
580 581 582



583
其他女歌手 4002
584 585 586



587
其他组合/乐队 4003
588 589 590



591 592 593 594 595 596 597 598 599
```

**接口地址 :** `/artist/list`

**调用例子 :** `/artist/list?cat=1001`

返回数据如下图:
![数据](https://ws1.sinaimg.cn/large/006tKfTcgy1fr60g9zps9j31kw1bpk4n.jpg)

B
v3.0.0  
binaryify 已提交
600
### 收藏/取消收藏歌手
B
binaryify 已提交
601

B
binaryify 已提交
602
说明 : 调用此接口,可收藏歌手
B
v3.0.0  
binaryify 已提交
603

B
binaryify 已提交
604
**必选参数 :**
605

B
binaryify 已提交
606
`artistId` : 歌手 id
607

B
binaryify 已提交
608
`t`:操作,1 为收藏,其他为取消收藏
B
binaryify 已提交
609

B
v3.0.0  
binaryify 已提交
610
**接口地址 :** `/artist/sub`
611

B
v3.0.0  
binaryify 已提交
612
**调用例子 :** `/artist/sub?id=6452&t=1`
613

614
### 收藏的歌手列表
B
binaryify 已提交
615

616 617 618 619 620 621
说明 : 调用此接口,可获取收藏的歌手列表

**接口地址 :** `/artist/sublist`

**调用例子 :** `/artist/sublist`

B
v3.0.0  
binaryify 已提交
622 623 624 625
### 收藏视频

说明 : 调用此接口,可收藏视频

B
binaryify 已提交
626
**必选参数 :**
B
v3.0.0  
binaryify 已提交
627 628 629 630 631 632 633 634 635 636 637 638 639

`id` : 视频 id

`t` : 1 为收藏,其他为取消收藏

**接口地址 :** `/video/sub`

**调用例子 :** `/video/sub`

### 收藏 MV

说明 : 调用此接口,可收藏 MV

B
binaryify 已提交
640
**必选参数 :**
B
v3.0.0  
binaryify 已提交
641 642 643 644 645 646 647 648 649

`id` : MV id

`t` : 1 为收藏,其他为取消收藏

**接口地址 :** `/mv/sub`

**调用例子 :** `/mv/sub`

B
binaryify 已提交
650
### 歌单分类
B
binaryify 已提交
651

B
binaryify 已提交
652 653 654 655 656 657 658
说明 : 调用此接口,可获取歌单分类,包含 category 信息

**接口地址 :** `/playlist/catlist`

**调用例子 :** `/playlist/catlist`

### 热门歌单分类
B
binaryify 已提交
659

B
binaryify 已提交
660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682
说明 : 调用此接口,可获取歌单分类,包含 category 信息

**接口地址 :** `/playlist/hot`

**调用例子 :** `/playlist/hot`

### 歌单 ( 网友精选碟 )

说明 : 调用此接口 , 可获取网友精选碟歌单

**可选参数 :** `order`: 可选值为 'new' 和 'hot', 分别对应最新和最热 , 默认为
'hot'

`cat`:`cat`: tag, 比如 " 华语 "、" 古风 " 、" 欧美 "、" 流行 ", 默认为
"全部",可从歌单分类接口获取(/playlist/catlist)

**接口地址 :** `/top/playlist`

**调用例子 :** `/top/playlist?limit=10&order=new`

返回数据如下图 :

![精选碟](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_playlist.png)
683

B
binaryify 已提交
684
![对应位置](https://ws2.sinaimg.cn/large/006tKfTcgy1fr3wnpyg6jj317e0vcqdc.jpg)
685

B
binaryify 已提交
686 687
![返回数据](https://ws4.sinaimg.cn/large/006tKfTcgy1fr3wqs5lw9j31ic1re4c4.jpg)

B
improve  
binaryify 已提交
688
### 获取精品歌单
689

B
improve  
binaryify 已提交
690
说明 : 调用此接口 , 可获取精品歌单
691

B
improve  
binaryify 已提交
692
**可选参数 :** `cat`: tag, 比如 " 华语 "、" 古风 " 、" 欧美 "、" 流行 ", 默认为
B
binaryify 已提交
693
"全部",可从歌单分类接口获取(/playlist/catlist)
694

B
improve  
binaryify 已提交
695
`limit`: 取出歌单数量 , 默认为 20
696

B
v3.0.0  
binaryify 已提交
697 698
`before`: 分页参数,取上一页最后一个歌单的 `updateTime` 获取下一页数据

B
improve  
binaryify 已提交
699
**接口地址 :** `/top/playlist/highquality`
700

B
v3.0.0  
binaryify 已提交
701
**调用例子 :** `http://localhost:3000/top/playlist/highquality?before=1503639064232&limit=3`
702

B
binaryify 已提交
703 704 705 706 707 708 709 710 711 712
### 相关歌单推荐

说明 : 调用此接口,传入歌单 id 可获取相关歌单(对应页面 [https://music.163.com/#/playlist?id=1](https://music.163.com/#/playlist?id=1))

**必选参数 :** `id` : 歌单 id

**接口地址 :** `/related/playlist`

**调用例子 :** `/related/playlist?id=1`

B
improve  
binaryify 已提交
713
### 获取歌单详情
714

B
improve  
binaryify 已提交
715
说明 : 歌单能看到歌单名字 , 但看不到具体歌单内容 , 调用此接口 , 传入歌单 id, 可
B
improve  
binaryify 已提交
716 717 718
以获取对应歌单内的所有的音乐

**必选参数 :** `id` : 歌单 id
719

B
binaryify 已提交
720
**可选参数 :** `s` : 歌单最近的 s 个收藏者
B
binaryify 已提交
721

B
improve  
binaryify 已提交
722
**接口地址 :** `/playlist/detail`
723

B
improve  
binaryify 已提交
724
**调用例子 :** `/playlist/detail?id=24381616`
725

B
improve  
binaryify 已提交
726
返回数据如下图 :
B
binaryify 已提交
727 728 729
![歌单详情](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%AD%8C%E5%8D%95%E8%AF%A6%E6%83%85.png)

### 获取音乐 url
730

B
improve  
binaryify 已提交
731 732 733 734 735 736
说明 : 使用歌单详情接口后 , 能得到的音乐的 id, 但不能得到的音乐 url, 调用此接口
, 传入的音乐 id( 可多个 , 用逗号隔开 ), 可以获取对应的音乐的 url( 不需要登录 )

> 注 : 部分用户反馈获取的 url 会 403,[hwaphon](https://github.com/hwaphon)找到的
> 解决方案是当获取到音乐的 id 后,将
> http://music.163.com/song/media/outer/url?id=id.mp3 以 src 赋予 Audio 即可播放
B
binaryify 已提交
737

B
improve  
binaryify 已提交
738
**必选参数 :** `id` : 音乐 id
739

B
binaryify 已提交
740
**可选参数 :** `br`: 码率,默认设置了 999000 即最大码率,如果要 320k 则可设置为 320000,其他类推
B
binaryify 已提交
741

B
v3.0.0  
binaryify 已提交
742
**接口地址 :** `/song/url`
743

B
v3.0.0  
binaryify 已提交
744
**调用例子 :** `/song/url?id=33894312` `/song/url?id=405998841,33894312`
745

B
improve  
binaryify 已提交
746
返回数据如下图 :
B
binaryify 已提交
747 748
![音乐 url](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E9%9F%B3%E4%B9%90%20url.png)

749
### 音乐是否可用
B
binaryify 已提交
750

751 752 753 754
说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 `{ success: true, message: 'ok' }` 或者 `{ success: false, message: '亲爱的,暂无版权' }`

**必选参数 :** `id` : 歌曲 id

B
binaryify 已提交
755
**可选参数** : `br`: 码率,默认设置了 999000 即最大码率,如果要 320k 则可设置为 320000,其他类推
756 757 758 759 760

**接口地址 :** `/check/music`

**调用例子 :** `/check/music?id=33894312`

761
### 搜索
762

B
improve  
binaryify 已提交
763 764
说明 : 调用此接口 , 传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户 ,
关键词可以多个 , 以空格隔开 , 如 " 周杰伦 搁浅 "( 不需要登录 ), 搜索获取的
B
v3.0.0  
binaryify 已提交
765
mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具体的播放链接
766

B
improve  
binaryify 已提交
767
**必选参数 :** `keywords` : 关键词
768

B
improve  
binaryify 已提交
769 770
**可选参数 :** `limit` : 返回数量 , 默认为 30 `offset` : 偏移数量,用于分页 , 如
: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
N
nujhong 已提交
771

772 773
`type`: 搜索类型;默认为 1 即单曲 , 取值意义 : 1: 单曲, 10: 专辑, 100: 歌手, 1000:
歌单, 1002: 用户, 1004: MV, 1006: 歌词, 1009: 电台, 1014: 视频
N
nujhong 已提交
774

B
improve  
binaryify 已提交
775
**接口地址 :** `/search`
776

B
improve  
binaryify 已提交
777
**调用例子 :** `/search?keywords= 海阔天空`
778

B
improve  
binaryify 已提交
779
返回数据如下图 :
B
binaryify 已提交
780 781
![搜索音乐](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%90%9C%E7%B4%A2.png)

B
binaryify 已提交
782
### 热搜
B
binaryify 已提交
783

B
binaryify 已提交
784 785 786 787 788 789
说明 : 调用此接口,可获取热门搜索列表

**接口地址 :** `/search/hot`

**调用例子 :** `/search/hot`

790 791
### 搜索建议

B
improve  
binaryify 已提交
792
说明 : 调用此接口 , 传入搜索关键词可获得搜索建议 , 搜索结果同时包含单曲 , 歌手 ,
B
improve  
binaryify 已提交
793
歌单 ,mv 信息
794

B
improve  
binaryify 已提交
795
**必选参数 :** `keywords` : 关键词
N
nujhong 已提交
796

797
**可选参数 :**
798

799 800 801
`limit` : 返回数量 , 默认为 30

`offset` : 偏移数量,用于分页 , 如
B
improve  
binaryify 已提交
802
: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0
N
nujhong 已提交
803

B
improve  
binaryify 已提交
804 805
`type`: 搜索类型;默认为 1 即单曲 , 取值意义 : 1: 单曲 10: 专辑 100: 歌手 1000:
歌单 1002: 用户 1004: MV 1006: 歌词 1009: 电台
806

B
improve  
binaryify 已提交
807
**接口地址 :** `/search/suggest`
808

B
improve  
binaryify 已提交
809
**调用例子 :** `/search/suggest?keywords= 海阔天空`
810

B
binaryify 已提交
811 812
### 搜索多重匹配

B
improve  
binaryify 已提交
813 814 815
说明 : 调用此接口 , 传入搜索关键词可获得搜索结果

**必选参数 :** `keywords` : 关键词
N
nujhong 已提交
816

B
improve  
binaryify 已提交
817
**接口地址 :** `/search/multimatch`
B
binaryify 已提交
818

B
improve  
binaryify 已提交
819
**调用例子 :** `/search/multimatch?keywords= 海阔天空`
B
binaryify 已提交
820

821 822 823 824
### 新建歌单

说明 : 调用此接口 , 传入歌单名字可新建歌单

B
binaryify 已提交
825
**必选参数 :** `name` : 歌单名
826 827 828 829 830 831 832 833 834 835 836 837 838

**接口地址 :** `/playlist/create`

**调用例子 :** `/playlist/create?name=测试歌单`

返回数据如下图:
![数据](https://ws1.sinaimg.cn/large/006tKfTcgy1fr3va885z5j31a617qwjy.jpg)

### 收藏/取消收藏歌单

说明 : 调用此接口 , 传入类型和歌单 id 可收藏歌单或者取消收藏歌单

**必选参数 :**
839

B
binaryify 已提交
840
`t` : 类型,1:收藏,2:取消收藏
841 842 843 844 845 846 847 848 849
`id` : 歌单 id

**接口地址 :** `/playlist/subscribe`

**调用例子 :** `/playlist/subscribe?t=1&id=106697785` `/playlist/subscribe?t=2&id=106697785`

返回数据如下图:
![数据](https://ws1.sinaimg.cn/large/006tKfTcgy1fr3vdwx0hvj30s405u74b.jpg)

850
### 对歌单添加或删除歌曲
B
binaryify 已提交
851

B
improve  
binaryify 已提交
852
说明 : 调用此接口 , 可以添加歌曲到歌单或者从歌单删除某首歌曲 ( 需要登录 )
B
binaryify 已提交
853

854
**必选参数 :**
855

856 857 858 859
`op`: 从歌单增加单曲为 add, 删除为 del

`pid`: 歌单 id
`tracks`: 歌曲 id,可多个,用逗号隔开
B
binaryify 已提交
860

B
improve  
binaryify 已提交
861
**接口地址 :** `/playlist/tracks`
B
binaryify 已提交
862

B
binaryify 已提交
863
**调用例子 :** `/playlist/tracks?op=add&pid=24381616&tracks=347231` ( 对应把歌曲添加到 ' 我 ' 的歌单 , 测试的时候请把这里的 pid 换成你自己的, id 和 tracks 不对可能会报 502 错误)
864

B
binaryify 已提交
865
### 获取歌词
866

B
improve  
binaryify 已提交
867
说明 : 调用此接口 , 传入音乐 id 可获得对应音乐的歌词 ( 不需要登录 )
868

B
improve  
binaryify 已提交
869
**必选参数 :** `id`: 音乐 id
870

B
improve  
binaryify 已提交
871
**接口地址 :** `/lyric`
872

B
improve  
binaryify 已提交
873 874 875
**调用例子 :** `/lyric?id=33894312`

返回数据如下图 :
876
![获取歌词](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%AD%8C%E8%AF%8D.png)
B
binaryify 已提交
877

B
binaryify 已提交
878 879 880 881 882 883 884 885 886 887
### 新歌速递

说明 : 调用此接口 , 可获取新歌速递

**必选参数 :**

`type`: 地区类型 id,对应以下:

```
全部:0
888 889 890



B
binaryify 已提交
891
华语:7
892 893 894



B
binaryify 已提交
895
欧美:96
896 897 898



B
binaryify 已提交
899
日本:8
900 901 902



B
binaryify 已提交
903
韩国:16
904 905 906



B
binaryify 已提交
907 908 909 910 911 912 913 914 915 916
```

`limit`: 取出数量 , 默认为 100

`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*100, 其中 100 为 limit 的值

**接口地址 :** `/top/song`

**调用例子 :** `/top/song?type=96`

917
### 歌曲评论
918

B
improve  
binaryify 已提交
919 920
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该音乐的所有评论 ( 不需要
登录 )
921

B
improve  
binaryify 已提交
922
**必选参数 :** `id`: 音乐 id
923

B
improve  
binaryify 已提交
924
**可选参数 :** `limit`: 取出评论数量 , 默认为 20
925

B
improve  
binaryify 已提交
926
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值
927

B
improve  
binaryify 已提交
928
**接口地址 :** `/comment/music`
929

B
improve  
binaryify 已提交
930
**调用例子 :** `/comment/music?id=186016&limit=1` 对应晴天评论
931

B
improve  
binaryify 已提交
932 933
返回数据如下图 :
![获取评论](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/comment.png)
934 935 936

### 专辑评论

B
improve  
binaryify 已提交
937 938
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该专辑的所有评论 ( 不需要
登录 )
939

B
improve  
binaryify 已提交
940
**必选参数 :** `id`: 专辑 id
941

B
improve  
binaryify 已提交
942
**可选参数 :** `limit`: 取出评论数量 , 默认为 20
943

B
improve  
binaryify 已提交
944
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值
945

B
improve  
binaryify 已提交
946 947 948
**接口地址 :** `/comment/album`

**调用例子 :** `/comment/album?id=32311`
949 950 951

### 歌单评论

B
improve  
binaryify 已提交
952 953 954 955
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该歌单的所有评论 ( 不需要
登录 )

**必选参数 :** `id`: 歌单 id
956

B
improve  
binaryify 已提交
957
**可选参数 :** `limit`: 取出评论数量 , 默认为 20
958

B
improve  
binaryify 已提交
959
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值
960

B
improve  
binaryify 已提交
961
**接口地址 :** `/comment/playlist`
962

B
improve  
binaryify 已提交
963
**调用例子 :** `/comment/playlist?id=705123491`
964 965 966

### mv 评论

B
improve  
binaryify 已提交
967 968
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 mv 的所有评论 ( 不需要
登录 )
969

B
improve  
binaryify 已提交
970
**必选参数 :** `id`: mv id
971

B
improve  
binaryify 已提交
972
**可选参数 :** `limit`: 取出评论数量 , 默认为 20
973

B
improve  
binaryify 已提交
974
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值
975

B
improve  
binaryify 已提交
976 977 978
**接口地址 :** `/comment/mv`

**调用例子 :** `/comment/mv?id=5436712`
979 980 981

### 电台节目评论

B
improve  
binaryify 已提交
982 983 984 985
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 电台节目 的所有评论 (
不需要登录 )

**必选参数 :** `id`: 电台节目的 id
986

B
improve  
binaryify 已提交
987
**可选参数 :** `limit`: 取出评论数量 , 默认为 20
988

B
improve  
binaryify 已提交
989
`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值
990

B
improve  
binaryify 已提交
991
**接口地址 :** `/comment/dj`
992

B
improve  
binaryify 已提交
993
**调用例子 :** `/comment/dj?id=794062371`
994

995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010
### 视频评论

说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 视频 的所有评论 (
不需要登录 )

**必选参数 :** `id`: 视频的 id

**可选参数 :** `limit`: 取出评论数量 , 默认为 20

`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值

**接口地址 :** `/comment/video`

**调用例子 :** `/comment/video?id=89ADDE33C0AAE8EC14B99F6750DB954D`

### 热门评论
B
v2.20.3  
binaryify 已提交
1011 1012

说明 : 调用此接口 , 传入 type, 资源 id 可获得对应资源热门评论 ( 不需要登录 )
1013 1014 1015 1016 1017 1018 1019 1020 1021

**必选参数 :**

`id` : 资源 id

`tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型

```
0: 歌曲
1022 1023 1024



1025
1: mv
1026 1027 1028



1029
2: 歌单
1030 1031 1032



1033
3: 专辑
1034 1035 1036



1037
4: 电台
1038 1039 1040



1041
5: 视频
1042 1043 1044



1045
```
B
v2.20.3  
binaryify 已提交
1046

1047 1048 1049 1050
**接口地址 :** `/comment/hot`

**调用例子 :** `/comment/hot?id=186016&type=0`

B
binaryify 已提交
1051 1052
### 给评论点赞

B
improve  
binaryify 已提交
1053 1054 1055 1056
说明 : 调用此接口 , 传入 type, 资源 id, 和评论 id cid 和 是否点赞参数 t 即可给对
应评论点赞 ( 需要登录 )

**必选参数 :** `id` : 资源 id, 如歌曲 id,mv id
B
binaryify 已提交
1057

B
improve  
binaryify 已提交
1058
`cid` : 评论 id
B
binaryify 已提交
1059

B
improve  
binaryify 已提交
1060
`t` : 是否点赞 ,1 为点赞 ,0 为取消点赞
B
binaryify 已提交
1061

1062
`tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型
B
binaryify 已提交
1063

B
binaryify 已提交
1064 1065
```
0: 歌曲
1066 1067 1068



B
binaryify 已提交
1069
1: mv
1070 1071 1072



B
binaryify 已提交
1073
2: 歌单
1074 1075 1076



N
nujhong 已提交
1077
3: 专辑
1078 1079 1080



B
binaryify 已提交
1081
4: 电台
1082 1083 1084



1085
5: 视频
1086 1087 1088



B
improve  
binaryify 已提交
1089
```
N
nujhong 已提交
1090

B
improve  
binaryify 已提交
1091
**接口地址 :** `comment/like`
B
binaryify 已提交
1092

B
binaryify 已提交
1093
**调用例子 :** `/comment/like?id=29178366&cid=12840183&t=1&type=0` 对应给 [https://music.163.com/#/song?id=29178366](https://music.163.com/#/song?id=29178366) 最热门的评论点赞
B
binaryify 已提交
1094

B
binaryify 已提交
1095 1096 1097 1098 1099 1100 1101 1102
### 发送/删除评论

说明 : 调用此接口,可发送评论或者删除评论

**接口地址 :** `/comment`

1. 发送评论

B
binaryify 已提交
1103
   **必选参数**
1104

B
v3.0.0  
binaryify 已提交
1105
   `t`:1 发送
B
binaryify 已提交
1106

1107
   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型
B
binaryify 已提交
1108 1109 1110

   ```
   0: 歌曲
1111 1112 1113

   

B
binaryify 已提交
1114
   1: mv
1115 1116 1117

   

B
binaryify 已提交
1118
   2: 歌单
1119 1120 1121

   

B
binaryify 已提交
1122
   3: 专辑
1123 1124 1125

   

B
binaryify 已提交
1126
   4: 电台
1127 1128 1129

   

1130
   5: 视频
1131 1132 1133

   

B
binaryify 已提交
1134 1135 1136 1137 1138 1139
   ```

   `id`:对应资源 id

   `content` :要发送的内容

B
v3.0.0  
binaryify 已提交
1140
   **调用例子** : `/comment?t=1&type=1&id=5436712&content=test` (往广岛之恋 mv 发送评论: test)
B
binaryify 已提交
1141 1142

2. 删除评论
B
binaryify 已提交
1143 1144

   **必选参数**
1145

B
v3.0.0  
binaryify 已提交
1146
   `t`:0 删除
B
binaryify 已提交
1147

1148
   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型
B
binaryify 已提交
1149 1150 1151

   ```
   0: 歌曲
1152 1153 1154

   

B
binaryify 已提交
1155
   1: mv
1156 1157 1158

   

B
binaryify 已提交
1159
   2: 歌单
1160 1161 1162

   

B
binaryify 已提交
1163
   3: 专辑
1164 1165 1166

   

B
binaryify 已提交
1167
   4: 电台
1168 1169 1170

   

1171
   5: 视频
1172 1173 1174

   

B
binaryify 已提交
1175 1176 1177 1178
   ```

   `id`:对应资源 id
   `content` :内容 id,可通过 `/comment/mv` 等接口获取
B
binaryify 已提交
1179

B
v3.0.0  
binaryify 已提交
1180
   **调用例子** : `/comment?t=0&type=1&id=5436712&commentId=1535550516319` (在广岛之恋 mv 删除评论)
B
binaryify 已提交
1181

1182 1183
### banner

B
binaryify 已提交
1184
说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据
1185

B
improve  
binaryify 已提交
1186 1187 1188
**接口地址 :** `/banner`

**调用例子 :** `/banner`
B
binaryify 已提交
1189

B
v3.0.0  
binaryify 已提交
1190 1191
### 资源点赞( MV,电台,视频)

B
binaryify 已提交
1192
说明 : 调用此接口 , 可对 MV,电台,视频点赞
B
v3.0.0  
binaryify 已提交
1193

B
binaryify 已提交
1194
**必选参数 :**
B
v3.0.0  
binaryify 已提交
1195 1196

`type`:资源类型,对应以下类型
B
binaryify 已提交
1197

B
v3.0.0  
binaryify 已提交
1198 1199
```
1: mv
1200 1201 1202



B
v3.0.0  
binaryify 已提交
1203
4: 电台
1204 1205 1206



B
v3.0.0  
binaryify 已提交
1207
5: 视频
1208 1209 1210



B
v3.0.0  
binaryify 已提交
1211 1212
```

B
binaryify 已提交
1213
`t`: 操作,1 为点赞,其他未取消点赞
B
v3.0.0  
binaryify 已提交
1214

B
binaryify 已提交
1215
`id`: 资源 id
B
v3.0.0  
binaryify 已提交
1216 1217 1218 1219 1220

**接口地址 :** `/resource/like`

**调用例子 :** `/resource/like?t=1&type=1&id=5436712`

B
binaryify 已提交
1221 1222
### 获取歌曲详情

B
v3.0.0  
binaryify 已提交
1223
说明 : 调用此接口 , 传入音乐 id(支持多个 id, 用 `,` 隔开), 可获得歌曲详情(注意:歌曲封面现在需要通过专辑内容接口获取)
B
binaryify 已提交
1224

B
improve  
binaryify 已提交
1225
**必选参数 :** `ids`: 音乐 id, 如 `ids=347230`
B
binaryify 已提交
1226

B
improve  
binaryify 已提交
1227
**接口地址 :** `/song/detail`
B
binaryify 已提交
1228

B
v3.0.0  
binaryify 已提交
1229
**调用例子 :** `/song/detail?ids=347230`,`/song/detail?ids=347230,347231`
B
binaryify 已提交
1230

B
improve  
binaryify 已提交
1231 1232
返回数据如下图 :
![获取歌曲详情](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/songDetail.png)
B
binaryify 已提交
1233

B
binaryify 已提交
1234
### 获取专辑内容
1235

B
improve  
binaryify 已提交
1236
说明 : 调用此接口 , 传入专辑 id, 可获得专辑内容
1237

B
improve  
binaryify 已提交
1238
**必选参数 :** `id`: 专辑 id
1239

B
improve  
binaryify 已提交
1240
**接口地址 :** `/album`
1241

B
improve  
binaryify 已提交
1242 1243 1244
**调用例子 :** `/album?id=32311`

返回数据如下图 :
1245
![获取专辑内容](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E4%B8%93%E8%BE%91.png)
1246

1247
### 获取歌手单曲
1248

B
improve  
binaryify 已提交
1249
说明 : 调用此接口 , 传入歌手 id, 可获得歌手部分信息和热门歌曲
B
improve  
binaryify 已提交
1250 1251

**必选参数 :** `id`: 歌手 id, 可由搜索接口获得
1252

B
improve  
binaryify 已提交
1253
**接口地址 :** `/artists`
1254

B
improve  
binaryify 已提交
1255
**调用例子 :** `/artists?id=6452`
1256

B
improve  
binaryify 已提交
1257
返回数据如下图 :
1258 1259
![获取歌手单曲](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/artists.png)

1260
### 获取歌手 mv
B
improve  
binaryify 已提交
1261 1262 1263

说明 : 调用此接口 , 传入歌手 id, 可获得歌手 mv 信息 , 具体 mv 播放地址可调
`/mv`传入此接口获得的 mvid 来拿到 , 如 :
1264 1265
`/artist/mv?id=6452`,`/mv?mvid=5461064`

B
improve  
binaryify 已提交
1266
**必选参数 :** `id`: 歌手 id, 可由搜索接口获得
1267

B
improve  
binaryify 已提交
1268
**接口地址 :** `/artist/mv`
1269

B
improve  
binaryify 已提交
1270
**调用例子 :** `/artist/mv?id=6452`
1271

1272
### 获取歌手专辑
1273

B
improve  
binaryify 已提交
1274
说明 : 调用此接口 , 传入歌手 id, 可获得歌手专辑内容
1275

B
improve  
binaryify 已提交
1276
**必选参数 :** `id`: 歌手 id
1277

B
improve  
binaryify 已提交
1278
**可选参数 :** `limit`: 取出数量 , 默认为 50
B
binaryify 已提交
1279

B
improve  
binaryify 已提交
1280 1281
`offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*50, 其中 50 为 limit 的值 , 默认
为 0
1282

B
improve  
binaryify 已提交
1283
**接口地址 :** `/artist/album`
1284

B
improve  
binaryify 已提交
1285 1286 1287
**调用例子 :** `/artist/album?id=6452&limit=30` ( 周杰伦 )

返回数据如下图 :
1288
![获取专辑内容](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/artist_album.png)
1289

1290 1291
### 获取歌手描述

B
improve  
binaryify 已提交
1292 1293 1294
说明 : 调用此接口 , 传入歌手 id, 可获得歌手描述

**必选参数 :** `id`: 歌手 id
1295

B
improve  
binaryify 已提交
1296
**接口地址 :** `/artist/desc`
1297

B
improve  
binaryify 已提交
1298
**调用例子 :** `/artist/desc?id=6452` ( 周杰伦 )
1299 1300 1301

### 获取相似歌手

B
improve  
binaryify 已提交
1302 1303 1304
说明 : 调用此接口 , 传入歌手 id, 可获得相似歌手

**必选参数 :** `id`: 歌手 id
1305

B
improve  
binaryify 已提交
1306
**接口地址 :** `/simi/artist`
1307

B
improve  
binaryify 已提交
1308
**调用例子 :** `/simi/artist?id=6452` ( 对应和周杰伦相似歌手 )
1309 1310 1311

### 获取相似歌单

B
improve  
binaryify 已提交
1312
说明 : 调用此接口 , 传入歌曲 id, 可获得相似歌单
1313

B
improve  
binaryify 已提交
1314
**必选参数 :** `id`: 歌曲 id
1315

B
improve  
binaryify 已提交
1316
**接口地址 :** `/simi/playlist`
1317

B
improve  
binaryify 已提交
1318
**调用例子 :** `/simi/playlist?id=347230` ( 对应 ' 光辉岁月 ' 相似歌单 )
1319 1320 1321

### 相似 mv

B
binaryify 已提交
1322 1323 1324
说明 : 调用此接口 , 传入 `mvid` 可获取相似 mv

**必选参数 :** `mvid`: mv id
1325

B
improve  
binaryify 已提交
1326
**接口地址 :** `/simi/mv`
1327

B
improve  
binaryify 已提交
1328
**调用例子 :** `/simi/mv?mvid=5436712`
1329 1330 1331

### 获取相似音乐

B
improve  
binaryify 已提交
1332
说明 : 调用此接口 , 传入歌曲 id, 可获得相似歌曲
1333

B
improve  
binaryify 已提交
1334
**必选参数 :** `id`: 歌曲 id
1335

B
improve  
binaryify 已提交
1336
**接口地址 :** `/simi/song`
1337

B
improve  
binaryify 已提交
1338
**调用例子 :** `/simi/song?id=347230` ( 对应 ' 光辉岁月 ' 相似歌曲 )
1339

B
improve  
binaryify 已提交
1340
### 获取最近 5 个听了这首歌的用户
1341

B
improve  
binaryify 已提交
1342
说明 : 调用此接口 , 传入歌曲 id, 最近 5 个听了这首歌的用户
1343

B
improve  
binaryify 已提交
1344
**必选参数 :** `id`: 歌曲 id
1345

B
improve  
binaryify 已提交
1346 1347 1348
**接口地址 :** `/simi/user`

**调用例子 :** `/simi/user?id=347230` ( 对应 ' 光辉岁月 ' 相似歌曲 )
1349

B
binaryify 已提交
1350
### 获取每日推荐歌单
1351

B
improve  
binaryify 已提交
1352 1353 1354
说明 : 调用此接口 , 可获得每日推荐歌单 ( 需要登录 )

**接口地址 :** `/recommend/resource`
1355

B
improve  
binaryify 已提交
1356
**调用例子 :** `/recommend/resource`
1357

B
improve  
binaryify 已提交
1358
返回数据如下图 :
1359
![每日推荐歌单](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%8E%A8%E8%8D%90%E6%AD%8C%E5%8D%95.png)
1360

B
binaryify 已提交
1361
### 获取每日推荐歌曲
1362

B
improve  
binaryify 已提交
1363
说明 : 调用此接口 , 可获得每日推荐歌曲 ( 需要登录 )
1364

B
improve  
binaryify 已提交
1365
**接口地址 :** `/recommend/songs`
1366

B
improve  
binaryify 已提交
1367
**调用例子 :** `/recommend/songs`
B
binaryify 已提交
1368

B
improve  
binaryify 已提交
1369 1370
返回数据如下图 :
![每日推荐歌曲](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%8E%A8%E8%8D%90%E6%AD%8C%E6%9B%B2.png)
1371 1372 1373

### 私人 FM

B
improve  
binaryify 已提交
1374 1375 1376
说明 : 私人 FM( 需要登录 )

**接口地址 :** `/personal_fm`
1377

B
improve  
binaryify 已提交
1378
**调用例子 :** `/personal_fm`
1379

B
improve  
binaryify 已提交
1380
返回数据如下图 :
1381 1382 1383 1384 1385

![私人 FM](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/personal_fm.png)

### 签到

B
improve  
binaryify 已提交
1386 1387 1388
说明 : 调用此接口 , 传入签到类型 ( 可不传 , 默认安卓端签到 ), 可签到 ( 需要登录
), 其中安卓端签到可获得 3 点经验 , web/PC 端签到可获得 2 点经验

B
improve  
binaryify 已提交
1389
**可选参数 :** `type`: 签到类型 , 默认 0, 其中 0 为安卓端签到 ,1 为 web/PC 签到
1390

B
improve  
binaryify 已提交
1391
**接口地址 :** `/daily_signin`
1392

B
improve  
binaryify 已提交
1393 1394 1395
**调用例子 :** `/daily_signin`

返回数据如下图 :
1396

B
binaryify 已提交
1397
![签到成功](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/signinSuccess.png)
1398 1399 1400 1401

![签到失败](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/signinError.png)

### 喜欢音乐
B
binaryify 已提交
1402

B
improve  
binaryify 已提交
1403 1404 1405
说明 : 调用此接口 , 传入音乐 id, 可喜欢该音乐

**必选参数 :** `id`: 歌曲 id
1406

B
improve  
binaryify 已提交
1407
**可选参数 :** `like`: 布尔值 , 默认为 true 即喜欢 , 若传 false, 则取消喜欢
1408

B
improve  
binaryify 已提交
1409
**接口地址 :** `/like`
1410

B
improve  
binaryify 已提交
1411
**调用例子 :** `/like?id=347230`
1412

B
improve  
binaryify 已提交
1413
返回数据如下图 :
1414 1415 1416

![喜欢成功](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/like.png)

B
improve  
binaryify 已提交
1417
喜欢成功则返回数据的 code 为 200, 其余为失败
B
binaryify 已提交
1418

1419 1420
![喜欢成功截图](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/likeSuccess.png)

1421 1422 1423 1424 1425 1426 1427 1428 1429 1430
### 喜欢音乐列表

说明 : 调用此接口 , 传入用户 id, 可获取已喜欢音乐id列表(id数组)

**必选参数 :** `uid`: 用户 id

**接口地址 :** `/likelist`

**调用例子 :** `/likelist?uid=32953014`

1431 1432
### 垃圾桶

B
improve  
binaryify 已提交
1433 1434 1435
说明 : 调用此接口 , 传入音乐 id, 可把该音乐从私人 FM 中移除至垃圾桶

**必选参数 :** `id`: 歌曲 id
1436

B
improve  
binaryify 已提交
1437
**接口地址 :** `/fm_trash`
1438

B
improve  
binaryify 已提交
1439
**调用例子 :** `/fm_trash?id=347230`
1440

B
improve  
binaryify 已提交
1441
返回数据如下图 :
1442 1443 1444

![移除成功](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/fm_trash.png)

1445
### 新碟上架
N
nujhong 已提交
1446

B
improve  
binaryify 已提交
1447 1448 1449 1450
说明 : 调用此接口 , 可获取新碟上架列表 , 如需具体音乐信息需要调用获取专辑列表接
`/album` , 然后传入 id, 如 `/album?id=32311&limit=30`

**可选参数 :** `limit`: 取出数量 , 默认为 50
1451

B
improve  
binaryify 已提交
1452 1453
`offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*50, 其中 50 为 limit 的值 , 默认
为 0
1454

B
improve  
binaryify 已提交
1455
**接口地址 :** `/top/album`
1456

B
improve  
binaryify 已提交
1457
**调用例子 :** `/top/album?offset=0&limit=30`
1458

B
improve  
binaryify 已提交
1459
返回数据如下图 :
1460 1461 1462 1463

![新碟上架](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/new_albums.png)

### 热门歌手
N
nujhong 已提交
1464

B
improve  
binaryify 已提交
1465 1466 1467
说明 : 调用此接口 , 可获取热门歌手数据

**可选参数 :** `limit`: 取出数量 , 默认为 50
1468

B
improve  
binaryify 已提交
1469 1470
`offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*50, 其中 50 为 limit 的值 , 默认
为 0
1471

B
improve  
binaryify 已提交
1472
**接口地址 :** `/top/artists`
1473

B
improve  
binaryify 已提交
1474
**调用例子 :** `/top/artists?offset=0&limit=30`
1475

B
improve  
binaryify 已提交
1476
返回数据如下图 :
1477 1478 1479

![热门歌手](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_artists.png)

1480
### 最新 mv
N
nujhong 已提交
1481

B
improve  
binaryify 已提交
1482
说明 : 调用此接口 , 可获取最新 mv
1483

B
improve  
binaryify 已提交
1484
**可选参数 :** `limit`: 取出数量 , 默认为 30
1485

B
improve  
binaryify 已提交
1486 1487 1488
**接口地址 :** `/mv/first`

**调用例子 :** `/mv/first?limit=10`
1489 1490

### 推荐 mv
N
nujhong 已提交
1491

B
improve  
binaryify 已提交
1492 1493 1494
说明 : 调用此接口 , 可获取推荐 mv

**接口地址 :** `/personalized/mv`
1495

B
improve  
binaryify 已提交
1496
**调用例子 :** `/personalized/mv`
1497 1498

### 推荐歌单
N
nujhong 已提交
1499

B
improve  
binaryify 已提交
1500 1501 1502
说明 : 调用此接口 , 可获取推荐歌单

**接口地址 :** `/personalized`
1503

B
improve  
binaryify 已提交
1504
**调用例子 :** `/personalized`
1505 1506

### 推荐新音乐
N
nujhong 已提交
1507

B
improve  
binaryify 已提交
1508
说明 : 调用此接口 , 可获取推荐新音乐
1509

B
improve  
binaryify 已提交
1510 1511 1512
**接口地址 :** `/personalized/newsong`

**调用例子 :** `/personalized/newsong`
1513 1514

### 推荐电台
N
nujhong 已提交
1515

B
improve  
binaryify 已提交
1516 1517 1518
说明 : 调用此接口 , 可获取推荐电台

**接口地址 :** `/personalized/djprogram`
1519

B
improve  
binaryify 已提交
1520
**调用例子 :** `/personalized/djprogram`
1521 1522

### 推荐节目
N
nujhong 已提交
1523

B
improve  
binaryify 已提交
1524 1525 1526
说明 : 调用此接口 , 可获取推荐电台

**接口地址 :** `/program/recommend`
1527

B
improve  
binaryify 已提交
1528
**调用例子 :** `/program/recommend`
1529 1530

### 独家放送
N
nujhong 已提交
1531

B
improve  
binaryify 已提交
1532
说明 : 调用此接口 , 可获取独家放送
1533

B
improve  
binaryify 已提交
1534
**接口地址 :** `/personalized/privatecontent`
1535

B
improve  
binaryify 已提交
1536
**调用例子 :** `/personalized/privatecontent`
1537 1538

### mv 排行
N
nujhong 已提交
1539

B
improve  
binaryify 已提交
1540
说明 : 调用此接口 , 可获取 mv 排行
1541

B
improve  
binaryify 已提交
1542
**可选参数 :** `limit`: 取出数量 , 默认为 30
1543

B
improve  
binaryify 已提交
1544 1545
`offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认
为 0
1546

B
improve  
binaryify 已提交
1547 1548 1549
**接口地址 :** `top/mv`

**调用例子 :** `top/mv?limit=10`
1550 1551

### 获取 mv 数据
N
nujhong 已提交
1552

B
improve  
binaryify 已提交
1553 1554
说明 : 调用此接口 , 传入 mvid ( 在搜索音乐的时候传 type=1004 获得 ) , 可获取对应
MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等数据 , 其中 mv 视频
B
v3.0.0  
binaryify 已提交
1555
网易做了防盗链处理 , 可能不能直接播放 , 需要播放的话需要调用 ' mv 地址' 接口
B
binaryify 已提交
1556

B
improve  
binaryify 已提交
1557
**必选参数 :** `mvid`: mv 的 id
B
binaryify 已提交
1558

B
v3.0.0  
binaryify 已提交
1559
**接口地址 :** `/mv/detail`
B
binaryify 已提交
1560

B
v3.0.0  
binaryify 已提交
1561
**调用例子 :** `/mv/detail?mvid=5436712`
B
binaryify 已提交
1562

B
improve  
binaryify 已提交
1563
返回数据如下图 :
B
binaryify 已提交
1564

B
improve  
binaryify 已提交
1565
![热门歌手](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/mv.png)
B
binaryify 已提交
1566

B
v3.0.0  
binaryify 已提交
1567
### mv 地址
1568

B
v3.0.0  
binaryify 已提交
1569 1570 1571 1572 1573 1574 1575
说明 : 调用此接口 , 传入 mv id,可获取 mv 播放地址

**可选参数 :** `url`: mv id

**接口地址 :** `/mv/url`

**调用例子 :**
1576

B
v3.0.0  
binaryify 已提交
1577 1578 1579
`/mv/url?id=5436712`

### 相关视频
B
binaryify 已提交
1580

B
v3.0.0  
binaryify 已提交
1581
说明 : 调用此接口 , 可获取相关视频
1582

B
binaryify 已提交
1583
**必选参数 :** `id`: 视频 的 id
1584

B
v3.0.0  
binaryify 已提交
1585
**接口地址 :** `/related/allvideo`
1586

B
v3.0.0  
binaryify 已提交
1587
**调用例子 :** `/related/allvideo?id=89ADDE33C0AAE8EC14B99F6750DB954D`
1588

B
v3.0.0  
binaryify 已提交
1589
### 视频详情
B
binaryify 已提交
1590

B
v3.0.0  
binaryify 已提交
1591
说明 : 调用此接口 , 可获取相关视频
1592

B
v3.0.0  
binaryify 已提交
1593
**必选参数 :** `id`: 视频 的 id
1594

B
v3.0.0  
binaryify 已提交
1595
**接口地址 :** `/video/detail`
N
nujhong 已提交
1596

B
v3.0.0  
binaryify 已提交
1597
**调用例子 :** `/video/detail?id=89ADDE33C0AAE8EC14B99F6750DB954D`
B
binaryify 已提交
1598

B
v3.0.0  
binaryify 已提交
1599
### 获取视频数据
B
binaryify 已提交
1600

B
v3.0.0  
binaryify 已提交
1601 1602
说明 : 调用此接口 , 传入视频的 id ( 在搜索音乐的时候传 type=1014 获得 ) , 可获取对应
视频数据,其中视频网易做了防盗链处理 , 可能不能直接播放 , 需要播放的话需要调用 ' 播放 mv/视频' 接口
B
improve  
binaryify 已提交
1603

B
v3.0.0  
binaryify 已提交
1604 1605 1606 1607 1608 1609 1610
**必选参数 :** `id`: 视频 的 id

**接口地址 :** `/video/url`

**调用例子 :** `/video/url?id=89ADDE33C0AAE8EC14B99F6750DB954D`

返回数据如下图 :
B
binaryify 已提交
1611

B
v3.0.0  
binaryify 已提交
1612
![视频数据](https://ws1.sinaimg.cn/large/006tNbRwgy1fuqdv10p5rj31kw0da76y.jpg)
B
binaryify 已提交
1613

B
binaryify 已提交
1614
### 排行榜
1615

B
improve  
binaryify 已提交
1616 1617 1618
说明 : 调用此接口 , 传入数字 idx, 可获取不同排行榜

**必选参数 :** `idx`: 对象 key, 对应以下排行榜
B
binaryify 已提交
1619 1620

```
B
improve  
binaryify 已提交
1621
"0": 云音乐新歌榜,
1622 1623 1624



B
improve  
binaryify 已提交
1625
"1": 云音乐热歌榜,
1626 1627 1628



B
improve  
binaryify 已提交
1629
"2": 网易原创歌曲榜,
1630 1631 1632



B
improve  
binaryify 已提交
1633
"3": 云音乐飙升榜,
1634 1635 1636



B
improve  
binaryify 已提交
1637
"4": 云音乐电音榜,
1638 1639 1640



B
improve  
binaryify 已提交
1641
"5": UK排行榜周榜,
1642 1643 1644



B
improve  
binaryify 已提交
1645
"6": 美国Billboard周榜
1646 1647 1648



B
improve  
binaryify 已提交
1649
"7": KTV嗨榜,
1650 1651 1652



B
improve  
binaryify 已提交
1653
"8": iTunes榜,
1654 1655 1656



B
improve  
binaryify 已提交
1657
"9": Hit FM Top榜,
1658 1659 1660



B
improve  
binaryify 已提交
1661
"10": 日本Oricon周榜
1662 1663 1664



B
improve  
binaryify 已提交
1665
"11": 韩国Melon排行榜周榜,
1666 1667 1668



B
improve  
binaryify 已提交
1669
"12": 韩国Mnet排行榜周榜,
1670 1671 1672



B
improve  
binaryify 已提交
1673
"13": 韩国Melon原声周榜,
1674 1675 1676



B
improve  
binaryify 已提交
1677
"14": 中国TOP排行榜(港台榜),
1678 1679 1680



B
improve  
binaryify 已提交
1681
"15": 中国TOP排行榜(内地榜)
1682 1683 1684



B
improve  
binaryify 已提交
1685
"16": 香港电台中文歌曲龙虎榜,
1686 1687 1688



B
improve  
binaryify 已提交
1689
"17": 华语金曲榜,
1690 1691 1692



B
improve  
binaryify 已提交
1693
"18": 中国嘻哈榜,
1694 1695 1696



B
improve  
binaryify 已提交
1697
"19": 法国 NRJ EuroHot 30周榜,
1698 1699 1700



B
improve  
binaryify 已提交
1701
"20": 台湾Hito排行榜,
1702 1703 1704



N
nujhong 已提交
1705
"21": Beatport全球电子舞曲榜,
1706 1707 1708



N
nujhong 已提交
1709
"22": 云音乐ACG音乐榜,
1710 1711 1712



N
nujhong 已提交
1713
"23": 云音乐嘻哈榜
1714 1715 1716



N
nujhong 已提交
1717
```
B
binaryify 已提交
1718

B
improve  
binaryify 已提交
1719
**接口地址 :** `/top/list`
B
binaryify 已提交
1720

B
improve  
binaryify 已提交
1721
**调用例子 :** `/top/list?idx=6`
B
binaryify 已提交
1722

B
improve  
binaryify 已提交
1723
返回数据如下图 :
B
binaryify 已提交
1724 1725

![排行榜](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_list.png)
1726

B
v3.0.0  
binaryify 已提交
1727
### 所有榜单内容摘要
B
binaryify 已提交
1728

B
v3.0.0  
binaryify 已提交
1729 1730 1731 1732 1733
说明 : 调用此接口,可获取所有榜单内容摘要
**接口地址 :** `/toplist/detail`

**调用例子 :** `/toplist/detail`

H
hzw758 已提交
1734 1735
### 歌手榜

B
v3.0.0  
binaryify 已提交
1736
说明 : 调用此接口 , 可获取排行榜中的歌手榜
H
hzw758 已提交
1737

B
improve  
binaryify 已提交
1738 1739 1740
**接口地址 :** `/toplist/artist`

**调用例子 :** `/toplist/artist`
1741 1742 1743

### 云盘

B
improve  
binaryify 已提交
1744
说明 : 登陆后调用此接口 , 可获取云盘数据 , 获取的数据没有对应 url, 需要再调用一
B
v3.0.0  
binaryify 已提交
1745
`/song/url` 获取 url
B
improve  
binaryify 已提交
1746 1747 1748 1749

**接口地址 :** `/user/cloud`

**调用例子 :** `/user/cloud`
1750

B
improve  
binaryify 已提交
1751
### 电台 - 推荐
1752

B
improve  
binaryify 已提交
1753
说明 : 登陆后调用此接口 , 可获得推荐电台
1754

B
improve  
binaryify 已提交
1755
**接口地址 :** `/dj/recommend`
1756

B
improve  
binaryify 已提交
1757
**调用例子 :** `/dj/recommend`
1758

B
improve  
binaryify 已提交
1759
### 电台 - 分类
1760

B
improve  
binaryify 已提交
1761
说明 : 登陆后调用此接口 , 可获得电台类型
1762

B
improve  
binaryify 已提交
1763
**接口地址 :** `/dj/catelist`
1764

B
improve  
binaryify 已提交
1765
**调用例子 :** `/dj/catelist`
1766

B
improve  
binaryify 已提交
1767
### 电台 - 分类推荐
1768

B
improve  
binaryify 已提交
1769
说明 : 登陆后调用此接口 , 可获得推荐电台
1770

B
improve  
binaryify 已提交
1771 1772
**必选参数 :** `type`: 电台类型 , 数字 , 可通过`/dj/catelist`获取 , 对应关系为
id 对应 此接口的 type, name 对应类型意义
1773

B
improve  
binaryify 已提交
1774
**接口地址 :** `/dj/recommend/type`
1775

B
improve  
binaryify 已提交
1776
**调用例子 :** `/dj/recommend/type?type=1`
1777

B
improve  
binaryify 已提交
1778
### 电台 - 订阅
1779

B
improve  
binaryify 已提交
1780 1781
说明 : 登陆后调用此接口 , 传入`rid`, 可订阅 dj,dj 的 `rid` 可通过搜索指定
type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009`
1782

B
improve  
binaryify 已提交
1783
**必选参数 :** `rid`: 电台 的 id
1784

B
improve  
binaryify 已提交
1785
**接口地址 :** `/dj/sub`
1786

B
improve  
binaryify 已提交
1787 1788
**调用例子 :** `/dj/sub?rid=336355127&t=1` ( 对应关注 ' 代码时间 ')
`/dj/sub?rid=336355127&t=0` ( 对应取消关注 ' 代码时间 ')
1789

1790 1791 1792 1793 1794 1795 1796 1797
### 电台的订阅列表

说明 : 登陆后调用此接口 , 可获取订阅的电台列表

**接口地址 :** `/dj/sublist`

**调用例子 :** `/dj/sublist`

add doc  
徐星宇 已提交
1798 1799 1800 1801 1802 1803 1804 1805
### 电台 - 付费精选

说明 : 可以获取付费精选的电台列表 , 传入 `limit``offset` 可以进行分页

**接口地址 :** `/dj/paygift`

**调用例子 :** `/dj/paygift?limit=10&offset=20`

B
improve  
binaryify 已提交
1806
### 电台 - 详情
1807

B
improve  
binaryify 已提交
1808
说明 : 登陆后调用此接口 , 传入`rid`, 可获得对应电台的详情介绍
1809

B
improve  
binaryify 已提交
1810
**必选参数 :** `rid`: 电台 的 id
1811

B
improve  
binaryify 已提交
1812
**接口地址 :** `/dj/detail?rid=336355127`
1813

B
improve  
binaryify 已提交
1814
**调用例子 :** `/dj/detail?rid=336355127` ( 对应 ' 代码时间 ' 的详情介绍 )
1815

B
improve  
binaryify 已提交
1816
### 电台 - 节目
1817

B
improve  
binaryify 已提交
1818
说明 : 登陆后调用此接口 , 传入`rid`, 可查看对应电台的电台节目以及对应的 id, 需要
B
v3.0.0  
binaryify 已提交
1819 1820
注意的是这个接口返回的 mp3Url 已经无效 , 都为 null, 但是通过调用 `/song/url`
个接口 , 传入节目 id 仍然能获取到节目音频 , 如 `/song/url?id=478446370` 获取代
B
improve  
binaryify 已提交
1821 1822 1823 1824
码时间的一个节目的音频

**必选参数 :** `rid`: 电台 的 id

B
binaryify 已提交
1825
**可选参数 :**
1826

B
binaryify 已提交
1827 1828 1829 1830 1831
`limit` : 返回数量 , 默认为 30

`offset` : 偏移数量,用于分页 , 如
: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0

B
improve  
binaryify 已提交
1832 1833
**接口地址 :** `/dj/program`

B
binaryify 已提交
1834
**调用例子 :** `/dj/program?rid=336355127&limit=40` ( 对应 ' 代码时间 ' 的节目列表 )
1835

B
binaryify 已提交
1836
## 离线访问此文档
B
binaryify 已提交
1837

B
improve  
binaryify 已提交
1838
此文档同时也是 Progressive Web Apps(PWA), 加入了 serviceWorker, 可离线访问
B
binaryify 已提交
1839 1840

## 关于此文档
B
improve  
binaryify 已提交
1841 1842 1843 1844

此文档由 [docsify](https://github.com/QingWei-Li/docsify/) 生成 docsify 是一个动
态生成文档网站的工具。不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html
文件,所有转换工作都是在运行时进行。
B
binaryify 已提交
1845

B
binaryify 已提交
1846
## License
B
improve  
binaryify 已提交
1847

B
binaryify 已提交
1848
[The MIT License (MIT)](https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/LICENSE)