README.md 41.8 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
$ npm install
B
binaryify 已提交
113
```
B
improve  
binaryify 已提交
114

115
## 运行
B
improve  
binaryify 已提交
116 117

```shell
N
nujhong 已提交
118
$ node app.js
B
binaryify 已提交
119 120
```

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

B
binaryify 已提交
123 124 125 126
```shell
$ PORT=4000 node app.js
```

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

B
binaryify 已提交
129 130 131
```shell
$ set PORT=4000 && node app.js
```
B
binaryify 已提交
132

133 134 135 136 137 138
## 可以使用代理

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

```javascript
// 例子
B
v3.0.0  
binaryify 已提交
139
const url = `http://localhost:3000/song/url?id=33894312&proxy=http://121.196.226.246:84`
140 141 142 143 144 145 146
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 已提交
147

B
binaryify 已提交
148
## 更新到 v3.0 说明
B
binaryify 已提交
149

B
binaryify 已提交
150
!>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+ 将不再维护
151

B
improve  
binaryify 已提交
152 153
## Docker 容器运行

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

request 相关的环境变量

158 159 160 161 162 163 164
1. http_proxy
2. https_proxy
3. HTTP_PROXY
4. HTTPS_PROXY
5. no_proxy
6. NO_PROXY

165
```shell
166
docker pull twesix/netease-cloud-music
167

168 169 170
docker run -d -p 3000:3000 --name netease-cloud-music twesix/netease-music-api

// 去掉或者设置相关的环境变量
171

172
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
173
```
B
binaryify 已提交
174

175 176 177 178
> 由于 docker 镜像更新不是很及时,推荐自己 build, 以下为 build 镜像的方式

```
$ git clone https://github.com/Binaryify/NeteaseCloudMusicApi && cd NeteaseCloudMusicApi
179

180
$ sudo docker build . -t netease-music-api
181

182 183
$ sudo docker run -d -p 3000:3000 netease-music-api
```
B
binaryify 已提交
184

185
## 接口文档
B
improve  
binaryify 已提交
186

B
binaryify 已提交
187
### 调用前须知
B
improve  
binaryify 已提交
188

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

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

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

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

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

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

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

### 登录
B
improve  
binaryify 已提交
210 211 212

说明 : 登录有两个接口

B
improve  
binaryify 已提交
213
#### 1. 手机登录
214

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

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

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

B
improve  
binaryify 已提交
221
#### 2. 邮箱登录
B
binaryify 已提交
222

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

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

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

B
improve  
binaryify 已提交
229
**接口地址 :** `/login`
230

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

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

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

B
binaryify 已提交
239
#### 注意
B
improve  
binaryify 已提交
240 241

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

243
### 刷新登录
N
nujhong 已提交
244

B
improve  
binaryify 已提交
245 246 247
说明 : 调用此接口 , 可刷新登录状态

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

B
v2.20.3  
binaryify 已提交
249 250 251 252 253 254
### 退出登录

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

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

255
### 登录状态
B
binaryify 已提交
256

257 258 259 260 261 262
说明 : 调用此接口,可获取登录状态

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

B
binaryify 已提交
263 264
### 获取用户详情

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

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

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

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

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

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

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

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

281 282 283 284 285
### 更新用户信息

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

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

287 288
```
gender: 性别 0:保密 1:男性 2:女性
289

290
birthday: 出生日期,时间戳 unix timestamp
291

292
nickname: 用户昵称
293

294
province: 省份id
295

296
city: 城市id
297

298 299 300 301 302 303 304
signature:用户签名
```

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

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

B
binaryify 已提交
305
### 获取用户歌单
306

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

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

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

B
improve  
binaryify 已提交
313 314 315
**调用例子 :** `/user/playlist?uid=32953014`

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

318 319 320 321
### 更新歌单

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

323 324
```
id:歌单id
325

B
binaryify 已提交
326
name:歌单名字=
327

328
desc:歌单描述
329

330 331
tags:歌单tag
```
B
binaryify 已提交
332

