v3.15.0 新增获取视频标签列表,网易出品,全部mv接口, 最新 mv 和 mv 排行 接口加入地区参 数,更新文档 #505

CHANGELOG.MD

@@ -1,4 +1,7 @@
 # 更新日志
+### 3.15.0 | 2019.06.16
+- 新增`获取视频标签列表`,`网易出品`,`全部mv`接口, `最新 mv` 和 `mv 排行` 接口加入地区参数,更新文档
+
 ### 3.14.0 | 2019.06.10
 - 获取用户粉丝列表接口修改请求参数，更新文档
 

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
 
 
 ## 环境要求

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
@@ -1608,12 +1643,14 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 
 **可选参数 :** `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, 可获取不同排行榜

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
+  });
+};

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
+    }
+  );
+};

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}
-    )
-}
+  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
+  });
+};

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}
-    )
-}
+  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
+  });
+};

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
+      }
+    );
+  };
+  

package.json

@@ -1,6 +1,6 @@
 {
   "name": "NeteaseCloudMusicApi",
-  "version": "3.14.0",
+  "version": "3.15.0",
   "description": "网易云音乐 NodeJS 版 API",
   "scripts": {
     "start": "node app.js",