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

This commit is contained in:
binaryify
2019-06-16 22:08:04 +08:00
parent 356d5e2c46
commit 771f249a70
9 changed files with 145 additions and 39 deletions
+61 -17
View File
@@ -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, 可获取不同排行榜