333 334 335 336
**接口地址 :** `/playlist/update`

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

B
binaryify 已提交
337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368
### 发送私信

说明 : 登陆后调用此接口 , 传入用户 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)

369 370
### 获取用户电台

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

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

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

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

B
improve  
binaryify 已提交
379
### 获取用户关注列表
380

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

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

B
binaryify 已提交
385
**可选参数 :**
386

B
binaryify 已提交
387 388 389
`limit` : 返回数量 , 默认为 30

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

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

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

B
improve  
binaryify 已提交
396
### 获取用户粉丝列表
397

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

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

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

B
improve  
binaryify 已提交
405 406 407
**接口地址 :** `/user/followeds`

**调用例子 :** `/user/followeds?uid=32953014`
408 409 410

### 获取用户动态

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

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

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

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

B
v3.0.0  
binaryify 已提交
419 420 421 422 423 424
### 关注/取消关注用户

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

**必选参数 :**

B
binaryify 已提交
425
`id` : 用户 id
B
v3.0.0  
binaryify 已提交
426

B
binaryify 已提交
427
`t` : `1`为关注,其他为取消关注
B
v3.0.0  
binaryify 已提交
428 429 430 431 432

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

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

433 434
### 获取用户播放记录

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

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

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

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

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

Z
zhixuan 已提交
445 446
### 获取动态消息

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

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

B
improve  
binaryify 已提交
452 453 454
**接口地址 :** `/event`

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

456
### 歌手分类列表
B
binaryify 已提交
457

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

462 463 464 465
`limit` : 返回数量 , 默认为 30

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

468
category Code 取值:
B
binaryify 已提交
469

470 471
```
入驻歌手 5001
472

473
华语男歌手 1001
474

475
华语女歌手 1002
476

477
华语组合/乐队 1003
478

479
欧美男歌手 2001
480

481
欧美女歌手 2002
482

483
欧美组合/乐队 2003
484

485
日本男歌手 6001
486

487
日本女歌手 6002
488

489
日本组合/乐队 6003
490

491
韩国男歌手 7001
492

493
韩国女歌手 7002
494

495
韩国组合/乐队 7003
496

497
其他男歌手 4001
498

499
其他女歌手 4002
500

501 502 503 504 505 506 507 508 509 510
其他组合/乐队 4003
```

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

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

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

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

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

B
binaryify 已提交
515
**必选参数 :**
516

B
binaryify 已提交
517
`artistId` : 歌手 id
518

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

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

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

525
### 收藏的歌手列表
B
binaryify 已提交
526

527 528 529 530 531 532
说明 : 调用此接口,可获取收藏的歌手列表

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

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

B
v3.0.0  
binaryify 已提交
533 534 535 536
### 收藏视频

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

B
binaryify 已提交
537
**必选参数 :**
B
v3.0.0  
binaryify 已提交
538 539 540 541 542 543 544 545 546 547 548 549 550

`id` : 视频 id

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

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

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

### 收藏 MV

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

B
binaryify 已提交
551
**必选参数 :**
B
v3.0.0  
binaryify 已提交
552 553 554 555 556 557 558 559 560

`id` : MV id

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

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

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

B
binaryify 已提交
561
### 歌单分类
B
binaryify 已提交
562

B
binaryify 已提交
563 564 565 566 567 568 569
说明 : 调用此接口,可获取歌单分类,包含 category 信息

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

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

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

B
binaryify 已提交
571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593
说明 : 调用此接口,可获取歌单分类,包含 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)
594

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

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

B
improve  
binaryify 已提交
599
### 获取精品歌单
600

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

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

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

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

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

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

B
binaryify 已提交
614 615 616 617 618 619 620 621 622 623
### 相关歌单推荐

说明 : 调用此接口,传入歌单 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 已提交
624
### 获取歌单详情
625

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

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

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

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

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

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

### 获取音乐 url
641

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

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

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

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

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

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

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

660
### 音乐是否可用
B
binaryify 已提交
661

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

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

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

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

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

672
### 搜索
673

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

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

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

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

