update to 3.0.1, #351

CHANGELOG.MD

@@ -1,20 +1,32 @@
 # 更新日志
+
+### 3.0.1 | 2018.10.21
+
+- 合并 PR([#351](https://github.com/Binaryify/NeteaseCloudMusicApi/pull/351))
+
+- 文档增加 `/top/song` 接口
+
+- `/banner` 换成 linux api，返回结构有所变动
+
+- `/check/music` 已知 bug 修复
+
 ### 3.0.0 | 2018.10.14
 
 ## 整体
+
 - 完善文档,增加之前没写进文档的接口说明
 
 - 重写 createRequest 返回 Promise 对象
 
 - 模块化路由
 
-- 模块化, 剥离res,req, 方便导出调用
+- 模块化, 剥离 res,req, 方便导出调用
 
 - 增加 cookie-parser
 
-
 ### 参数修改
-- `/song/detail` 增加多id支持  
+
+- `/song/detail` 增加多 id 支持
 
 - `/toplist/detail` 移除参数
 
@@ -23,13 +35,15 @@
 - `/top/playlist/highquality` 增加分页参数 `before`
 
 ### 统一参数
+
 - `/artist/sub` 与 `artist/unsub` 合并, 用`query.t`
 
 - `/follow` 中 `query.type` 换成 `query.t`
 
 - `/comment` 中 `query.action` 换成 `query.t`
 
-### URL重命名
+### URL 重命名
+
 - `/video` 改为 `video/url`
 
 - `/mv` 改为 `mv/detail`
@@ -37,24 +51,28 @@
 - `/music/url` 改为 `/song/url`
 
 ### 转发逻辑修改
+
 - `/toplist/artist` 换成 weapi
 
 - `/mv/url` 去除了 pipe
 
-### BUG修复
+### BUG 修复
+
 - `/playlist/create`, `/playlist/update` 被判欺骗,增加 cookie
 
 ### 路由增删
+
 - 删除 `/recommend/dislike`
 
-- 增加 `/video/sub` (收藏视频), `/mv/sub` (收藏MV)
+- 增加 `/video/sub` (收藏视频), `/mv/sub` (收藏 MV)
 
 - 增加 `/video/detail` (视频详情)
 
 - 增加 `/related/allvideo` (相关视频)
 
 ### 2.20.5 | 2018.09.29
-修复非法参数403 #335, 修复代理错误 #334
+
+修复非法参数 403 #335, 修复代理错误 #334
 
 ### 2.20.4 | 2018.09.27
 

docs/README.md

@@ -101,6 +101,7 @@
 83. 视频详情
 84. 相关视频
 85. 关注用户
+86. 新歌速递
 
 ## 安装
 
@@ -141,13 +142,14 @@ fetch(url).then(function() {
 // 结果
 // {"data":[{"id":33894312,"url":"http://m10.music.126.net/20180104125640/930a968b3fb04908b733506b3833e60b/ymusic/0fd6/4f65/43ed/a8772889f38dfcb91c04da915b301617.mp3","br":320000,"size":10691439,"md5":"a8772889f38dfcb91c04da915b301617","code":200,"expi":1200,"type":"mp3","gain":-2.0E-4,"fee":0,"uf":null,"payed":0,"flag":0,"canExtend":false}],"code": 200}
 ```
-## 更新到 v3.0 说明
-!>2018.10.14 更新到3.0.0,使用了模块化机制,因为部分接口参数和url做了调整,如还不想升级到3.0.0,请查看 [v2的文档](http://binaryify.github.io/NeteaseCloudMusicApi/#/v2), [更新日志](https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/CHANGELOG.MD), [2.0+下载地址](https://github.com/Binaryify/NeteaseCloudMusicApi/releases/tag/v2.20.5), 同时 2.0+ 将不再维护
 
+## 更新到 v3.0 说明
+
+!>2018.10.14 更新到 3.0.0,使用了模块化机制,因为部分接口参数和 url 做了调整,如还不想升级到 3.0.0,请查看 [v2 的文档](http://binaryify.github.io/NeteaseCloudMusicApi/#/v2), [更新日志](https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/CHANGELOG.MD), [2.0+下载地址](https://github.com/Binaryify/NeteaseCloudMusicApi/releases/tag/v2.20.5), 同时 2.0+ 将不再维护
 
 ## Docker 容器运行
 
-> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
+> 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了.
 
 request 相关的环境变量
 
@@ -405,9 +407,9 @@ tags:歌单tag
 
 **必选参数 :**
 
- `id` : 用户 id
+`id` : 用户 id
 
- `t` : `1`为关注,其他为取消关注  
+`t` : `1`为关注,其他为取消关注
 
 **接口地址 :** `/follow`
 
@@ -481,16 +483,14 @@ category Code 取值:
 
 **必选参数 :**
 
- `artistId` : 歌手 id  
+`artistId` : 歌手 id
-
- `t`:操作,1为收藏,其他为取消收藏
 
+`t`:操作,1 为收藏,其他为取消收藏
 
 **接口地址 :** `/artist/sub`
 
 **调用例子 :** `/artist/sub?id=6452&t=1`
 
-
 ### 收藏的歌手列表
 
 说明 : 调用此接口,可获取收藏的歌手列表
@@ -511,7 +511,6 @@ category Code 取值:
 
 **接口地址 :** `/video/sub`
 
-
 **调用例子 :** `/video/sub`
 
 ### 收藏 MV
@@ -751,6 +750,30 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 返回数据如下图 :
 ![获取歌词](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%AD%8C%E8%AF%8D.png)
 
+### 新歌速递
+
+说明 : 调用此接口 , 可获取新歌速递
+
+**必选参数 :**
+
+`type`: 地区类型 id,对应以下:
+
+```
+全部:0
+华语:7
+欧美:96
+日本:8
+韩国:16
+```
+
+`limit`: 取出数量 , 默认为 100
+
+`offset`: 偏移数量 , 用于分页 , 如 :( 评论页数 -1)\*100, 其中 100 为 limit 的值
+
+**接口地址 :** `/top/song`
+
+**调用例子 :** `/top/song?type=96`
+
 ### 歌曲评论
 
 说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该音乐的所有评论 ( 不需要
@@ -944,8 +967,7 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 
 ### banner
 
-说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据注 : 因参数未知 , 只能获取比较旧
+说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据
-的数据 , 如果有知道参数的小伙伴 , 可提交 PR
 
 **接口地址 :** `/banner`
 
@@ -958,15 +980,16 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 **必选参数 :**
 
 `type`:资源类型,对应以下类型
+
 ```
 1: mv
 4: 电台
 5: 视频
 ```
 
-`t`: 操作,1为点赞,其他未取消点赞
+`t`: 操作,1 为点赞,其他未取消点赞
 
-`id`: 资源id
+`id`: 资源 id
 
 **接口地址 :** `/resource/like`
 
@@ -1320,6 +1343,7 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等
 `/mv/url?id=5436712`
 
 ### 相关视频
+
 说明 : 调用此接口 , 可获取相关视频
 
 **必选参数 :** `id`: 视频 的 id
@@ -1329,6 +1353,7 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等
 **调用例子 :** `/related/allvideo?id=89ADDE33C0AAE8EC14B99F6750DB954D`
 
 ### 视频详情
+
 说明 : 调用此接口 , 可获取相关视频
 
 **必选参数 :** `id`: 视频 的 id
@@ -1352,7 +1377,6 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等
 
 ![视频数据](https://ws1.sinaimg.cn/large/006tNbRwgy1fuqdv10p5rj31kw0da76y.jpg)
 
-
 ### 排行榜
 
 说明 : 调用此接口 , 传入数字 idx, 可获取不同排行榜
@@ -1395,6 +1419,7 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等
 ![排行榜](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_list.png)
 
 ### 所有榜单内容摘要
+
 说明 : 调用此接口,可获取所有榜单内容摘要
 **接口地址 :** `/toplist/detail`
 

module/top_song.js

@@ -8,7 +8,9 @@ module.exports = (query, request) => {
     total: true
   }
   return request(
-        'POST', `http://music.163.com/weapi/v1/discovery/new/songs`, data,
+    'POST',
-        {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy}
+    `http://music.163.com/weapi/v1/discovery/new/songs`,
+    data,
+    { crypto: 'weapi', cookie: query.cookie, proxy: query.proxy }
   )
 }

package.json

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