From 771f249a707ee5399930be2c9701ddf982bec355 Mon Sep 17 00:00:00 2001 From: binaryify Date: Sun, 16 Jun 2019 22:08:04 +0800 Subject: [PATCH] =?UTF-8?q?v3.15.0=20=E6=96=B0=E5=A2=9E`=E8=8E=B7=E5=8F=96?= =?UTF-8?q?=E8=A7=86=E9=A2=91=E6=A0=87=E7=AD=BE=E5=88=97=E8=A1=A8`,`?= =?UTF-8?q?=E7=BD=91=E6=98=93=E5=87=BA=E5=93=81`,`=E5=85=A8=E9=83=A8mv`?= =?UTF-8?q?=E6=8E=A5=E5=8F=A3,=20`=E6=9C=80=E6=96=B0=20mv`=20=E5=92=8C=20`?= =?UTF-8?q?mv=20=E6=8E=92=E8=A1=8C`=20=E6=8E=A5=E5=8F=A3=E5=8A=A0=E5=85=A5?= =?UTF-8?q?=E5=9C=B0=E5=8C=BA=E5=8F=82=20=E6=95=B0,=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E6=96=87=E6=A1=A3=20#505?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.MD | 3 ++ README.MD | 5 ++- docs/README.md | 78 +++++++++++++++++++++++++++++-------- module/mv_all.js | 19 +++++++++ module/mv_exclusive_rcmd.js | 18 +++++++++ module/mv_first.js | 22 ++++++----- module/top_mv.js | 22 ++++++----- module/video_group_list.js | 15 +++++++ package.json | 2 +- 9 files changed, 145 insertions(+), 39 deletions(-) create mode 100644 module/mv_all.js create mode 100644 module/mv_exclusive_rcmd.js create mode 100644 module/video_group_list.js diff --git a/CHANGELOG.MD b/CHANGELOG.MD index 00ab918..17cfcbe 100644 --- a/CHANGELOG.MD +++ b/CHANGELOG.MD @@ -1,4 +1,7 @@ # 更新日志 +### 3.15.0 | 2019.06.16 +- 新增`获取视频标签列表`,`网易出品`,`全部mv`接口, `最新 mv` 和 `mv 排行` 接口加入地区参数,更新文档 + ### 3.14.0 | 2019.06.10 - 获取用户粉丝列表接口修改请求参数，更新文档 diff --git a/README.MD b/README.MD index 6781243..f3d9fce 100644 --- a/README.MD +++ b/README.MD @@ -98,7 +98,7 @@ 75. 付费精选接口 76. 音乐是否可用检查接口 77. 登录状态 -78. 获取视频数据 +78. 获取视频播放地址 79. 发送/删除评论 80. 热门评论 81. 视频评论 @@ -137,6 +137,9 @@ 114. 私信内容 115. 我的数字专辑 116. batch批量请求接口 +117. 获取视频标签列表 +118. 全部mv +119. 网易出品mv ## 环境要求 diff --git a/docs/README.md b/docs/README.md index 35a2080..c795715 100644 --- a/docs/README.md +++ b/docs/README.md @@ -93,7 +93,7 @@ 75. 付费精选接口 76. 音乐是否可用检查接口 77. 登录状态 -78. 获取视频数据 +78. 获取视频播放地址 79. 发送/删除评论 80. 热门评论 81. 视频评论 @@ -132,6 +132,9 @@ 114. 私信内容 115. 我的数字专辑 116. batch批量请求接口 +117. 获取视频标签列表 +118. 全部mv +119. 网易出品mv ## 安装 @@ -1544,16 +1547,48 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具 ![热门歌手](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_artists.png) -### 最新 mv +### 全部 mv +说明 : 调用此接口 , 可获取全部 mv +**可选参数 :** +`area`: 地区,可选值为全部,内地,港台,欧美,日本,韩国,不填则为全部 +`type`: 类型,可选值为全部,官方版,原生,现场版,网易出品,不填则为全部 + +`order`: 排序,可选值为上升最快,最热,最新,不填则为上升最快 + +`limit`: 取出数量 , 默认为 30 + +`offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*50, 其中 50 为 limit 的值 , 默认 +为 0 + +**接口地址 :** `/mv/all` + +**调用例子 :** `/mv/all?area=港台` + +### 最新 mv 说明 : 调用此接口 , 可获取最新 mv +**可选参数 :** `area`: 地区,可选值为全部,内地,港台,欧美,日本,韩国,不填则为全部 + **可选参数 :** `limit`: 取出数量 , 默认为 30 **接口地址 :** `/mv/first` **调用例子 :** `/mv/first?limit=10` +### 网易出品mv + +说明 : 调用此接口 , 可获取网易出品 mv + +**可选参数 :** `limit`: 取出数量 , 默认为 30 + +`offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认 +为 0 + +**接口地址 :** `/mv/exclusive/rcmd` + +**调用例子 :** `/mv/exclusive/rcmd?limit=10` + ### 推荐 mv 说明 : 调用此接口 , 可获取推荐 mv @@ -1606,14 +1641,16 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具 说明 : 调用此接口 , 可获取 mv 排行 -**可选参数 :** `limit`: 取出数量 , 默认为 30 +**可选参数 :** `limit`: 取出数量 , 默认为 30 + +`area`: 地区,可选值为内地,港台,欧美,日本,韩国,不填则为全部 `offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认 为 0 -**接口地址 :** `top/mv` +**接口地址 :** `/top/mv` -**调用例子 :** `top/mv?limit=10` +**调用例子 :** `/top/mv?limit=10` ### 获取 mv 数据 @@ -1643,6 +1680,22 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等 `/mv/url?id=5436712` +### 获取视频标签列表 +说明 : 调用此接口 , 可获取视频标签列表 + +**接口地址 :** `/video/group/list` + +**调用例子 :** `/video/group/list` + +### 获取视频标签下的视频 +说明 : 调用此接口 , 传入`id`,可获取到相关的视频。 + +**必选参数 :** `id`: videoGroup 的 id + +**接口地址 :** `/video/group` + +**调用例子 :** `/video/group?id=9104` + ### 相关视频 说明 : 调用此接口 , 可获取相关视频 @@ -1653,9 +1706,10 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等 **调用例子 :** `/related/allvideo?id=89ADDE33C0AAE8EC14B99F6750DB954D` + ### 视频详情 -说明 : 调用此接口 , 可获取相关视频 +说明 : 调用此接口 , 可获取视频详情 **必选参数 :** `id`: 视频 的 id @@ -1663,7 +1717,7 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等 **调用例子 :** `/video/detail?id=89ADDE33C0AAE8EC14B99F6750DB954D` -### 获取视频数据 +### 获取视频播放地址 说明 : 调用此接口 , 传入视频 id,可获取视频播放地址 @@ -1678,16 +1732,6 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等 ![视频数据](https://ws1.sinaimg.cn/large/006tNbRwgy1fuqdv10p5rj31kw0da76y.jpg) -### 获取视频标签下的视频 -说明 : 调用此接口 , 传入`videoGroupId`,可获取到相关的视频。 - -**必选参数 :** `传入videoGroupId`: videoGroup 的 id - -**接口地址 :** `/video/group` - -**调用例子 :** `/video/group?id=9104` - - ### 排行榜 说明 : 调用此接口 , 传入数字 idx, 可获取不同排行榜 diff --git a/module/mv_all.js b/module/mv_all.js new file mode 100644 index 0000000..4a955c9 --- /dev/null +++ b/module/mv_all.js @@ -0,0 +1,19 @@ +// 全部MV + +module.exports = (query, request) => { + const data = { + tags: JSON.stringify({ + 地区: query.area || "全部", + 类型: query.type || "全部", + 排序: query.order || "上升最快" + }), + offset: query.limit || 0, + total: "true", + limit: query.limit || 30 + }; + return request("POST", `https://interface.music.163.com/api/mv/all`, data, { + crypto: "weapi", + cookie: query.cookie, + proxy: query.proxy + }); +}; diff --git a/module/mv_exclusive_rcmd.js b/module/mv_exclusive_rcmd.js new file mode 100644 index 0000000..7efd248 --- /dev/null +++ b/module/mv_exclusive_rcmd.js @@ -0,0 +1,18 @@ +// 网易出品 + +module.exports = (query, request) => { + const data = { + offset: query.limit || 0, + limit: query.limit || 30 + }; + return request( + "POST", + `https://interface.music.163.com/api/mv/exclusive/rcmd`, + data, + { + crypto: "weapi", + cookie: query.cookie, + proxy: query.proxy + } + ); +}; diff --git a/module/mv_first.js b/module/mv_first.js index 7851c7f..d13284c 100644 --- a/module/mv_first.js +++ b/module/mv_first.js @@ -1,13 +1,15 @@ // 最新MV module.exports = (query, request) => { - const data = { - // 'offset': query.offset || 0, - limit: query.limit || 30, - total: true - } - return request( - 'POST', `https://music.163.com/weapi/mv/first`, data, - {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy} - ) -} \ No newline at end of file + const data = { + // 'offset': query.offset || 0, + area: query.area || "", + limit: query.limit || 30, + total: true + }; + return request("POST", `https://interface.music.163.com/weapi/mv/first`, data, { + crypto: "weapi", + cookie: query.cookie, + proxy: query.proxy + }); +}; diff --git a/module/top_mv.js b/module/top_mv.js index df35e6e..14bb71f 100644 --- a/module/top_mv.js +++ b/module/top_mv.js @@ -1,13 +1,15 @@ // MV排行榜 module.exports = (query, request) => { - const data = { - limit: query.limit || 30, - offset: query.offset || 0, - total: true - } - return request( - 'POST', `https://music.163.com/weapi/mv/toplist`, data, - {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy} - ) -} \ No newline at end of file + const data = { + area: query.area || "", + limit: query.limit || 30, + offset: query.offset || 0, + total: true + }; + return request("POST", `https://music.163.com/weapi/mv/toplist`, data, { + crypto: "weapi", + cookie: query.cookie, + proxy: query.proxy + }); +}; diff --git a/module/video_group_list.js b/module/video_group_list.js new file mode 100644 index 0000000..a217fd3 --- /dev/null +++ b/module/video_group_list.js @@ -0,0 +1,15 @@ +module.exports = (query, request) => { + const data = { + }; + return request( + "POST", + `https://music.163.com/api/cloudvideo/group/list`, + data, + { + crypto: "weapi", + cookie: query.cookie, + proxy: query.proxy + } + ); + }; + \ No newline at end of file diff --git a/package.json b/package.json index e425ece..c323e45 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "NeteaseCloudMusicApi", - "version": "3.14.0", + "version": "3.15.0", "description": "网易云音乐 NodeJS 版 API", "scripts": { "start": "node app.js",