B
improve  
binaryify 已提交
686
**接口地址 :** `/search`
687

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

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

B
binaryify 已提交
693
### 热搜
B
binaryify 已提交
694

B
binaryify 已提交
695 696 697 698 699 700
说明 : 调用此接口,可获取热门搜索列表

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

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

701 702
### 搜索建议

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

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

708
**可选参数 :**
709

710 711 712
`limit` : 返回数量 , 默认为 30

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

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

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

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

B
binaryify 已提交
722 723
### 搜索多重匹配

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

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

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

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

732 733 734 735
### 新建歌单

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

B
binaryify 已提交
736
**必选参数 :** `name` : 歌单名
737 738 739 740 741 742 743 744 745 746 747 748 749

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

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

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

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

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

**必选参数 :**
750

B
binaryify 已提交
751
`t` : 类型,1:收藏,2:取消收藏
752 753 754 755 756 757 758 759 760
`id` : 歌单 id

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

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

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

761
### 对歌单添加或删除歌曲
B
binaryify 已提交
762

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

765
**必选参数 :**
766

767 768 769 770
`op`: 从歌单增加单曲为 add, 删除为 del

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

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

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

B
binaryify 已提交
776
### 获取歌词
777

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

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

B
improve  
binaryify 已提交
782
**接口地址 :** `/lyric`
783

B
improve  
binaryify 已提交
784 785 786
**调用例子 :** `/lyric?id=33894312`

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

B
binaryify 已提交
789 790 791 792 793 794 795 796 797 798
### 新歌速递

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

**必选参数 :**

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

```
全部:0
799

B
binaryify 已提交
800
华语:7
801

B
binaryify 已提交
802
欧美:96
803

B
binaryify 已提交
804
日本:8
805

B
binaryify 已提交
806 807 808 809 810 811 812 813 814 815 816
韩国:16
```

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

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

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

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

817
### 歌曲评论
818

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

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

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

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

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

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

B
improve  
binaryify 已提交
832 833
返回数据如下图 :
![获取评论](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/comment.png)
834 835 836

### 专辑评论

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

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

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

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

B
improve  
binaryify 已提交
846 847 848
**接口地址 :** `/comment/album`

**调用例子 :** `/comment/album?id=32311`
849 850 851

### 歌单评论

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

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

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

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

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

B
improve  
binaryify 已提交
863
**调用例子 :** `/comment/playlist?id=705123491`
864 865 866

### mv 评论

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

B
improve  
binaryify 已提交
870
**必选参数 :** `id`: mv id
871

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

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

B
improve  
binaryify 已提交
876 877 878
**接口地址 :** `/comment/mv`

**调用例子 :** `/comment/mv?id=5436712`
879 880 881

### 电台节目评论

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

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

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

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

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

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

895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910
### 视频评论

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

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

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

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

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

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

### 热门评论
B
v2.20.3  
binaryify 已提交
911 912

说明 : 调用此接口 , 传入 type, 资源 id 可获得对应资源热门评论 ( 不需要登录 )
913 914 915 916 917 918 919 920 921

**必选参数 :**

`id` : 资源 id

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

```
0: 歌曲
922

923
1: mv
924

925
2: 歌单
926

927
3: 专辑
928

929
4: 电台
930

931 932
5: 视频
```
B
v2.20.3  
binaryify 已提交
933

934 935 936 937
**接口地址 :** `/comment/hot`

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

B
binaryify 已提交
938 939
### 给评论点赞

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

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

B
improve  
binaryify 已提交
945
`cid` : 评论 id
B
binaryify 已提交
946

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

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

B
binaryify 已提交
951 952
```
0: 歌曲
953

B
binaryify 已提交
954
1: mv
955

B
binaryify 已提交
956
2: 歌单
957

N
nujhong 已提交
958
3: 专辑
959

B
binaryify 已提交
960
4: 电台
961

962
5: 视频
B
improve  
binaryify 已提交
963
```
N
nujhong 已提交
964

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

