renil/neteasecloudmusicapi
1
0
Fork 0
mirror of https://gitlab.com/Binaryify/neteasecloudmusicapi.git synced 2025-05-23 22:37:41 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

update to 3.0.1, #351

Browse Source
This commit is contained in:
binaryify 2018-10-21 12:36:56 +08:00
parent a3ab099147
commit da63d97145
4 changed files with 91 additions and 46 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
CHANGELOG.MD
View File

@ -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

55
docs/README.md
View File

@ -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
`t`:操作,1为收藏,其他为取消收藏
`artistId` : 歌手 id
`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( 轮播图 ) 数据注 : 因参数未知 , 只能获取比较旧
的数据 , 如果有知道参数的小伙伴 , 可提交 PR
说明 : 调用此接口 , 可获取 banner( 轮播图 ) 数据
**接口地址 :** `/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`

22
module/top_song.js
View File

@ -1,14 +1,16 @@
// 新歌速递
module.exports = (query, request) => {
const data = {
areaId: query.type || 0, // 全部:0 华语:7 欧美:96 日本:8 韩国:16
limit: query.limit || 100,
offset: query.offset || 0,
total: true
}
return request(
'POST', `http://music.163.com/weapi/v1/discovery/new/songs`, data,
{crypto: 'weapi', cookie: query.cookie, proxy: query.proxy}
)
const data = {
areaId: query.type || 0, // 全部:0 华语:7 欧美:96 日本:8 韩国:16
limit: query.limit || 100,
offset: query.offset || 0,
total: true
}
return request(
'POST',
`http://music.163.com/weapi/v1/discovery/new/songs`,
data,
{ crypto: 'weapi', cookie: query.cookie, proxy: query.proxy }
)
}

2
package.json
View File

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