diff --git a/CHANGELOG.MD b/CHANGELOG.MD index 909e3965afe9be35511d7ca115cd24aefed619e5..bd64e029e8dc07e4a50d2ba9c5a6c468ccd82e0f 100644 --- a/CHANGELOG.MD +++ b/CHANGELOG.MD @@ -1,4 +1,8 @@ # 更新日志 +### 3.36.0 | 2020.07.26 +- 新增`全部新碟`,`数字专辑-新碟上架`,`数字专辑&数字单曲-榜单`,`数字专辑-语种风格馆`,`数字专辑详情`接口 [#852](https://github.com/Binaryify/NeteaseCloudMusicApi/issues/852) +- 更新`新碟上架`接口,修改传入参数,返回数据结构有变化 + ### 3.35.0 | 2020.07.18 - 新增`首页-发现`,`首页-发现-圆形图标入口列表`接口 [#851](https://github.com/Binaryify/NeteaseCloudMusicApi/pull/851) diff --git a/README.MD b/README.MD index 8b10bcb78080955215753f056b00ab6a0aa6cb3b..23ab692ad529b0c93a3d5f106cbb4dc519ca6034 100644 --- a/README.MD +++ b/README.MD @@ -177,6 +177,11 @@ 156. 国家编码列表 157. 首页-发现 158. 首页-发现-圆形图标入口列表 +159. 数字专辑-全部新碟 +160. 数字专辑-热门新碟 +161. 数字专辑&数字单曲-榜单 +162. 数字专辑-语种风格馆 +163. 数字专辑详情 ## 环境要求 diff --git a/docs/README.md b/docs/README.md index 488e66104acea0517231781f17d28be9207d9d0b..cff9acf12342ea0e44fc99d0cd9ebac1ef033997 100644 --- a/docs/README.md +++ b/docs/README.md @@ -174,6 +174,11 @@ 156. 国家编码列表 157. 首页-发现 158. 首页-发现-圆形图标入口列表 +159. 全部新碟 +160. 数字专辑-新碟上架 +161. 数字专辑&数字单曲-榜单 +162. 数字专辑-语种风格馆 +163. 数字专辑详情 ## 安装 @@ -1801,18 +1806,39 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具 说明 : 调用此接口 , 可获取新碟上架列表 , 如需具体音乐信息需要调用获取专辑列表接 口 `/album` , 然后传入 id, 如 `/album?id=32311&limit=30` -**可选参数 :** `limit`: 取出数量 , 默认为 50 +**可选参数 :** + + `limit`: 取出数量 , 默认为 50 `offset`: 偏移数量 , 用于分页 , 如 :( 页数 -1)\*50, 其中 50 为 limit 的值 , 默认 为 0 +`area`: ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本 + +`type` : new:全部 hot:热门,默认为 new + +`year` : 年,默认本年 + +`month` : 月,默认本月 + **接口地址 :** `/top/album` -**调用例子 :** `/top/album?offset=0&limit=30` +**调用例子 :** `/top/album?offset=0&limit=30&year=2019&month=6` -返回数据如下图 : +### 全部新碟 +说明 : 登陆后调用此接口 ,可获取全部新碟 + +**可选参数 :** + +`limit` : 返回数量 , 默认为 30 + +`offset` : 偏移数量，用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0 -![新碟上架](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/new_albums.png) +`area` : ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本 + +**接口地址 :** `/album/new` + +**调用例子 :** `/album/new?area=KR&limit=10` ### 最新专辑 @@ -2548,6 +2574,59 @@ type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009` **调用例子 :** `/setting` +### 数字专辑-新碟上架 +说明 : 调用此接口 ,可获取数字专辑-新碟上架 + +**可选参数 :** + +`limit` : 返回数量 , 默认为 30 + +`offset` : 偏移数量，用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0 +**接口地址 :** `/album/list` + +**调用例子 :** `/album/list?limit=10` + +### 数字专辑&数字单曲-榜单 +说明 : 调用此接口 ,可获取数字专辑&数字单曲-榜单 + +**可选参数 :** + +`limit` : 返回数量 , 默认为 30 + +`offset` : 偏移数量，用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0 + +`albumType` : 为数字专辑,1为数字单曲 + +`type` : daily:日榜,week:周榜,year:年榜,total:总榜 + +**接口地址 :** `/album_songsaleboard` + +**调用例子 :** `/album/songsaleboard?type=year&year=2020&albumType=0` + +### 数字专辑-语种风格馆 + +说明 : 调用此接口 ,可获取语种风格馆数字专辑列表 + +**可选参数 :** + +`limit` : 返回数量 , 默认为 30 + +`offset` : 偏移数量，用于分页 , 如 :( 页数 -1)\*30, 其中 30 为 limit 的值 , 默认为 0 + +`area` 地区 Z_H:华语,E_A:欧美,KR:韩国,JP:日本 + +**接口地址 :** `/album/list/style` + +**调用例子 :** `/album/list/style?area=Z_H&offset=2` + +### 数字专辑详情 +说明 : 调用此接口 ,传入数字专辑id可获取数字专辑详情(和歌单详情有差异) + +**接口地址 :** `/album/detail` + +**调用例子 :** `/album/detail?id=84547195` + + ### 我的数字专辑 说明 : 登陆后调用此接口 ,可获取我的数字专辑 diff --git a/module/album_detail.js b/module/album_detail.js new file mode 100644 index 0000000000000000000000000000000000000000..053cd62f19c558e0440544d662cbb51f4e9e809b --- /dev/null +++ b/module/album_detail.js @@ -0,0 +1,14 @@ +// 数字专辑详情 +module.exports = (query, request) => { + const data = { + id: query.id + } + return request( + 'POST', `https://music.163.com/weapi/vipmall/albumproduct/detail`, data, + { + crypto: 'weapi', + cookie: query.cookie, + proxy: query.proxy, + } + ) +} \ No newline at end of file diff --git a/module/album_list.js b/module/album_list.js new file mode 100644 index 0000000000000000000000000000000000000000..a2d998cc5c1a1413e3faa502510dbf6d0c33ba20 --- /dev/null +++ b/module/album_list.js @@ -0,0 +1,14 @@ +// 数字专辑-新碟上架 +module.exports = (query, request) => { + const data = { + limit: query.limit || 30, + offset: query.offset || 0, + total: true, + area: query.area || 'ALL', //ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本 + type: query.type + } + return request( + 'POST', `https://music.163.com/weapi/vipmall/albumproduct/list`, data, + {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy} + ) +} \ No newline at end of file diff --git a/module/album_list_style.js b/module/album_list_style.js new file mode 100644 index 0000000000000000000000000000000000000000..6bd7a39b8d09905e3ef5493564d52c0154633c4a --- /dev/null +++ b/module/album_list_style.js @@ -0,0 +1,13 @@ +// 数字专辑-语种风格馆 +module.exports = (query, request) => { + const data = { + limit: query.limit || 10, + offset: query.offset || 0, + total: true, + area: query.area || 'Z_H', //Z_H:华语,E_A:欧美,KR:韩国,JP:日本 + } + return request( + 'POST', `https://music.163.com/weapi/vipmall/appalbum/album/style`, data, + {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy} + ) +} \ No newline at end of file diff --git a/module/album_new.js b/module/album_new.js new file mode 100644 index 0000000000000000000000000000000000000000..5889a2a122a7c61ee1d102f79e00ecf79d7f7b4b --- /dev/null +++ b/module/album_new.js @@ -0,0 +1,13 @@ +// 全部新碟 +module.exports = (query, request) => { + const data = { + limit: query.limit || 30, + offset: query.offset || 0, + total: true, + area: query.area || 'ALL' //ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本 + } + return request( + 'POST', `https://music.163.com/weapi/album/new`, data, + {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy} + ) +} \ No newline at end of file diff --git a/module/album_songsaleboard.js b/module/album_songsaleboard.js new file mode 100644 index 0000000000000000000000000000000000000000..f761ab006d3a214cd0b9ee62654a0dc6f2ac6db6 --- /dev/null +++ b/module/album_songsaleboard.js @@ -0,0 +1,19 @@ +// 数字专辑&数字单曲-榜单 +module.exports = (query, request) => { + let data = { + albumType: query.albumType || 0, //0为数字专辑,1为数字单曲 + } + const type = query.type || 'daily' // daily,week,year,total + if (type === 'year') { + data = { + ...data, + year: query.year, + } + } + return request( + 'POST', + `https://music.163.com/api/feealbum/songsaleboard/${type}/type`, + data, + { crypto: 'weapi', cookie: query.cookie, proxy: query.proxy } + ) +} diff --git a/module/top_album.js b/module/top_album.js index 98780fc8756ee741c28fad1fecd39fcce6f43fc3..a6e0f86b05ab6ff65dfc6a3b20df336c253b5cb0 100644 --- a/module/top_album.js +++ b/module/top_album.js @@ -1,14 +1,18 @@ // 新碟上架 module.exports = (query, request) => { + const date = new Date() + const data = { - area: query.type || 'ALL', // ALL,ZH,EA,KR,JP + area: query.area || 'ALL', // //ALL:全部,ZH:华语,EA:欧美,KR:韩国,JP:日本 limit: query.limit || 50, offset: query.offset || 0, - total: true + type: query.type || 'new', + year: query.year || date.getFullYear(), + month: query.month || date.getMonth() + 1, } return request( - 'POST', `https://music.163.com/weapi/album/new`, data, + 'POST', `https://music.163.com/api/discovery/new/albums/area`, data, {crypto: 'weapi', cookie: query.cookie, proxy: query.proxy} ) } \ No newline at end of file diff --git a/package.json b/package.json index 0c5696e7355da7f78bea306ba9fb11867df8b1a9..6ce3b1dadee22d80f4c8c5fe474d350dbb6df9ee 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "NeteaseCloudMusicApi", - "version": "3.35.0", + "version": "3.36.0", "description": "网易云音乐 NodeJS 版 API", "scripts": { "start": "node app.js",