B
binaryify 已提交
967
**调用例子 :** `/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 已提交
968

B
binaryify 已提交
969 970 971 972 973 974 975 976
### 发送/删除评论

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

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

1. 发送评论

B
binaryify 已提交
977
   **必选参数**
978

B
v3.0.0  
binaryify 已提交
979
   `t`:1 发送
B
binaryify 已提交
980

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

   ```
   0: 歌曲
985

B
binaryify 已提交
986
   1: mv
987

B
binaryify 已提交
988
   2: 歌单
989

B
binaryify 已提交
990
   3: 专辑
991

B
binaryify 已提交
992
   4: 电台
993

994
   5: 视频
B
binaryify 已提交
995 996 997 998 999 1000
   ```

   `id`:对应资源 id

   `content` :要发送的内容

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

2. 删除评论
B
binaryify 已提交
1004 1005

   **必选参数**
1006

B
v3.0.0  
binaryify 已提交
1007
   `t`:0 删除
B
binaryify 已提交
1008

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

   ```
   0: 歌曲
1013

B
binaryify 已提交
1014
   1: mv
1015

B
binaryify 已提交
1016
   2: 歌单
1017

B
binaryify 已提交
1018
   3: 专辑
1019

B
binaryify 已提交
1020
   4: 电台
1021 1022


1023
   5: 视频
B
binaryify 已提交
1024 1025 1026 1027
   ```

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

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

B
binaryify 已提交
1032

1033 1034
### banner

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

B
improve  
binaryify 已提交
1037 1038 1039
**接口地址 :** `/banner`

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

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

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

B
binaryify 已提交
1045
**必选参数 :**
B
v3.0.0  
binaryify 已提交
1046 1047

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

B
v3.0.0  
binaryify 已提交
1049 1050
```
1: mv
1051

B
v3.0.0  
binaryify 已提交
1052
4: 电台
1053

