admingitea/api-enhanced
1
0
Fork 0
mirror of https://github.com/NeteaseCloudMusicApiEnhanced/api-enhanced.git synced 2026-10-20 22:51:23 +08:00
Code Issues Packages Projects Releases Wiki Activity

v4.0,新增云盘上传接口以及二维码登录相关接口和相关demo,升级部分接口加密方法 #70 , #121 ,#121 , #153 ,#248 , #705 , #716 , #745 , #1055

Browse Source
This commit is contained in:
binaryify
2021-01-03 20:17:26 +08:00
parent 77775b25f5
commit 75cb79fc6a
22 changed files with 543 additions and 195 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+56 -17
View File
@@ -213,6 +213,10 @@
195. 关注歌手新歌
196. 关注歌手新MV
197. 歌手详情
198. 云盘上传
199. 二维码登录
200. 话题详情
201. 话题详情热门动态
## 安装
@@ -359,7 +363,7 @@ $ sudo docker run -d -p 3000:3000 netease-music-api
!> 部分接口如登录接口不能调用太频繁 , 否则可能会触发 503 错误或者 ip 高频错误 ,若需频繁调用 , 需要准备 IP 代理池 (更新:已加入缓存机制,但仍需注意).
!> 本项目仅供学习使用,请尊重版权，请勿利用此项目从事商业行为
!> 本项目仅供学习使用,请尊重版权，请勿利用此项目从事商业行为或进行破坏版权行为
!> 文档可能会有缓存 , 如果文档版本和 github 上的版本不一致,请清除缓存再查看
@@ -420,22 +424,34 @@ v3.30.0后支持手动传入cookie,登录接口返回内容新增 `cookie` 字
}
```
#### 3. 二维码登录
说明: 二维码登录涉及到3个接口
1. 二维码key生成接口
说明: 调用此接口可生成一个key
说明: 二维码登录涉及到3个接口,调用务必带上时间戳,防止缓存
##### 1. 二维码key生成接口
说明: 调用此接口可生成一个key
**接口地址 :** `/login/qr/key`
##### 2. 二维码生成接口
说明: 调用此接口传入上一个接口生成的key可生成二维码图片的base64和二维码信息,可使用base64展示图片,或者使用二维码信息内容自行使用第三方二维码生产库渲染二维码
2. 二维码生成接口
说明: 调用此接口传入上一个接口生成的key可生成二维码图片的base64和二维码信息,可使用base64展示图片,或者使用二维码信息内容自行使用第三方二维码生产库渲染二维码
可选参数: `qrimg` 传入后
**接口地址 :** `/login/qr/create`
必选参数: `key`,由第一个接口生成
可选参数: `qrimg` 传入后会额外返回二维码图片base64编码
**接口地址 :** `/login/qr/create`
**调用例子 :** `/login/qr/create?key=xxx`
3. 二维码检测扫码状态接口
说明: 轮询此接口可获取二维码扫码状态,801为等待扫码,802为待确认,803为授权登陆成功
##### 3. 二维码检测扫码状态接口
说明: 轮询此接口可获取二维码扫码状态,800为二维码过期,801为等待扫码,802为待确认,803为授权登录成功(803状态码下会返回cookies)
必选参数: `key`,由第一个接口生成
**接口地址 :** `/login/qr/check`
**调用例子 :** `/login/qr/check?key=xxx`
调用可参考项目文件例子`/public/qrlogin.html` (访问地址:http://localhost:3000/qrlogin.html)
#### 注意
@@ -640,7 +656,7 @@ signature：用户签名
**调用例子 :** `/user/update?gender=0&signature=测试签名&city=440300&nickname=binary&birthday=1525918298004&province=440000`
### 更新头像
说明 : 登录后调用此接口,使用`'Content-Type': 'multipart/form-data'`上传图片formData(name为'imgFile'),可更新头像(参考:https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/public/avatar_update.html)
说明 : 登录后调用此接口,使用`'Content-Type': 'multipart/form-data'`上传图片formData(name为'imgFile'),可更新头像(参考:https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/public/avatar_update.html),支持命令行调用,参考module_example目录下`avatar_upload.js`
**可选参数 :**
@@ -936,6 +952,21 @@ tags: 歌单标签
**调用例子 :** `/hot/topic?limit=30&offset=30`
### 获取话题详情
说明 : 调用此接口 , 可获取话题详情
**接口地址 :** `/topic/detail`
**调用例子 :** `/topic/detail?actid=111551188`
### 获取话题详情热门动态
说明 : 调用此接口 , 可获取话题详情热门动态
**接口地址 :** `/topic/detail/event/hot`
**调用例子 :** `/topic/detail/event/hot?actid=111551188`
### 云村热评
说明 : 登录后调用此接口 , 可获取云村热评
@@ -1238,10 +1269,6 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
**调用例子 :** `/search?keywords= 海阔天空` `/cloudsearch?keywords= 海阔天空`
返回数据如下图 :
![搜索音乐](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E6%90%9C%E7%B4%A2.png)
### 默认搜索关键词
说明 : 调用此接口 , 可获取默认搜索关键词
@@ -1443,8 +1470,7 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
### 歌曲评论
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该音乐的所有评论 ( 不需要
登录 )
说明 : 调用此接口 , 传入音乐 id 和 limit 参数 , 可获得该音乐的所有评论 ( 不需要登录 )
**必选参数 :** `id`: 音乐 id
@@ -2553,6 +2579,19 @@ type : 地区
**调用例子 :** `/user/cloud/del`
### 云盘上传
说明 : 登录后调用此接口,使用`'Content-Type': 'multipart/form-data'`上传mp3 formData(name为'songFile'),可上传歌曲到云盘
参考: https://github.com/Binaryify/NeteaseCloudMusicApi/blob/master/public/cloud.html
访问地址: http://localhost:3000/qrlogin.html)
支持命令行调用,参考module_example目录下`song_upload.js`
**接口地址 :** `/cloud`
**调用例子 :** `/cloud`
### 电台banner
说明 : 调用此接口,可获取电台banner