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. 退出登录
98 99 100 101 102 103 104 105 106
80. 所有榜单
81. 所有榜单内容摘要
82. 收藏视频
83. 收藏 MV
84. 视频详情
85. 相关视频
86. 关注用户
87. 新歌速递
88. 喜欢音乐列表(无序)
107
89. 收藏的 MV 列表
B
v3.0.0  
binaryify 已提交
108

B
improve  
binaryify 已提交
109
## 安装
B
improve  
binaryify 已提交
110 111

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

114
$ npm install
B
binaryify 已提交
115
```
B
improve  
binaryify 已提交
116

117
## 运行
B
improve  
binaryify 已提交
118 119

```shell
N
nujhong 已提交
120
$ node app.js
B
binaryify 已提交
121 122
```

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

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

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

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

135 136 137 138 139 140
## 可以使用代理

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

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

B
binaryify 已提交
150
## 更新到 v3.0 说明
B
binaryify 已提交
151

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

B
improve  
binaryify 已提交
154 155
## Docker 容器运行

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

request 相关的环境变量

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

167
```shell
B
binaryify 已提交
168
docker pull binaryify/netease_cloud_music_api
169

B
binaryify 已提交
170 171 172 173 174
docker run -d -p 3000:3000 --name netease_cloud_music_api    binaryify/netease_cloud_music_api


// 或者 
docker run -d -p 3000:3000 binaryify/netease_cloud_music_api
175 176

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

B
binaryify 已提交
178 179 180 181
docker run -d -p 3000:3000 --name netease_cloud_music_api -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= binaryify/netease_cloud_music_api

// 或者
docker run -d -p 3000:3000 -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= binaryify/netease_cloud_music_api
182
```
B
binaryify 已提交
183

B
binaryify 已提交
184
> 以下是自行 build docker 镜像方式
185 186 187

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

189
$ sudo docker build . -t netease-music-api
190

191 192
$ sudo docker run -d -p 3000:3000 netease-music-api
```
B
binaryify 已提交
193

194
## 接口文档
B
improve  
binaryify 已提交
195

B
binaryify 已提交
196
### 调用前须知
B
improve  
binaryify 已提交
197

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

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

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

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

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

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

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

### 登录
B
improve  
binaryify 已提交
219 220 221

说明 : 登录有两个接口

B
improve  
binaryify 已提交
222
#### 1. 手机登录
223

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

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

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

B
improve  
binaryify 已提交
230
#### 2. 邮箱登录
B
binaryify 已提交
231

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

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

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

B
improve  
binaryify 已提交
238
**接口地址 :** `/login`
239

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

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

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

B
binaryify 已提交
248
#### 注意
B
improve  
binaryify 已提交
249 250

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

252
### 刷新登录
N
nujhong 已提交
253

B
improve  
binaryify 已提交
254 255 256
说明 : 调用此接口 , 可刷新登录状态

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

B
v2.20.3  
binaryify 已提交
258 259 260 261 262 263
### 退出登录

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

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

264
### 登录状态
B
binaryify 已提交
265

266 267 268 269 270 271
说明 : 调用此接口,可获取登录状态

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

B
binaryify 已提交
272 273
### 获取用户详情

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

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

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

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

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

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

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

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

290 291 292 293 294
### 更新用户信息

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

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

296 297
```
gender: 性别 0:保密 1:男性 2:女性
298

299
birthday: 出生日期,时间戳 unix timestamp
300

301
nickname: 用户昵称
302

303
province: 省份id
304

305
city: 城市id
306

307 308 309 310 311 312 313
signature:用户签名
```

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

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

B
binaryify 已提交
314
### 获取用户歌单
315

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

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

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

B
improve  
binaryify 已提交
322 323 324
**调用例子 :** `/user/playlist?uid=32953014`

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

327 328 329 330
### 更新歌单

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

332 333
```
id:歌单id
334

B
binaryify 已提交
335
name:歌单名字=
336

337
desc:歌单描述
338

339 340
tags:歌单tag
```
B
binaryify 已提交
341

342 343 344 345
**接口地址 :** `/playlist/update`

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

B
binaryify 已提交
346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377
### 发送私信

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

378 379
### 获取用户电台

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

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

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

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

B
improve  
binaryify 已提交
388
### 获取用户关注列表
389

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

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

B
binaryify 已提交
394
**可选参数 :**
395

B
binaryify 已提交
396 397 398
`limit` : 返回数量 , 默认为 30

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

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

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