B
v3.0.0  
binaryify 已提交
1054 1055 1056
5: 视频
```

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

B
binaryify 已提交
1059
`id`: 资源 id
B
v3.0.0  
binaryify 已提交
1060 1061 1062 1063 1064

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

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

B
binaryify 已提交
1065 1066
### 获取歌曲详情

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

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

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

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

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

B
binaryify 已提交
1078
### 获取专辑内容
1079

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

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

B
improve  
binaryify 已提交
1084
**接口地址 :** `/album`
1085

B
improve  
binaryify 已提交
1086 1087 1088
**调用例子 :** `/album?id=32311`

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

1091
### 获取歌手单曲
1092

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

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

B
improve  
binaryify 已提交
1097
**接口地址 :** `/artists`
1098

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

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

1104
### 获取歌手 mv
B
improve  
binaryify 已提交
1105 1106 1107

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

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

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

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

1116
### 获取歌手专辑
1117

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

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

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

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

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

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

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

1134 1135
### 获取歌手描述

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

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

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

B
improve  
binaryify 已提交
1142
**调用例子 :** `/artist/desc?id=6452` ( 周杰伦 )
1143 1144 1145

### 获取相似歌手

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

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

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

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

### 获取相似歌单

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

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

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

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

### 相似 mv

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

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

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

B
improve  
binaryify 已提交
1172
**调用例子 :** `/simi/mv?mvid=5436712`
1173 1174 1175

### 获取相似音乐

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1190 1191 1192
**接口地址 :** `/simi/user`

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

B
binaryify 已提交
1194
### 获取每日推荐歌单
1195

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

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

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

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

B
binaryify 已提交
1205
### 获取每日推荐歌曲
1206

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

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

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

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

### 私人 FM

B
improve  
binaryify 已提交
1218 1219 1220
说明 : 私人 FM( 需要登录 )

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

B
improve  
binaryify 已提交
1222
**调用例子 :** `/personal_fm`
1223

B
improve  
binaryify 已提交
1224
返回数据如下图 :
1225 1226 1227 1228 1229

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

### 签到

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

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

B
improve  
binaryify 已提交
1235
**接口地址 :** `/daily_signin`
1236

B
improve  
binaryify 已提交
1237 1238 1239
**调用例子 :** `/daily_signin`

返回数据如下图 :
1240

B
binaryify 已提交
1241
![签到成功](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/signinSuccess.png)
1242 1243 1244 1245

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1257
返回数据如下图 :
1258 1259 1260

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

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

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

1265 1266 1267 1268 1269 1270 1271 1272 1273 1274
### 喜欢音乐列表

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

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

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

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

1275 1276
### 垃圾桶

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

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

B
improve  
binaryify 已提交
1281
**接口地址 :** `/fm_trash`
1282

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

B
improve  
binaryify 已提交
1285
返回数据如下图 :
1286 1287 1288

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

1289
### 新碟上架
N
nujhong 已提交
1290

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

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

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

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

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

B
improve  
binaryify 已提交
1303
返回数据如下图 :
1304 1305 1306 1307

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1320
返回数据如下图 :
1321 1322 1323

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

1324
### 最新 mv
N
nujhong 已提交
1325

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

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

B
improve  
binaryify 已提交
1330 1331 1332
**接口地址 :** `/mv/first`

**调用例子 :** `/mv/first?limit=10`
1333 1334

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

B
improve  
binaryify 已提交
1336 1337 1338
说明 : 调用此接口 , 可获取推荐 mv

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

B
improve  
binaryify 已提交
1340
**调用例子 :** `/personalized/mv`
1341 1342

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

B
improve  
binaryify 已提交
1344 1345 1346
说明 : 调用此接口 , 可获取推荐歌单

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

B
improve  
binaryify 已提交
1348
**调用例子 :** `/personalized`
1349 1350

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

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

B
improve  
binaryify 已提交
1354 1355 1356
**接口地址 :** `/personalized/newsong`

**调用例子 :** `/personalized/newsong`
1357 1358

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

B
improve  
binaryify 已提交
1360 1361 1362
说明 : 调用此接口 , 可获取推荐电台

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

B
improve  
binaryify 已提交
1364
**调用例子 :** `/personalized/djprogram`
1365 1366

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

B
improve  
binaryify 已提交
1368 1369 1370
说明 : 调用此接口 , 可获取推荐电台

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

B
improve  
binaryify 已提交
1372
**调用例子 :** `/program/recommend`
1373 1374

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

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

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

B
improve  
binaryify 已提交
1380
**调用例子 :** `/personalized/privatecontent`
1381 1382

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

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

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

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

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

**调用例子 :** `top/mv?limit=10`
1394 1395

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

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

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

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

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

B
improve  
binaryify 已提交
1407
返回数据如下图 :
B
binaryify 已提交
1408

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

B
v3.0.0  
binaryify 已提交
1411
### mv 地址
1412

B
v3.0.0  
binaryify 已提交
1413 1414 1415 1416 1417 1418 1419
说明 : 调用此接口 , 传入 mv id,可获取 mv 播放地址

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

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

**调用例子 :**
1420

B
v3.0.0  
binaryify 已提交
1421 1422 1423
`/mv/url?id=5436712`

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

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

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

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

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

B
v3.0.0  
binaryify 已提交
1433
### 视频详情
B
binaryify 已提交
1434

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

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

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

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

B
v3.0.0  
binaryify 已提交
1443
### 获取视频数据
B
binaryify 已提交
1444

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

B
v3.0.0  
binaryify 已提交
1448 1449 1450 1451 1452 1453 1454
**必选参数 :** `id`: 视频 的 id

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

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

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

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

B
binaryify 已提交
1458
### 排行榜
1459

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

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

```
B
improve  
binaryify 已提交
1465
"0": 云音乐新歌榜,
1466

B
improve  
binaryify 已提交
1467
"1": 云音乐热歌榜,
1468

B
improve  
binaryify 已提交
1469
"2": 网易原创歌曲榜,
1470

B
improve  
binaryify 已提交
1471
"3": 云音乐飙升榜,
1472

B
improve  
binaryify 已提交
1473
"4": 云音乐电音榜,
1474

