diff --git a/CHANGELOG.MD b/CHANGELOG.MD index 0b05583c77287c9306f136a0763ae91316d045b0..34b7a1d420e30598085b6bcc84a1250c0e3a0a51 100644 --- a/CHANGELOG.MD +++ b/CHANGELOG.MD @@ -1,4 +1,7 @@ # 更新日志 +### 2.9.7 | 2018.05.10 +新增歌手分类列表,收藏/取消收藏歌手接口 + ### 2.9.6 | 2018.05.08 新增发送私信相关接口,新增新建歌单,收藏/取消收藏歌单接口 diff --git a/docs/README.md b/docs/README.md index 83cee7c659f8a546301d6af0543ebf6e72c15b90..c60028e1f6c2aa6809db84d3d3387166772668fc 100644 --- a/docs/README.md +++ b/docs/README.md @@ -15,6 +15,8 @@ 跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API ## 版本新特性 +### 2.9.7 | 2018.05.10 +新增歌手分类列表,收藏/取消收藏歌手接口 ### 2.9.6 | 2018.05.08 新增发送私信相关接口,新增新建歌单,收藏/取消收藏歌单接口 @@ -392,6 +394,59 @@ Cookies **调用例子 :** `/event` +### 歌手分类列表 +说明 : 调用此接口,可获取歌手分类列表 +**必选参数 :** `cat` : 即 category Code,歌手类型,默认 1001,返回华语男歌手数据 +**可选参数 :** +`limit` : 返回数量 , 默认为 30 + +`offset` : 偏移数量,用于分页 , 如 +: 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0 +category Code 取值: +``` +入驻歌手 5001 +华语男歌手 1001 +华语女歌手 1002 +华语组合/乐队 1003 +欧美男歌手 2001 +欧美女歌手 2002 +欧美组合/乐队 2003 +日本男歌手 6001 +日本女歌手 6002 +日本组合/乐队 6003 +韩国男歌手 7001 +韩国女歌手 7002 +韩国组合/乐队 7003 +其他男歌手 4001 +其他女歌手 4002 +其他组合/乐队 4003 +``` + +**接口地址 :** `/artist/list` + + +**调用例子 :** `/artist/list?cat=1001` + +返回数据如下图: +![数据](https://ws1.sinaimg.cn/large/006tKfTcgy1fr60g9zps9j31kw1bpk4n.jpg) + +### 收藏歌手 +说明 : 调用此接口,可收藏歌手 +**必选参数 :** `artistId` : 歌手 id + +**接口地址 :** `/artist/sub` + +**调用例子 :** `/artist/sub?id=6452` + +### 取消收藏歌手 +说明 : 调用此接口,可取消收藏歌手 +**必选参数 :** `artistId` : 歌手 id + +**接口地址 :** `/artist/unsub` + + +**调用例子 :** `/artist/unsub?id=6452` + ### 歌单分类 说明 : 调用此接口,可获取歌单分类,包含 category 信息 @@ -510,7 +565,10 @@ mp3url 不能直接用 , 可通过 `/music/url` 接口传入歌曲 id 获取具 **必选参数 :** `keywords` : 关键词 -**可选参数 :** `limit` : 返回数量 , 默认为 30 `offset` : 偏移数量,用于分页 , 如 +**可选参数 :** +`limit` : 返回数量 , 默认为 30 + +`offset` : 偏移数量,用于分页 , 如 : 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0 `type`: 搜索类型;默认为 1 即单曲 , 取值意义 : 1: 单曲 10: 专辑 100: 歌手 1000: diff --git a/package.json b/package.json index 1d2f56ddcb3e751361b78e105158780f07c6eaa1..be7162dd304aa32fa0689d6ad0abb2d290be47f6 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "NeteaseCloudMusicApi", - "version": "2.9.6", + "version": "2.9.7", "description": "网易云音乐 NodeJS 版 API", "scripts": { "start": "node app.js", diff --git a/router/artist_list.js b/router/artist_list.js index 3f8ba03d172c2065981b56a99d05c5b93e321c9e..b150dc7f8adef3c80e40bedb89c87e5cf45932a4 100644 --- a/router/artist_list.js +++ b/router/artist_list.js @@ -29,7 +29,7 @@ router.get("/", (req, res) => { categoryCode: req.query.cat || "1001", offset: req.query.offset || 0, total: req.query.total ? "true" : "false", - limit: req.query.limit || 50 + limit: req.query.limit || 30 }; createWebAPIRequest( "music.163.com",