增加热门评论和视频评论接口,更新文档 v2.20.2

docs/README.md

@@ -14,65 +14,6 @@
 
 跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API
 
-## 版本新特性
-
-### 2.19.0 | 2018.08.29
-
-新增获取视频数据接口,新增评论发送/删除接口
-
-### 2.17.0 | 2018.08.28
-
-新增登录状态查询接口
-
-### 2.15.0 | 2018.07.30
-
-新增相关歌单推荐和付费精选接口,增加歌手列表接口按首字母索引查找参数
-
-### 2.14.0 | 2018.07.03
-
-修复无法使用邮箱问题
-
-### 2.11.0 | 2018.05.21
-
-增加收藏歌手列表&订阅电台列表
-
-### 2.10.0 | 2018.05.17
-
-歌单操作调整为批量操作
-
-### 2.9.8 | 2018.05.10
-
-新增歌手分类列表,收藏/取消收藏歌手接口,新增更新用户信息,更新歌单接口
-
-### 2.9.6 | 2018.05.08
-
-新增发送私信相关接口,新增新建歌单,收藏/取消收藏歌单接口
-
-### 2.9.4 | 2018.05.04
-
-新增热搜接口,更新 banner 接口
-
-### 2.9.0 | 2018.01.26
-
-docker 构建文件的一些增强以及增加访问日志和调试输出
-
-### 2.8.1 | 2018.01.04
-
-添加了 proxy 功能
-
-### 2.6.4 | 2017.7.16
-
-添加缓存机制和随机 UA 机制 感谢[@u3u](https://github.com/u3u)
-[issue:77](https://github.com/Binaryify/NeteaseCloudMusicApi/issues/77) 优化请求
-代码 感谢 [@huhuime](https://github.com/huhuime)
-[issue:83](https://github.com/Binaryify/NeteaseCloudMusicApi/issues/83)
-
-### 2.5.0 | 2017.4.29
-
-增加 mv/ 专辑 / 歌单评论接口 , 增加云盘相关接口 , 增加获取用户动态 / 信息接口 ,
-增加关注 / 粉丝列表接口 , 增加收藏歌单接口 , 增加相似 mv/ 歌曲 / 用户接口 , 增加
-banner 接口 , 增加刷新登录接口 , 增加电台相关接口 , 补充评论接口 , 更新文档
-
 ## 功能特性
 
 1. 登录
@@ -151,6 +92,8 @@ banner 接口 , 增加刷新登录接口 , 增加电台相关接口 , 补充评
 74. 登录状态
 75. 获取视频数据
 76. 发送/删除评论
+77. 热门评论
+78. 视频评论
 
 ## 安装
 
@@ -822,6 +765,42 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
 
 **调用例子 :** `/comment/dj?id=794062371`
 
+### 视频评论
+
+说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该 视频 的所有评论 (
+不需要登录 )
+
+**必选参数 :** `id`: 视频的 id
+
+**可选参数 :** `limit`: 取出评论数量 , 默认为 20
+
+`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*20, 其中 20 为 limit 的值
+
+**接口地址 :** `/comment/video`
+
+**调用例子 :** `/comment/video?id=89ADDE33C0AAE8EC14B99F6750DB954D`
+
+### 热门评论
+说明 : 调用此接口 ,  传入 type, 资源 id 可获得对应资源热门评论 ( 不需要登录 )
+
+**必选参数 :**
+
+`id` : 资源 id
+
+`tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型
+
+```
+0: 歌曲
+1: mv
+2: 歌单
+3: 专辑
+4: 电台
+5: 视频
+```
+**接口地址 :** `/comment/hot`
+
+**调用例子 :** `/comment/hot?id=186016&type=0`
+
 ### 给评论点赞
 
 说明 : 调用此接口 , 传入 type, 资源 id, 和评论 id cid 和 是否点赞参数 t 即可给对
@@ -833,7 +812,7 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
 
 `t` : 是否点赞 ,1 为点赞 ,0 为取消点赞
 
-`tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台对应以下类型
+`tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台, 视频对应以下类型
 
 ```
 0: 歌曲
@@ -841,6 +820,7 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
 2: 歌单
 3: 专辑
 4: 电台
+5: 视频
 ```
 
 **接口地址 :** `comment/like`
@@ -859,7 +839,7 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
    **必选参数**
    `action`:1 发送
 
-   `tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台对应以下类型
+   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型
 
    ```
    0: 歌曲
@@ -867,6 +847,7 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
    2: 歌单
    3: 专辑
    4: 电台
+   5: 视频
    ```
 
    `id`:对应资源 id
@@ -880,7 +861,7 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
    **必选参数**
     `action`:0 删除
 
-   `tpye`: 数字 , 资源类型 , 对应歌曲 , mv, 专辑 , 歌单 , 电台对应以下类型
+   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型
 
    ```
    0: 歌曲
@@ -888,6 +869,7 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具
    2: 歌单
    3: 专辑
    4: 电台
+   5: 视频
    ```
 
    `id`:对应资源 id