admingitea/api-enhanced
1
0
Fork 0
mirror of https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced.git synced 2026-10-21 23:21:22 +08:00
Code Issues Packages Projects Releases Wiki Activity

version 2.5.0 增加 mv/专辑/歌单评论接口,增加云盘相关接口,增加获取用户动态/信息接口,增加关注/粉丝列表接口,增加收藏歌单接口,增加相似 mv/歌曲/用户接口,增加 banner 接口,增加刷新登录接口,增加电台相关接口,补充评论接口,更新文档

Browse Source
This commit is contained in:
binaryify
2017-04-29 21:57:19 +08:00
parent b236b5024e
commit b6feed4796
81 changed files with 2313 additions and 157 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+559 -46
View File
@@ -7,37 +7,74 @@
[darknessomi/musicbox](https://github.com/darknessomi/musicbox)
[sqaiyan/netmusic-node](https://github.com/sqaiyan/netmusic-node)
## 工作原理
跨站请求伪造 (CSRF), 伪造请求头,调用官方 API
## 版本新特性
### 2.4.6 | 2017.4.21
增加播放 mv 接口,更新文档
### 2.5.0 | 2017.4.29
增加 mv/专辑/歌单评论接口,增加云盘相关接口,增加获取用户动态/信息接口,增加关注/粉丝列表接口,增加收藏歌单接口,增加相似 mv/歌曲/用户接口,增加 banner 接口,增加刷新登录接口,增加电台相关接口,补充评论接口,更新文档
## 功能特性
1. 登录
2. 获取用户歌单
3. 获取歌曲详情
4. 获取音乐 url
5. 搜索
6. 获取歌词
7. 获取评论
8. 获取专辑内容
9. 获取每日推荐歌单
10. 获取每日推荐歌曲
11. 喜欢歌曲
12. 私人FM
13. 把私人 FM 的歌曲移动至垃圾桶
14. 签到
15. 各排行榜
16. 歌曲详情
17. 歌单（网友精选碟)
18. 新碟上架
19. 热门歌手
20. 获取 mv 信息
21. 播放 mv
22. 获取歌手专辑
23. 获取歌手单曲
2. 刷新登录
3. 获取用户信息,歌单，收藏，mv,dj数量
4. 获取用户歌单
5. 获取用户电台
6. 获取用户关注列表
7. 获取用户粉丝列表
8. 获取用户动态
9. 获取用户播放记录
10. 获取精品歌单
11. 获取歌单详情
13. 搜索
14. 搜索建议
15. 获取歌词
16. 歌曲评论
17. 收藏单曲到歌单
18. 专辑评论
19. 歌单评论
20. mv 评论
21. 电台节目评论
22. banner
23. 获取歌曲详情
24. 获取专辑内容
25. 获取歌手单曲
26. 获取歌手 mv
27. 获取歌手专辑
28. 获取歌手描述
29. 获取相似歌手
30. 获取相似歌单
31. 相似 mv
32. 获取相似音乐
33. 获取相似用户
34. 获取每日推荐歌单
35. 获取每日推荐歌曲
36. 私人 FM
37. 签到
38. 喜欢音乐
39. 垃圾桶
40. 歌单(网友精选碟)
41. 新碟上架
42. 热门歌手
43. 最新 mv
44. 推荐 mv
45. 推荐歌单
46. 推荐新音乐
47. 推荐电台
48. 推荐节目
49. 独家放送
50. mv 排行
51. 获取 mv 数据
52. 播放 mv
53. 排行榜
54. 云盘
55. 电台-推荐
56. 电台-分类
57. 电台-分类推荐
58. 电台-订阅
59. 电台-详情
60. 电台-节目
## 安装
``` shell
@@ -100,8 +137,27 @@ $ set PORT=4000 && node app.js
#### 注意
调用登录接口的速度比调用其他接口慢,因为登录过程调用了加密算法
### 刷新登录
说明:调用此接口,可刷新登录状态
**调用例子:**
`/login/refresh`
### 获取用户信息,歌单，收藏，mv,dj数量
说明:登陆后调用此接口,传入用户 id, 可以获取用户信息
**必选参数:**
`uid` : 用户 id
**接口地址:**
`/user/subcount`
**调用例子:**
`/user/subcount`
### 获取用户歌单
说明:登陆后调用此接口,传入用户 id, 可以获取用户歌单
说明:登陆后调用此接口,传入用户 id, 可以获取用户歌单
**必选参数:**
`uid` : 用户 id
@@ -115,6 +171,92 @@ $ set PORT=4000 && node app.js
返回数据如下图:
![用户歌单](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E7%94%A8%E6%88%B7%E6%AD%8C%E5%8D%95.png)
### 获取用户电台
说明:登陆后调用此接口,传入用户 id, 可以获取用户电台
**必选参数:**
`uid` : 用户 id
**接口地址:**
`/user/dj`
**调用例子:**
`/user/dj?uid=32953014`
### 获取用户关注列表
说明:登陆后调用此接口,传入用户 id, 可以获取用户关注列表
**必选参数:**
`uid` : 用户 id
**可选参数:**
`limit` : 返回数量,默认为30
`offset` : 偏移数量，用于分页,如: 如:(页数-1)*30, 其中 30 为 limit 的值,默认为0
**接口地址:**
`/user/follows`
**调用例子:**
`/user/follows?uid=32953014`
### 获取用户粉丝列表
说明:登陆后调用此接口,传入用户 id, 可以获取用户粉丝列表
**必选参数:**
`uid` : 用户 id
**可选参数:**
`limit` : 返回数量,默认为30
`offset` : 偏移数量，用于分页,如: 如:(页数-1)*30, 其中 30 为 limit 的值,默认为0
**接口地址:**
`/user/followeds`
**调用例子:**
`/user/followeds?uid=32953014`
### 获取用户动态
说明:登陆后调用此接口,传入用户 id, 可以获取用户动态
**必选参数:**
`uid` : 用户 id
**接口地址:**
`/user/event`
**调用例子:**
`/user/event?uid=32953014`
### 获取用户播放记录
说明:登陆后调用此接口,传入用户 id,可获取用户播放记录
**必选参数:**
`uid` : 用户 id
**可选参数:**
`type` : type=1时只返回weekData, type=0时返回allData
**接口地址:**
`/user/record`
**调用例子:**
`/user/record?uid=32953014&type=1`
### 获取精品歌单
说明:调用此接口,可获取精品歌单
**可选参数:**
`limit`: 取出评论数量,默认为20
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值
**接口地址:**
`//top/playlist/highquality`
**调用例子:**
`/playlist/detail?id=24381616`
### 获取歌单详情
说明:歌单能看到歌单名字,但看不到具体歌单内容,调用此接口,传入歌单 id,可以获取对应歌单内的所有的音乐
@@ -151,9 +293,11 @@ $ set PORT=4000 && node app.js
**必选参数:**
`keywords` : 关键词
**可选参数:**
**可选参数:**
`limit` : 返回数量,默认为30
`type`: 搜索类型；默认为1,取值意义:
`offset` : 偏移数量，用于分页,如: 如:(页数-1)*30, 其中 30 为 limit 的值,默认为0
`type`: 搜索类型；默认为1即单曲,取值意义:
1: 单曲
10: 专辑
100: 歌手
@@ -163,7 +307,7 @@ $ set PORT=4000 && node app.js
1006: 歌词
1009: 电台
`offset` : 偏移数量，用于分页,如: 如:(评论页数-1)*30, 其中 30 为 limit 的值,默认为0
**接口地址:**
`/search`
@@ -174,6 +318,35 @@ $ set PORT=4000 && node app.js
返回数据如下图:
![搜索音乐](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%90%9C%E7%B4%A2.png)
### 搜索建议
说明:调用此接口,传入搜索关键词可获得搜索建议,搜索结果同时包含单曲,歌手,歌单,mv信息
**必选参数:**
`keywords` : 关键词
**可选参数:**
`limit` : 返回数量,默认为30
`offset` : 偏移数量，用于分页,如: 如:(页数-1)*30, 其中 30 为 limit 的值,默认为0
`type`: 搜索类型；默认为1即单曲,取值意义:
1: 单曲
10: 专辑
100: 歌手
1000: 歌单
1002: 用户
1004: MV
1006: 歌词
1009: 电台
**接口地址:**
`/search/suggest`
**调用例子:**
`/search/suggest?keywords=海阔天空`
### 获取歌词
说明:调用此接口,传入音乐 id 可获得对应音乐的歌词(不需要登录)
@@ -189,8 +362,8 @@ $ set PORT=4000 && node app.js
返回数据如下图:
![获取歌词](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%AD%8C%E8%AF%8D.png)
### 获取评论
说明:调用此接口,传入歌音乐 id和 limit 参数, 可获得该音乐的所有评论(不需要登录)
### 歌曲评论
说明:调用此接口,传入音乐 id和 limit 参数, 可获得该音乐的所有评论(不需要登录)
**必选参数:**
`id`: 音乐 id
@@ -201,14 +374,105 @@ $ set PORT=4000 && node app.js
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值
**接口地址:**
`/comment`
`/comment/music`
**调用例子:**
`/comment?id=186016&limit=1`
`/comment/music?id=186016&limit=1`
返回数据如下图:
![获取评论](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/comment.png)
### 收藏单曲到歌单
说明:调用此接口,传入音乐 id和 limit 参数, 可获得该专辑的所有评论(需要登录)
**必选参数:**
`op`: 从歌单增加单曲为add,删除为 del
`pid`: 歌单id
`tracks`: 歌曲id
**接口地址:**
`/playlist/tracks`
**调用例子:**
`/playlist/tracks?op=add&pid=24381616&tracks=347230` (对应把'海阔天空'添加到'我'的歌单,测试的时候请把这里的 pid换成你自己的)
### 专辑评论
说明:调用此接口,传入音乐 id和 limit 参数, 可获得该专辑的所有评论(不需要登录)
**必选参数:**
`id`: 专辑 id
**可选参数:**
`limit`: 取出评论数量,默认为20
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值
**接口地址:**
`/comment/album`
**调用例子:**
`/comment/album?id=32311`
### 歌单评论
说明:调用此接口,传入音乐 id和 limit 参数, 可获得该歌单的所有评论(不需要登录)
**必选参数:**
`id`: 歌单 id
**可选参数:**
`limit`: 取出评论数量,默认为20
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值
**接口地址:**
`/comment/playlist`
**调用例子:**
`/comment/playlist?id=705123491`
### mv 评论
说明:调用此接口,传入音乐 id和 limit 参数, 可获得该 mv 的所有评论(不需要登录)
**必选参数:**
`id`: mv id
**可选参数:**
`limit`: 取出评论数量,默认为20
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值
**接口地址:**
`/comment/mv`
**调用例子:**
`/comment/mv?id=5436712`
### 电台节目评论
说明:调用此接口,传入音乐 id和 limit 参数, 可获得该 电台节目 的所有评论(不需要登录)
**必选参数:**
`id`: 电台节目的 id
**可选参数:**
`limit`: 取出评论数量,默认为20
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值
**接口地址:**
`/comment/dj`
**调用例子:**
`/comment/dj?id=794062371`
### banner
说明:调用此接口,可获取 banner(轮播图)数据
注:因参数未知,只能获取比较旧的数据,如果有知道参数的小伙伴,可提交 PR
**接口地址:**
`/banner`
**调用例子:**
`/banner`
### 获取歌曲详情
说明:调用此接口,传入音乐 id, 可获得歌曲详情
@@ -230,7 +494,7 @@ $ set PORT=4000 && node app.js
说明:调用此接口,传入专辑 id,可获得专辑内容
**必选参数:**
`id`: id
`id`: 专辑 id
**接口地址:**
`/album`
@@ -256,21 +520,112 @@ $ set PORT=4000 && node app.js
返回数据如下图:
![获取歌手单曲](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/artists.png)
### 获取歌手 mv
说明:调用此接口,传入歌手 id,可获得歌手 mv 信息,具体 mv 播放地址可调用`/mv`传入此接口获得的mvid 来拿到,如:
`/artist/mv?id=6452`,`/mv?mvid=5461064`
**必选参数:**
`id`: 歌手 id,可由搜索接口获得
**接口地址:**
`/artist/mv`
**调用例子:**
`/artist/mv?id=6452`
### 获取歌手专辑
说明:调用此接口,传入歌手 id,可获得歌手专辑内容
**必选参数:**
`id`: 歌手 id
**可选参数:**
`limit`: 取出数量,默认为50
`offset`: 偏移数量,用于分页,如:(页数-1)*50, 其中 50 为 limit 的值,默认为0
**接口地址:**
`/artist_album`
`/artist/album`
**调用例子:**
`/artist_album?id=6452&limit=30`
`/artist/album?id=6452&limit=30` (周杰伦)
返回数据如下图:
![获取专辑内容](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/artist_album.png)
### 获取歌手描述
说明:调用此接口,传入歌手 id,可获得歌手描述
**必选参数:**
`id`: 歌手 id
**接口地址:**
`/artist/desc`
**调用例子:**
`/artist/desc?id=6452` (周杰伦)
### 获取相似歌手
说明:调用此接口,传入歌手 id,可获得相似歌手
**必选参数:**
`id`: 歌手 id
**接口地址:**
`/simi/artist`
**调用例子:**
`/simi/artist?id=6452` (对应和周杰伦相似歌手)
### 获取相似歌单
说明:调用此接口,传入歌曲 id,可获得相似歌单
**必选参数:**
`id`: 歌曲 id
**接口地址:**
`/simi/playlist`
**调用例子:**
`/simi/playlist?id=347230` (对应'光辉岁月'相似歌单)
### 相似 mv
说明:调用此接口,传入 `mvid` 可获取相似 mv
**必选参数:**
`mvid`: mv id
**接口地址:**
`/simi/mv`
**调用例子:**
`/simi/mv?mvid=5436712`
### 获取相似音乐
说明:调用此接口,传入歌曲 id,可获得相似歌曲
**必选参数:**
`id`: 歌曲 id
**接口地址:**
`/simi/song`
**调用例子:**
`/simi/song?id=347230` (对应'光辉岁月'相似歌曲)
### 获取相似用户
说明:调用此接口,传入歌曲 id,可获得相似歌曲
**必选参数:**
`id`: 歌曲 id
**接口地址:**
`/simi/user`
**调用例子:**
`/simi/user?id=347230` (对应'光辉岁月'相似歌曲)
### 获取每日推荐歌单
说明:调用此接口,可获得每日推荐歌单(需要登录)
@@ -372,10 +727,6 @@ $ set PORT=4000 && node app.js
说明:调用此接口,可获取网友精选碟歌单
**可选参数:**
`limit`: 取出数量,默认为50
`offset`: 偏移数量,用于分页,如:(评论页数-1)*20, 其中 20 为 limit 的值,默认为0
`order`: 可选值为 'new' 和 'hot',分别对应最新和最热,默认为 'hot'
**接口地址:**
@@ -394,7 +745,7 @@ $ set PORT=4000 && node app.js
**可选参数:**
`limit`: 取出数量,默认为50
`offset`: 偏移数量,用于分页,如:(评论页数-1)*50, 其中 50 为 limit 的值,默认为0
`offset`: 偏移数量,用于分页,如:(页数-1)*50, 其中 50 为 limit 的值,默认为0
**接口地址:**
`/new_albums`
@@ -412,7 +763,7 @@ $ set PORT=4000 && node app.js
**可选参数:**
`limit`: 取出数量,默认为50
`offset`: 偏移数量,用于分页,如:(评论页数-1)*50, 其中 50 为 limit 的值,默认为0
`offset`: 偏移数量,用于分页,如:(页数-1)*50, 其中 50 为 limit 的值,默认为0
**接口地址:**
`/top_artists`
@@ -424,10 +775,93 @@ $ set PORT=4000 && node app.js
![热门歌手](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_artists.png)
### mv
说明:调用此接口,传入 mvid(在搜索音乐的时候传 type=1004获得) ,可获取对应 MV 数据,数据包含 mv 名字,歌手,发布时间, mv 视频地址等数据,其中 mv 视频网易做了防盗链处理,不能直接播放,需要播放的话需要调用'播放 mv' 接口
### 最新 mv
说明:调用此接口,可获取最新 mv
**可选参数:**
`limit`: 取出数量,默认为 30
`offset`: 偏移数量,用于分页,如:(页数-1)*30, 其中 30 为 limit 的值,默认为0
**接口地址:**
`/mv/first`
**调用例子:**
`/mv/first?limit=10`
### 推荐 mv
说明:调用此接口,可获取推荐 mv
**接口地址:**
`/personalized/mv`
**调用例子:**
`/personalized/mv`
### 推荐歌单
说明:调用此接口,可获取推荐歌单
**接口地址:**
`/personalized`
**调用例子:**
`/personalized`
### 推荐新音乐
说明:调用此接口,可获取推荐新音乐
**接口地址:**
`/personalized/newsong`
**调用例子:**
`/personalized/newsong`
### 推荐电台
说明:调用此接口,可获取推荐电台
**接口地址:**
`/personalized/djprogram`
**调用例子:**
`/personalized/djprogram`
### 推荐节目
说明:调用此接口,可获取推荐电台
**接口地址:**
`/program/recommend`
**调用例子:**
`/program/recommend`
### 独家放送
说明:调用此接口,可获取独家放送
**接口地址:**
`/personalized/privatecontent`
**调用例子:**
`/personalized/privatecontent`
### mv 排行
说明:调用此接口,可获取 mv 排行
**可选参数:**
`limit`: 取出数量,默认为 30
`offset`: 偏移数量,用于分页,如:(页数-1)*30, 其中 30 为 limit 的值,默认为0
**接口地址:**
`top/mv`
**调用例子:**
`top/mv?limit=10`
### 获取 mv 数据
说明:调用此接口,传入 mvid (在搜索音乐的时候传 type=1004获得) ,可获取对应 MV 数据,数据包含 mv 名字,歌手,发布时间, mv 视频地址等数据,其中 mv 视频网易做了防盗链处理,不能直接播放,需要播放的话需要调用'播放 mv' 接口
**必选参数:**
`mvid`: mv 的 id
**接口地址:**
@@ -445,13 +879,13 @@ $ set PORT=4000 && node app.js
说明:调用此接口,传入 mv 地址,可播放 mv,也可将接口嵌入 video 标签使用,由于使用了 'pipe',进度条无法通过拖动进度条控制进度,如有解决方案可提出 PR 或者自行改造
**可选参数:**
`/url`: mv 的 地址
`url`: mv 的 地址
**接口地址:**
`/play_mv`
`/mv/url`
**调用例子:**
`/play_mv?url=http://v4.music.126.net/20170422034915/c98eab2f5e2c85fc8de2ab3f0f8ed1c6/web/cloudmusic/MjQ3NDQ3MjUw/89a6a279dc2acfcd068b45ce72b1f560/533e4183a709699d566180ed0cd9abe9.mp4`
`/mv/url?url=http://v4.music.126.net/20170422034915/c98eab2f5e2c85fc8de2ab3f0f8ed1c6/web/cloudmusic/MjQ3NDQ3MjUw/89a6a279dc2acfcd068b45ce72b1f560/533e4183a709699d566180ed0cd9abe9.mp4`
如下图:
@@ -499,6 +933,85 @@ $ set PORT=4000 && node app.js
![排行榜](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_list.png)
### 云盘
说明:登陆后调用此接口,可获取云盘数据,获取的数据没有对应 url,需要再调用一次 `/music/url` 获取 url
**接口地址:**
`/user/cloud`
**调用例子:**
`/user/cloud`
### 电台-推荐
说明:登陆后调用此接口,可获得推荐电台
**接口地址:**
`/dj/recommend`
**调用例子:**
`/dj/recommend`
### 电台-分类
说明:登陆后调用此接口,可获得电台类型
**接口地址:**
`/dj/catelist`
**调用例子:**
`/dj/catelist`
### 电台-分类推荐
说明:登陆后调用此接口,可获得推荐电台
**必选参数:**
`type`: 电台类型,数字,可通过`/dj/catelist`获取,对应关系为 id 对应 此接口的 type, name 对应类型意义
**接口地址:**
`/dj/recommend/type`
**调用例子:**
`/dj/recommend/type?type=1`
### 电台-订阅
说明:登陆后调用此接口,传入`rid`,可订阅 dj,dj 的 `rid` 可通过搜索指定 type='1009'获取其 id,如`/search?keywords=代码时间&type=1009`
**必选参数:**
`rid`: 电台 的 id
**接口地址:**
`/dj/sub`
**调用例子:**
`/dj/sub?rid=336355127&t=1` (对应关注'代码时间')
`/dj/sub?rid=336355127&t=0` (对应取消关注'代码时间')
### 电台-详情
说明:登陆后调用此接口,传入`rid`,可获得对应电台的详情介绍
**必选参数:**
`rid`: 电台 的 id
**接口地址:**
`/dj/detail?rid=336355127`
**调用例子:**
`/dj/detail?rid=336355127` (对应'代码时间'的详情介绍)
### 电台-节目
说明:登陆后调用此接口,传入`rid`,可查看对应电台的电台节目以及对应 url
**必选参数:**
`rid`: 电台 的 id
**接口地址:**
`/dj/sub`
**调用例子:**
`/dj/program?rid=336355127` (对应'代码时间'的节目列表)
## 离线访问此文档
此文档同时也是 Progressive Web Apps(PWA), 加入了serviceWorker,可离线访问