B
improve  
binaryify 已提交
1475
"5": UK排行榜周榜,
1476

B
improve  
binaryify 已提交
1477
"6": 美国Billboard周榜
1478

B
improve  
binaryify 已提交
1479
"7": KTV嗨榜,
1480

B
improve  
binaryify 已提交
1481
"8": iTunes榜,
1482

B
improve  
binaryify 已提交
1483
"9": Hit FM Top榜,
1484

B
improve  
binaryify 已提交
1485
"10": 日本Oricon周榜
1486

B
improve  
binaryify 已提交
1487
"11": 韩国Melon排行榜周榜,
1488

B
improve  
binaryify 已提交
1489
"12": 韩国Mnet排行榜周榜,
1490

B
improve  
binaryify 已提交
1491
"13": 韩国Melon原声周榜,
1492

B
improve  
binaryify 已提交
1493
"14": 中国TOP排行榜(港台榜),
1494

B
improve  
binaryify 已提交
1495
"15": 中国TOP排行榜(内地榜)
1496

B
improve  
binaryify 已提交
1497
"16": 香港电台中文歌曲龙虎榜,
1498

B
improve  
binaryify 已提交
1499
"17": 华语金曲榜,
1500

B
improve  
binaryify 已提交
1501
"18": 中国嘻哈榜,
1502

B
improve  
binaryify 已提交
1503
"19": 法国 NRJ EuroHot 30周榜,
1504

B
improve  
binaryify 已提交
1505
"20": 台湾Hito排行榜,
1506

N
nujhong 已提交
1507
"21": Beatport全球电子舞曲榜,
1508

N
nujhong 已提交
1509
"22": 云音乐ACG音乐榜,
1510

N
nujhong 已提交
1511 1512
"23": 云音乐嘻哈榜
```
B
binaryify 已提交
1513

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

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

B
improve  
binaryify 已提交
1518
返回数据如下图 :
B
binaryify 已提交
1519 1520

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

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

B
v3.0.0  
binaryify 已提交
1524 1525 1526 1527 1528
说明 : 调用此接口,可获取所有榜单内容摘要
**接口地址 :** `/toplist/detail`

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

H
hzw758 已提交
1529 1530
### 歌手榜

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

B
improve  
binaryify 已提交
1533 1534 1535
**接口地址 :** `/toplist/artist`

**调用例子 :** `/toplist/artist`
1536 1537 1538

### 云盘

B
improve  
binaryify 已提交
1539
说明 : 登陆后调用此接口 , 可获取云盘数据 , 获取的数据没有对应 url, 需要再调用一
B
v3.0.0  
binaryify 已提交
1540
次 `/song/url` 获取 url
B
improve  
binaryify 已提交
1541 1542 1543 1544

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

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

B
improve  
binaryify 已提交
1546
### 电台 - 推荐
1547

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

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

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

B
improve  
binaryify 已提交
1554
### 电台 - 分类
1555

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

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

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

B
improve  
binaryify 已提交
1562
### 电台 - 分类推荐
1563

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

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

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

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

B
improve  
binaryify 已提交
1573
### 电台 - 订阅
1574

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

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

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

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

1585 1586 1587 1588 1589 1590 1591 1592
### 电台的订阅列表

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

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

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

add doc  
徐星宇 已提交
1593 1594 1595 1596 1597 1598 1599 1600
### 电台 - 付费精选

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

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

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

B
improve  
binaryify 已提交
1601
### 电台 - 详情
1602

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

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

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

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

B
improve  
binaryify 已提交
1611
### 电台 - 节目
1612

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

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

B
binaryify 已提交
1620
**可选参数 :**
1621

B
binaryify 已提交
1622 1623 1624 1625 1626
`limit` : 返回数量 , 默认为 30

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

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

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

B
binaryify 已提交
1631
## 离线访问此文档
B
binaryify 已提交
1632

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

## 关于此文档
B
improve  
binaryify 已提交
1636 1637 1638 1639

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

B
binaryify 已提交
1641
## License
B
improve  
binaryify 已提交
1642

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