README.md 41.4 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. 新歌速递
B
v3.0.0  
binaryify 已提交
105

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

```shell
109 110
$ git clone git@github.com:Binaryify/NeteaseCloudMusicApi.git
$ npm install
B
binaryify 已提交
111
```
B
improve  
binaryify 已提交
112

113
## 运行
B
improve  
binaryify 已提交
114 115

```shell
N
nujhong 已提交
116
$ node app.js
B
binaryify 已提交
117 118
```

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

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

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

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

131 132 133 134 135 136
## 可以使用代理

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

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

B
binaryify 已提交
146
## 更新到 v3.0 说明
B
binaryify 已提交
147

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

B
improve  
binaryify 已提交
150 151
## Docker 容器运行

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

request 相关的环境变量

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

163
```shell
164
docker pull twesix/netease-cloud-music
165 166 167
docker run -d -p 3000:3000 --name netease-cloud-music twesix/netease-music-api

// 去掉或者设置相关的环境变量
168
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
169
```
B
binaryify 已提交
170

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

```
$ git clone https://github.com/Binaryify/NeteaseCloudMusicApi && cd NeteaseCloudMusicApi
$ sudo docker build . -t netease-music-api
$ sudo docker run -d -p 3000:3000 netease-music-api
```
B
binaryify 已提交
178

179
## 接口文档
B
improve  
binaryify 已提交
180

B
binaryify 已提交
181
### 调用前须知
B
improve  
binaryify 已提交
182

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

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

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

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

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

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

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

### 登录
B
improve  
binaryify 已提交
204 205 206

说明 : 登录有两个接口

B
improve  
binaryify 已提交
207
#### 1. 手机登录
208

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

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

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

B
improve  
binaryify 已提交
215
#### 2. 邮箱登录
B
binaryify 已提交
216

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

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

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

B
improve  
binaryify 已提交
223
**接口地址 :** `/login`
224

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

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

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

B
binaryify 已提交
233
#### 注意
B
improve  
binaryify 已提交
234 235

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

237
### 刷新登录
N
nujhong 已提交
238

B
improve  
binaryify 已提交
239 240 241
说明 : 调用此接口 , 可刷新登录状态

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

B
v2.20.3  
binaryify 已提交
243 244 245 246 247 248
### 退出登录

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

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

249
### 登录状态
B
binaryify 已提交
250

251 252 253 254 255 256
说明 : 调用此接口,可获取登录状态

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

B
binaryify 已提交
257 258
### 获取用户详情

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

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

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

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

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

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

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

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

275 276 277 278 279
### 更新用户信息

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

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

281 282 283 284 285 286 287 288 289 290 291 292 293
```
gender: 性别 0:保密 1:男性 2:女性
birthday: 出生日期,时间戳 unix timestamp
nickname: 用户昵称
province: 省份id
city: 城市id
signature:用户签名
```

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

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

B
binaryify 已提交
294
### 获取用户歌单
295

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

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

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

B
improve  
binaryify 已提交
302 303 304
**调用例子 :** `/user/playlist?uid=32953014`

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

307 308 309 310
### 更新歌单

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

312 313 314 315 316 317
```
id:歌单id
name:歌单名字
desc:歌单描述
tags:歌单tag
```
B
binaryify 已提交
318

319 320 321 322
**接口地址 :** `/playlist/update`

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

B
binaryify 已提交
323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354
### 发送私信

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

355 356
### 获取用户电台

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

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

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

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

B
improve  
binaryify 已提交
365
### 获取用户关注列表
366

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

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

B
binaryify 已提交
371 372 373 374
**可选参数 :**
`limit` : 返回数量 , 默认为 30

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

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

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

B
improve  
binaryify 已提交
381
### 获取用户粉丝列表
382

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

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

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

B
improve  
binaryify 已提交
390 391 392
**接口地址 :** `/user/followeds`

**调用例子 :** `/user/followeds?uid=32953014`
393 394 395

### 获取用户动态

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

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

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

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

B
v3.0.0  
binaryify 已提交
404 405 406 407 408 409
### 关注/取消关注用户

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

**必选参数 :**

B
binaryify 已提交
410
`id` : 用户 id
B
v3.0.0  
binaryify 已提交
411