B
improve  
binaryify 已提交
405
### 获取用户粉丝列表
406

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

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

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

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

**调用例子 :** `/user/followeds?uid=32953014`
417 418 419

### 获取用户动态

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

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

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

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

B
v3.0.0  
binaryify 已提交
428 429 430 431 432 433
### 关注/取消关注用户

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

**必选参数 :**

B
binaryify 已提交
434
`id` : 用户 id
B
v3.0.0  
binaryify 已提交
435

B
binaryify 已提交
436
`t` : `1`为关注,其他为取消关注
B
v3.0.0  
binaryify 已提交
437 438 439 440 441

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

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

442 443
### 获取用户播放记录

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

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

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

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

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

Z
zhixuan 已提交
454 455
### 获取动态消息

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

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

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

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

465
### 歌手分类列表
B
binaryify 已提交
466

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

471 472 473 474
`limit` : 返回数量 , 默认为 30

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

477
category Code 取值:
B
binaryify 已提交
478

479 480
```
入驻歌手 5001
481

482
华语男歌手 1001
483

484
华语女歌手 1002
485

486
华语组合/乐队 1003
487

488
欧美男歌手 2001
489

490
欧美女歌手 2002
491

492
欧美组合/乐队 2003
493

494
日本男歌手 6001
495

496
日本女歌手 6002
497

498
日本组合/乐队 6003
499

500
韩国男歌手 7001
501

502
韩国女歌手 7002
503

504
韩国组合/乐队 7003
505

506
其他男歌手 4001
507

508
其他女歌手 4002
509

510 511 512 513 514 515 516 517 518 519
其他组合/乐队 4003
```

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

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

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

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

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

B
binaryify 已提交
524
**必选参数 :**
525

B
binaryify 已提交
526
`artistId` : 歌手 id
527

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

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

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

534
### 收藏的歌手列表
B
binaryify 已提交
535

536 537 538 539 540 541
说明 : 调用此接口,可获取收藏的歌手列表

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

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

B
v3.0.0  
binaryify 已提交
542 543 544 545
### 收藏视频

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

B
binaryify 已提交
546
**必选参数 :**
B
v3.0.0  
binaryify 已提交
547 548 549 550 551 552 553 554 555 556 557 558 559

`id` : 视频 id

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

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

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

### 收藏 MV

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

B
binaryify 已提交
560
**必选参数 :**
B
v3.0.0  
binaryify 已提交
561 562 563 564 565 566 567 568 569

`id` : MV id

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

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

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

570 571 572 573 574 575 576 577
### 收藏的 MV 列表

说明 : 调用此接口,可获取收藏的 MV 列表

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

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

B
binaryify 已提交
578
### 歌单分类
B
binaryify 已提交
579

B
binaryify 已提交
580 581 582 583 584 585 586
说明 : 调用此接口,可获取歌单分类,包含 category 信息

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

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

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

B
binaryify 已提交
588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610
说明 : 调用此接口,可获取歌单分类,包含 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)
611

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

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

B
improve  
binaryify 已提交
616
### 获取精品歌单
617

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

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

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

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

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

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

B
binaryify 已提交
631 632 633 634 635 636 637 638 639 640
### 相关歌单推荐

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

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

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

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

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

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

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

### 获取音乐 url
658

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

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

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

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

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

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

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

677
### 音乐是否可用
B
binaryify 已提交
678

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

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

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

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

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

689
### 搜索
690

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

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

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

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

B
improve  
binaryify 已提交
703
**接口地址 :** `/search`
704

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

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

B
binaryify 已提交
710
### 热搜
B
binaryify 已提交
711

B
binaryify 已提交
712 713 714 715 716 717
说明 : 调用此接口,可获取热门搜索列表

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

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

718 719
### 搜索建议

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

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

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

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

B
binaryify 已提交
729 730
### 搜索多重匹配

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

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

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

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

739 740 741 742
### 新建歌单

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

B
binaryify 已提交
743
**必选参数 :** `name` : 歌单名
744 745 746 747 748 749 750 751 752 753 754 755 756

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

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

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

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

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

**必选参数 :**
757

B
binaryify 已提交
758
`t` : 类型,1:收藏,2:取消收藏
759 760 761 762 763 764 765 766 767
`id` : 歌单 id

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

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

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

768
### 对歌单添加或删除歌曲
B
binaryify 已提交
769

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

772
**必选参数 :**
773

774 775 776 777
`op`: 从歌单增加单曲为 add, 删除为 del

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

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

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

B
binaryify 已提交
783
### 获取歌词
784

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

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

B
improve  
binaryify 已提交
789
**接口地址 :** `/lyric`
790

B
improve  
binaryify 已提交
791 792 793
**调用例子 :** `/lyric?id=33894312`

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

B
binaryify 已提交
796 797 798 799 800 801 802 803 804 805
### 新歌速递

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

**必选参数 :**

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

```
全部:0
806

B
binaryify 已提交
807
华语:7
808

B
binaryify 已提交
809
欧美:96
810

B
binaryify 已提交
811
日本:8
812

B
binaryify 已提交
813 814 815 816 817 818 819
韩国:16
```

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

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

820
### 歌曲评论
821

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

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

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

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

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

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

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

### 专辑评论

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

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

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

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

B
improve  
binaryify 已提交
849 850 851
**接口地址 :** `/comment/album`

**调用例子 :** `/comment/album?id=32311`
852 853 854

### 歌单评论

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

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

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

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

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

B
improve  
binaryify 已提交
866
**调用例子 :** `/comment/playlist?id=705123491`
867 868 869

### mv 评论

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

B
improve  
binaryify 已提交
873
**必选参数 :** `id`: mv id
874

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

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

B
improve  
binaryify 已提交
879 880 881
**接口地址 :** `/comment/mv`

**调用例子 :** `/comment/mv?id=5436712`
882 883 884

### 电台节目评论

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

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

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

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

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

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

898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913
### 视频评论

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

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

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

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

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

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

### 热门评论
B
v2.20.3  
binaryify 已提交
914 915

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

**必选参数 :**

`id` : 资源 id

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

```
0: 歌曲
925

926
1: mv
927

928
2: 歌单
929

930
3: 专辑
931

932
4: 电台
933

934 935
5: 视频
```
B
v2.20.3  
binaryify 已提交
936

937 938 939 940
**接口地址 :** `/comment/hot`

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

B
binaryify 已提交
941 942
### 给评论点赞

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

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

B
improve  
binaryify 已提交
948
`cid` : 评论 id
B
binaryify 已提交
949

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

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

B
binaryify 已提交
954 955
```
0: 歌曲
956

B
binaryify 已提交
957
1: mv
958

B
binaryify 已提交
959
2: 歌单
960

N
nujhong 已提交
961
3: 专辑
962

B
binaryify 已提交
963
4: 电台
964

965
5: 视频
B
improve  
binaryify 已提交
966
```
N
nujhong 已提交
967

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

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

B
binaryify 已提交
972 973 974 975 976 977 978 979
### 发送/删除评论

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

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

1. 发送评论

B
binaryify 已提交
980
   **必选参数**
981

B
v3.0.0  
binaryify 已提交
982
   `t`:1 发送
B
binaryify 已提交
983

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

   ```
   0: 歌曲
988

B
binaryify 已提交
989
   1: mv
990

B
binaryify 已提交
991
   2: 歌单
992

B
binaryify 已提交
993
   3: 专辑
994

B
binaryify 已提交
995
   4: 电台
996

997
   5: 视频
B
binaryify 已提交
998 999 1000 1001 1002 1003
   ```

   `id`:对应资源 id

   `content` :要发送的内容

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

2. 删除评论
B
binaryify 已提交
1007 1008

   **必选参数**
1009

B
v3.0.0  
binaryify 已提交
1010
   `t`:0 删除
B
binaryify 已提交
1011

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

   ```
   0: 歌曲
1016

B
binaryify 已提交
1017
   1: mv
1018

B
binaryify 已提交
1019
   2: 歌单
1020

B
binaryify 已提交
1021
   3: 专辑
1022

B
binaryify 已提交
1023
   4: 电台
1024 1025


1026
   5: 视频
B
binaryify 已提交
1027 1028 1029 1030
   ```

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

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

B
binaryify 已提交
1035

1036 1037
### banner

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

B
improve  
binaryify 已提交
1040 1041 1042
**接口地址 :** `/banner`

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

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

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

B
binaryify 已提交
1048
**必选参数 :**
B
v3.0.0  
binaryify 已提交
1049 1050

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

B
v3.0.0  
binaryify 已提交
1052 1053
```
1: mv
1054

B
v3.0.0  
binaryify 已提交
1055
4: 电台
1056

B
v3.0.0  
binaryify 已提交
1057 1058 1059
5: 视频
```

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