B
binaryify 已提交
412
`t` : `1`为关注,其他为取消关注
B
v3.0.0  
binaryify 已提交
413 414 415 416 417

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

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

418 419
### 获取用户播放记录

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

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

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

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

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

Z
zhixuan 已提交
430 431
### 获取动态消息

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

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

B
improve  
binaryify 已提交
437 438 439
**接口地址 :** `/event`

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

441
### 歌手分类列表
B
binaryify 已提交
442

443 444 445 446 447 448 449
说明 : 调用此接口,可获取歌手分类列表
**必选参数 :** `cat` : 即 category Code,歌手类型,默认 1001,返回华语男歌手数据
**可选参数 :**
`limit` : 返回数量 , 默认为 30

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

452
category Code 取值:
B
binaryify 已提交
453

454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479
```
入驻歌手 5001
华语男歌手 1001
华语女歌手 1002
华语组合/乐队 1003
欧美男歌手 2001
欧美女歌手 2002
欧美组合/乐队 2003
日本男歌手 6001
日本女歌手 6002
日本组合/乐队 6003
韩国男歌手 7001
韩国女歌手 7002
韩国组合/乐队 7003
其他男歌手 4001
其他女歌手 4002
其他组合/乐队 4003
```

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

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

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

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

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

B
binaryify 已提交
484
**必选参数 :**
485

B
binaryify 已提交
486
`artistId` : 歌手 id
487

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

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

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

494
### 收藏的歌手列表
B
binaryify 已提交
495

496 497 498 499 500 501
说明 : 调用此接口,可获取收藏的歌手列表

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

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

B
v3.0.0  
binaryify 已提交
502 503 504 505
### 收藏视频

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

B
binaryify 已提交
506
**必选参数 :**
B
v3.0.0  
binaryify 已提交
507 508 509 510 511 512 513 514 515 516 517 518 519

`id` : 视频 id

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

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

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

### 收藏 MV

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

B
binaryify 已提交
520
**必选参数 :**
B
v3.0.0  
binaryify 已提交
521 522 523 524 525 526 527 528 529

`id` : MV id

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

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

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

B
binaryify 已提交
530
### 歌单分类
B
binaryify 已提交
531

B
binaryify 已提交
532 533 534 535 536 537 538
说明 : 调用此接口,可获取歌单分类,包含 category 信息

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

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

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