B
binaryify 已提交
1062
`id`: 资源 id
B
v3.0.0  
binaryify 已提交
1063 1064 1065 1066 1067

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

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

B
binaryify 已提交
1068 1069
### 获取歌曲详情

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

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

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

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

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

B
binaryify 已提交
1081
### 获取专辑内容
1082

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

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

B
improve  
binaryify 已提交
1087
**接口地址 :** `/album`
1088

B
improve  
binaryify 已提交
1089 1090 1091
**调用例子 :** `/album?id=32311`

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

1094
### 获取歌手单曲
1095

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

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

B
improve  
binaryify 已提交
1100
**接口地址 :** `/artists`
1101

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

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

1107
### 获取歌手 mv
B
improve  
binaryify 已提交
1108 1109 1110

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

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

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

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

1119
### 获取歌手专辑
1120

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

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

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

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

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

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

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

1137 1138
### 获取歌手描述

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

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

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

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

### 获取相似歌手

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

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

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

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

### 获取相似歌单

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

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

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

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

### 相似 mv

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

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

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

B
improve  
binaryify 已提交
1175
**调用例子 :** `/simi/mv?mvid=5436712`
1176 1177 1178

### 获取相似音乐

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1193 1194 1195
**接口地址 :** `/simi/user`

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

B
binaryify 已提交
1197
### 获取每日推荐歌单
1198

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

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

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

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

B
binaryify 已提交
1208
### 获取每日推荐歌曲
1209

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

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

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

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

### 私人 FM

B
improve  
binaryify 已提交
1221 1222 1223
说明 : 私人 FM( 需要登录 )

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

B
improve  
binaryify 已提交
1225
**调用例子 :** `/personal_fm`
1226

B
improve  
binaryify 已提交
1227
返回数据如下图 :
1228 1229 1230 1231 1232

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

### 签到

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

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

B
improve  
binaryify 已提交
1238
**接口地址 :** `/daily_signin`
1239

B
improve  
binaryify 已提交
1240 1241 1242
**调用例子 :** `/daily_signin`

返回数据如下图 :
1243

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

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

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

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

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

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

B
improve  
binaryify 已提交
1256
**接口地址 :** `/like`
1257

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

B
improve  
binaryify 已提交
1260
返回数据如下图 :
1261 1262 1263

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

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

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

1268 1269 1270 1271 1272 1273 1274 1275 1276 1277
### 喜欢音乐列表

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

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

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

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

1278 1279
### 垃圾桶

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

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

B
improve  
binaryify 已提交
1284
**接口地址 :** `/fm_trash`
1285

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

B
improve  
binaryify 已提交
1288
返回数据如下图 :
1289 1290 1291

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

1292
### 新碟上架
N
nujhong 已提交
1293

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

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

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

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

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

B
improve  
binaryify 已提交
1306
返回数据如下图 :
1307 1308 1309 1310

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1323
返回数据如下图 :
1324 1325 1326

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

1327
### 最新 mv
N
nujhong 已提交
1328

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

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

B
improve  
binaryify 已提交
1333 1334 1335
**接口地址 :** `/mv/first`

**调用例子 :** `/mv/first?limit=10`
1336 1337

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

B
improve  
binaryify 已提交
1339 1340 1341
说明 : 调用此接口 , 可获取推荐 mv

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

B
improve  
binaryify 已提交
1343
**调用例子 :** `/personalized/mv`
1344 1345

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

B
improve  
binaryify 已提交
1347 1348 1349
说明 : 调用此接口 , 可获取推荐歌单

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

B
improve  
binaryify 已提交
1351
**调用例子 :** `/personalized`
1352 1353

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

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

B
improve  
binaryify 已提交
1357 1358 1359
**接口地址 :** `/personalized/newsong`

**调用例子 :** `/personalized/newsong`
1360 1361

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

B
improve  
binaryify 已提交
1363 1364 1365
说明 : 调用此接口 , 可获取推荐电台

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

B
improve  
binaryify 已提交
1367
**调用例子 :** `/personalized/djprogram`
1368 1369

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

B
improve  
binaryify 已提交
1371 1372 1373
说明 : 调用此接口 , 可获取推荐电台

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

B
improve  
binaryify 已提交
1375
**调用例子 :** `/program/recommend`
1376 1377

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

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

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

B
improve  
binaryify 已提交
1383
**调用例子 :** `/personalized/privatecontent`
1384 1385

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

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

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

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

B
improve  
binaryify 已提交
1394 1395 1396
**接口地址 :** `top/mv`

**调用例子 :** `top/mv?limit=10`
1397 1398

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

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

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

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

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

B
improve  
binaryify 已提交
1410
返回数据如下图 :
B
binaryify 已提交
1411

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

B
v3.0.0  
binaryify 已提交
1414
### mv 地址
1415

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

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

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

**调用例子 :**
1423

B
v3.0.0  
binaryify 已提交
1424 1425 1426
`/mv/url?id=5436712`

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

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

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

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

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

B
v3.0.0  
binaryify 已提交
1436
### 视频详情
B
binaryify 已提交
1437

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

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

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

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

B
v3.0.0  
binaryify 已提交
1446
### 获取视频数据
B
binaryify 已提交
1447

B
binaryify 已提交
1448
说明 : 调用此接口 , 传入视频 id,可获取视频播放地址
B
improve  
binaryify 已提交
1449

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

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

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

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

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

B
binaryify 已提交
1460
### 排行榜
1461

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

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

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

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

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

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

B
improve  
binaryify 已提交
1475
"4": 云音乐电音榜,
1476

B
improve  
binaryify 已提交
1477
"5": UK排行榜周榜,
1478

B
improve  
binaryify 已提交
1479
"6": 美国Billboard周榜
1480

B
improve  
binaryify 已提交
1481
"7": KTV嗨榜,
1482

B
improve  
binaryify 已提交
1483
"8": iTunes榜,
1484

B
improve  
binaryify 已提交
1485
"9": Hit FM Top榜,
1486

B
improve  
binaryify 已提交
1487
"10": 日本Oricon周榜
1488

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

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

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

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

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

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

B
improve  
binaryify 已提交
1501
"17": 华语金曲榜,
1502

B
improve  
binaryify 已提交
1503
"18": 中国嘻哈榜,
1504

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

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

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

N
nujhong 已提交
1511
"22": 云音乐ACG音乐榜,
1512

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

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

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

B
improve  
binaryify 已提交
1520
返回数据如下图 :
B
binaryify 已提交
1521 1522

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

1524 1525 1526 1527 1528 1529 1530
### 所有榜单

说明 : 调用此接口,可获取所有榜单
**接口地址 :** `/toplist`

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

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

B
v3.0.0  
binaryify 已提交
1533 1534 1535 1536 1537
说明 : 调用此接口,可获取所有榜单内容摘要
**接口地址 :** `/toplist/detail`

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

H
hzw758 已提交
1538 1539
### 歌手榜

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

B
improve  
binaryify 已提交
1542 1543 1544
**接口地址 :** `/toplist/artist`

**调用例子 :** `/toplist/artist`
1545 1546 1547

### 云盘

B
improve  
binaryify 已提交
1548
说明 : 登陆后调用此接口 , 可获取云盘数据 , 获取的数据没有对应 url, 需要再调用一
B
v3.0.0  
binaryify 已提交
1549
次 `/song/url` 获取 url
B
improve  
binaryify 已提交
1550 1551 1552 1553

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

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

B
improve  
binaryify 已提交
1555
### 电台 - 推荐
1556

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

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

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

B
improve  
binaryify 已提交
1563
### 电台 - 分类
1564

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

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

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

B
improve  
binaryify 已提交
1571
### 电台 - 分类推荐
1572

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

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

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

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

B
improve  
binaryify 已提交
1582
### 电台 - 订阅
1583

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

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

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

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

1594 1595 1596 1597 1598 1599 1600 1601
### 电台的订阅列表

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

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

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

add doc  
徐星宇 已提交
1602 1603 1604 1605 1606 1607 1608 1609
### 电台 - 付费精选

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

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

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

B
improve  
binaryify 已提交
1610
### 电台 - 详情
1611

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

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

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

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

B
improve  
binaryify 已提交
1620
### 电台 - 节目
1621

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

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

B
binaryify 已提交
1629
**可选参数 :**
1630

B
binaryify 已提交
1631 1632 1633 1634 1635
`limit` : 返回数量 , 默认为 30

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

1636 1637
`asc` : 排序方式,默认为 `false` (新 => 老 ) 设置 `true` 可改为 老 => 新 

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

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

B
binaryify 已提交
1642
## 离线访问此文档
B
binaryify 已提交
1643

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

## 关于此文档
B
improve  
binaryify 已提交
1647 1648 1649 1650

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

B
binaryify 已提交
1652
## License
B
improve  
binaryify 已提交
1653

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