B
binaryify 已提交
540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565
说明 : 调用此接口,可获取歌单分类,包含 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)
![对应位置](https://ws2.sinaimg.cn/large/006tKfTcgy1fr3wnpyg6jj317e0vcqdc.jpg)
![返回数据](https://ws4.sinaimg.cn/large/006tKfTcgy1fr3wqs5lw9j31ic1re4c4.jpg)

B
improve  
binaryify 已提交
566
### 获取精品歌单
567

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

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

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

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

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

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

B
binaryify 已提交
581 582 583 584 585 586 587 588 589 590
### 相关歌单推荐

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

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

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

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

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

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

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

### 获取音乐 url
608

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

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

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

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

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

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

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

627
### 音乐是否可用
B
binaryify 已提交
628

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

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

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

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

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

639
### 搜索
640

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

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

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

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

B
improve  
binaryify 已提交
653
**接口地址 :** `/search`
654

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

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

B
binaryify 已提交
660
### 热搜
B
binaryify 已提交
661

B
binaryify 已提交
662 663 664 665 666 667
说明 : 调用此接口,可获取热门搜索列表

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

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

668 669
### 搜索建议

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

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

675 676 677 678
**可选参数 :**
`limit` : 返回数量 , 默认为 30

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

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

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

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

B
binaryify 已提交
688 689
### 搜索多重匹配

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

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

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

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

698 699 700 701
### 新建歌单

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

B
binaryify 已提交
702
**必选参数 :** `name` : 歌单名
703 704 705 706 707 708 709 710 711 712 713 714 715

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

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

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

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

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

**必选参数 :**
B
binaryify 已提交
716
`t` : 类型,1:收藏,2:取消收藏
717 718 719 720 721 722 723 724 725
`id` : 歌单 id

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

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

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

726
### 对歌单添加或删除歌曲
B
binaryify 已提交
727

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

730 731 732 733 734
**必选参数 :**
`op`: 从歌单增加单曲为 add, 删除为 del

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

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

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

B
binaryify 已提交
740
### 获取歌词
741

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

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

B
improve  
binaryify 已提交
746
**接口地址 :** `/lyric`
747

B
improve  
binaryify 已提交
748 749 750
**调用例子 :** `/lyric?id=33894312`

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

B
binaryify 已提交
753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776
### 新歌速递

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

**必选参数 :**

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

```
全部:0
华语:7
欧美:96
日本:8
韩国:16
```

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

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

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

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

777
### 歌曲评论
778

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

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

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

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

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

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

B
improve  
binaryify 已提交
792 793
返回数据如下图 :
![获取评论](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/comment.png)
794 795 796

### 专辑评论

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

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

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

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

B
improve  
binaryify 已提交
806 807 808
**接口地址 :** `/comment/album`

**调用例子 :** `/comment/album?id=32311`
809 810 811

### 歌单评论

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

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

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

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

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

B
improve  
binaryify 已提交
823
**调用例子 :** `/comment/playlist?id=705123491`
824 825 826

### mv 评论

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

B
improve  
binaryify 已提交
830
**必选参数 :** `id`: mv id
831

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

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

B
improve  
binaryify 已提交
836 837 838
**接口地址 :** `/comment/mv`

**调用例子 :** `/comment/mv?id=5436712`
839 840 841

### 电台节目评论

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

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

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

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

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

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

855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870
### 视频评论

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

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

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

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

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

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

### 热门评论
B
v2.20.3  
binaryify 已提交
871 872

说明 : 调用此接口 , 传入 type, 资源 id 可获得对应资源热门评论 ( 不需要登录 )
873 874 875 876 877 878 879 880 881 882 883 884 885 886 887

**必选参数 :**

`id` : 资源 id

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

```
0: 歌曲
1: mv
2: 歌单
3: 专辑
4: 电台
5: 视频
```
B
v2.20.3  
binaryify 已提交
888

889 890 891 892
**接口地址 :** `/comment/hot`

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

B
binaryify 已提交
893 894
### 给评论点赞

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

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

B
improve  
binaryify 已提交
900
`cid` : 评论 id
B
binaryify 已提交
901

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

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

B
binaryify 已提交
906 907 908 909
```
0: 歌曲
1: mv
2: 歌单
N
nujhong 已提交
910
3: 专辑
B
binaryify 已提交
911
4: 电台
912
5: 视频
B
improve  
binaryify 已提交
913
```
N
nujhong 已提交
914

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

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

B
binaryify 已提交
919 920 921 922 923 924 925 926
### 发送/删除评论

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

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

1. 发送评论

B
binaryify 已提交
927
   **必选参数**
B
v3.0.0  
binaryify 已提交
928
   `t`:1 发送
B
binaryify 已提交
929

930
   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型
B
binaryify 已提交
931 932 933 934 935 936 937

   ```
   0: 歌曲
   1: mv
   2: 歌单
   3: 专辑
   4: 电台
938
   5: 视频
B
binaryify 已提交
939 940 941 942 943 944
   ```

   `id`:对应资源 id

   `content` :要发送的内容

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

2. 删除评论
B
binaryify 已提交
948 949

   **必选参数**
B
v3.0.0  
binaryify 已提交
950
   `t`:0 删除
B
binaryify 已提交
951

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

   ```
   0: 歌曲
   1: mv
   2: 歌单
   3: 专辑
   4: 电台
960
   5: 视频
B
binaryify 已提交
961 962 963 964
   ```

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

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

968 969
### banner

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

B
improve  
binaryify 已提交
972 973 974
**接口地址 :** `/banner`

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

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

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

B
binaryify 已提交
980
**必选参数 :**
B
v3.0.0  
binaryify 已提交
981 982

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

B
v3.0.0  
binaryify 已提交
984 985 986 987 988 989
```
1: mv
4: 电台
5: 视频
```

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

B
binaryify 已提交
992
`id`: 资源 id
B
v3.0.0  
binaryify 已提交
993 994 995 996 997

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

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

B
binaryify 已提交
998 999
### 获取歌曲详情

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

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

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

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

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

B
binaryify 已提交
1011
### 获取专辑内容
1012

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

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

B
improve  
binaryify 已提交
1017
**接口地址 :** `/album`
1018

B
improve  
binaryify 已提交
1019 1020 1021
**调用例子 :** `/album?id=32311`

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

1024
### 获取歌手单曲
1025

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

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

B
improve  
binaryify 已提交
1030
**接口地址 :** `/artists`
1031

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

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

1037
### 获取歌手 mv
B
improve  
binaryify 已提交
1038 1039 1040

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

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

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

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

1049
### 获取歌手专辑
1050

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

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

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

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

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

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

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

1067 1068
### 获取歌手描述

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

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

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

B
improve  
binaryify 已提交
1075
**调用例子 :** `/artist/desc?id=6452` ( 周杰伦 )
1076 1077 1078

### 获取相似歌手

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

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

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

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

### 获取相似歌单

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

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

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

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

### 相似 mv

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

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

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

B
improve  
binaryify 已提交
1105
**调用例子 :** `/simi/mv?mvid=5436712`
1106 1107 1108

### 获取相似音乐

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1123 1124 1125
**接口地址 :** `/simi/user`

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

B
binaryify 已提交
1127
### 获取每日推荐歌单
1128

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

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

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

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

B
binaryify 已提交
1138
### 获取每日推荐歌曲
1139

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

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

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

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

### 私人 FM

B
improve  
binaryify 已提交
1151 1152 1153
说明 : 私人 FM( 需要登录 )

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

B
improve  
binaryify 已提交
1155
**调用例子 :** `/personal_fm`
1156

B
improve  
binaryify 已提交
1157
返回数据如下图 :
1158 1159 1160 1161 1162

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

### 签到

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

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

B
improve  
binaryify 已提交
1168
**接口地址 :** `/daily_signin`
1169

B
improve  
binaryify 已提交
1170 1171 1172
**调用例子 :** `/daily_signin`

返回数据如下图 :
1173

B
binaryify 已提交
1174
![签到成功](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/signinSuccess.png)
1175 1176 1177 1178

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1190
返回数据如下图 :
1191 1192 1193

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

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

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

### 垃圾桶

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

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

B
improve  
binaryify 已提交
1204
**接口地址 :** `/fm_trash`
1205

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

B
improve  
binaryify 已提交
1208
返回数据如下图 :
1209 1210 1211

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

1212
### 新碟上架
N
nujhong 已提交
1213

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

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

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

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

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

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

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

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

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

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

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

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

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

B
improve  
binaryify 已提交
1243
返回数据如下图 :
1244 1245 1246

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

1247
### 最新 mv
N
nujhong 已提交
1248

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

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

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

**调用例子 :** `/mv/first?limit=10`
1256 1257

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

B
improve  
binaryify 已提交
1259 1260 1261
说明 : 调用此接口 , 可获取推荐 mv

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

B
improve  
binaryify 已提交
1263
**调用例子 :** `/personalized/mv`
1264 1265

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

B
improve  
binaryify 已提交
1267 1268 1269
说明 : 调用此接口 , 可获取推荐歌单

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

B
improve  
binaryify 已提交
1271
**调用例子 :** `/personalized`
1272 1273

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

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

B
improve  
binaryify 已提交
1277 1278 1279
**接口地址 :** `/personalized/newsong`

**调用例子 :** `/personalized/newsong`
1280 1281

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

B
improve  
binaryify 已提交
1283 1284 1285
说明 : 调用此接口 , 可获取推荐电台

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

B
improve  
binaryify 已提交
1287
**调用例子 :** `/personalized/djprogram`
1288 1289

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

B
improve  
binaryify 已提交
1291 1292 1293
说明 : 调用此接口 , 可获取推荐电台

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

B
improve  
binaryify 已提交
1295
**调用例子 :** `/program/recommend`
1296 1297

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

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

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

B
improve  
binaryify 已提交
1303
**调用例子 :** `/personalized/privatecontent`
1304 1305

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

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

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

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

B
improve  
binaryify 已提交
1314 1315 1316
**接口地址 :** `top/mv`

**调用例子 :** `top/mv?limit=10`
1317 1318

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

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

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

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

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

B
improve  
binaryify 已提交
1330
返回数据如下图 :
B
binaryify 已提交
1331

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

B
v3.0.0  
binaryify 已提交
1334
### mv 地址
1335

B
v3.0.0  
binaryify 已提交
1336 1337 1338 1339 1340 1341 1342 1343 1344 1345
说明 : 调用此接口 , 传入 mv id,可获取 mv 播放地址

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

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

**调用例子 :**
`/mv/url?id=5436712`

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

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

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

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

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

B
v3.0.0  
binaryify 已提交
1355
### 视频详情
B
binaryify 已提交
1356

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

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

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

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

B
v3.0.0  
binaryify 已提交
1365
### 获取视频数据
B
binaryify 已提交
1366

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

B
v3.0.0  
binaryify 已提交
1370 1371 1372 1373 1374 1375 1376
**必选参数 :** `id`: 视频 的 id

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

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

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

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

B
binaryify 已提交
1380
### 排行榜
1381

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

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

```
B
improve  
binaryify 已提交
1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407
"0": 云音乐新歌榜,
"1": 云音乐热歌榜,
"2": 网易原创歌曲榜,
"3": 云音乐飙升榜,
"4": 云音乐电音榜,
"5": UK排行榜周榜,
"6": 美国Billboard周榜
"7": KTV嗨榜,
"8": iTunes榜,
"9": Hit FM Top榜,
"10": 日本Oricon周榜
"11": 韩国Melon排行榜周榜,
"12": 韩国Mnet排行榜周榜,
"13": 韩国Melon原声周榜,
"14": 中国TOP排行榜(港台榜),
"15": 中国TOP排行榜(内地榜)
"16": 香港电台中文歌曲龙虎榜,
"17": 华语金曲榜,
"18": 中国嘻哈榜,
"19": 法国 NRJ EuroHot 30周榜,
"20": 台湾Hito排行榜,
N
nujhong 已提交
1408 1409 1410 1411
"21": Beatport全球电子舞曲榜,
"22": 云音乐ACG音乐榜,
"23": 云音乐嘻哈榜
```
B
binaryify 已提交
1412

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

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

B
improve  
binaryify 已提交
1417
返回数据如下图 :
B
binaryify 已提交
1418 1419

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

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

B
v3.0.0  
binaryify 已提交
1423 1424 1425 1426 1427
说明 : 调用此接口,可获取所有榜单内容摘要
**接口地址 :** `/toplist/detail`

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

H
hzw758 已提交
1428 1429
### 歌手榜

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

B
improve  
binaryify 已提交
1432 1433 1434
**接口地址 :** `/toplist/artist`

**调用例子 :** `/toplist/artist`
1435 1436 1437

### 云盘

B
improve  
binaryify 已提交
1438
说明 : 登陆后调用此接口 , 可获取云盘数据 , 获取的数据没有对应 url, 需要再调用一
B
v3.0.0  
binaryify 已提交
1439
`/song/url` 获取 url
B
improve  
binaryify 已提交
1440 1441 1442 1443

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

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

B
improve  
binaryify 已提交
1445
### 电台 - 推荐
1446

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

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

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

B
improve  
binaryify 已提交
1453
### 电台 - 分类
1454

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

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

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

B
improve  
binaryify 已提交
1461
### 电台 - 分类推荐
1462

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

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

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

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

B
improve  
binaryify 已提交
1472
### 电台 - 订阅
1473

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

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

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

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

1484 1485 1486 1487 1488 1489 1490 1491
### 电台的订阅列表

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

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

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

add doc  
徐星宇 已提交
1492 1493 1494 1495 1496 1497 1498 1499
### 电台 - 付费精选

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

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

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

B
improve  
binaryify 已提交
1500
### 电台 - 详情
1501

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

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

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

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

B
improve  
binaryify 已提交
1510
### 电台 - 节目
1511

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

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

B
binaryify 已提交
1519 1520 1521 1522 1523 1524
**可选参数 :**
`limit` : 返回数量 , 默认为 30

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

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

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

B
binaryify 已提交
1529
## 离线访问此文档
B
binaryify 已提交
1530

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

## 关于此文档
B
improve  
binaryify 已提交
1534 1535 1536 1537

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

B
binaryify 已提交
1539
## License
B
improve  
binaryify 已提交
1540

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