修复取消喜欢歌曲失败问题 #360 补充已喜欢音乐列表接口说明文档 #370 默认关闭 debug 模式 #365 更新 Dockerfile 文件 #367

2026-10-20 22:51:23 +08:00 · 2018-11-09 15:23:48 +08:00
parent aea538c8ee
commit 8bb37684f8
8 changed files with 637 additions and 953 deletions
@@ -102,30 +102,46 @@
 84. 相关视频
 85. 关注用户
 86. 新歌速递
+87. 喜欢音乐列表(无序)

 ## 安装

 ```shell
 $ git clone [email protected]:Binaryify/NeteaseCloudMusicApi.git
+
+
+
 $ npm install
+
+
+
 ```

 ## 运行

 ```shell
 $ node app.js
+
+
+
 ```

 服务器启动默认端口为 3000, 若不想使用 3000 端口 , 可使用以下命令 : Mac/Linux

 ```shell
 $ PORT=4000 node app.js
+
+
+
 ```

 windows 下使用 git-bash 或者 cmder 等终端执行以下命令 :

 ```shell
 $ set PORT=4000 && node app.js
+
+
+
 ```

 ## 可以使用代理
@@ -162,18 +178,42 @@ request 相关的环境变量

 ```shell
 docker pull twesix/netease-cloud-music
+
+
+
 docker run -d -p 3000:3000 --name netease-cloud-music twesix/netease-music-api

+
+
+
+
+
+
 // 去掉或者设置相关的环境变量
+
+
+
 docker run -d -p 3000:3000 --name netease-cloud-music -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= netease-cloud-music
+
+
+
 ```

 > 由于 docker 镜像更新不是很及时,推荐自己 build, 以下为 build 镜像的方式

 ```
 $ git clone https://github.com/Binaryify/NeteaseCloudMusicApi && cd NeteaseCloudMusicApi
+
+
+
 $ sudo docker build . -t netease-music-api
+
+
+
 $ sudo docker run -d -p 3000:3000 netease-music-api
+
+
+
 ```

 ## 接口文档
@@ -182,7 +222,7 @@ $ sudo docker run -d -p 3000:3000 netease-music-api

 !> 为使用方便,降低门槛,登录接口直接使用了 get 明文请求,请按实际需求对源码修改

-!> 由于接口做了缓存处理 ( 缓存 2 分钟 , 可在 app.js 设置 , 可能会导致登陆后获取不
+!> 由于接口做了缓存处理 ( 缓存 2 分钟,不缓存数据极容易引起网易服务器高频ip错误 , 可在 app.js 设置 , 可能会导致登陆后获取不
 到 cookie), 相同的 url 会在两分钟内只向网易服务器发一次请求 , 如果遇到不需要缓
 存结果的接口 , 可在请求 url 后面加一个时间戳参数使 url 不同 , 例子 :
 `/simi/playlist?id=347230&timestamp=1503019930000`
@@ -280,11 +320,29 @@ Cookies

 ```
 gender: 性别 0:保密 1:男性 2:女性
+
+
+
 birthday: 出生日期,时间戳 unix timestamp
+
+
+
 nickname: 用户昵称
+
+
+
 province: 省份id
+
+
+
 city: 城市id
+
+
+
 signature：用户签名
+
+
+
 ```

 **接口地址 :** `/user/subcount`
@@ -311,9 +369,21 @@ signature：用户签名

 ```
 id:歌单id
+
+
+
 name:歌单名字
+
+
+
 desc:歌单描述
+
+
+
 tags:歌单tag
+
+
+
 ```

 **接口地址 :** `/playlist/update`
@@ -369,6 +439,7 @@ tags:歌单tag
 **必选参数 :** `uid` : 用户 id

 **可选参数 :**
+
 `limit` : 返回数量 , 默认为 30

 `offset` : 偏移数量，用于分页 , 如
@@ -443,6 +514,7 @@ tags:歌单tag
 说明 : 调用此接口,可获取歌手分类列表
 **必选参数 :** `cat` : 即 category Code,歌手类型,默认 1001,返回华语男歌手数据
 **可选参数 :**
+
 `limit` : 返回数量 , 默认为 30

 `offset` : 偏移数量，用于分页 , 如
@@ -453,21 +525,69 @@ category Code 取值:

 ```
 入驻歌手 5001
+
+
+
 华语男歌手 1001
+
+
+
 华语女歌手 1002
+
+
+
 华语组合/乐队 1003
+
+
+
 欧美男歌手 2001
+
+
+
 欧美女歌手 2002
+
+
+
 欧美组合/乐队 2003
+
+
+
 日本男歌手 6001
+
+
+
 日本女歌手 6002
+
+
+
 日本组合/乐队 6003
+
+
+
 韩国男歌手 7001
+
+
+
 韩国女歌手 7002
+
+
+
 韩国组合/乐队 7003
+
+
+
 其他男歌手 4001
+
+
+
 其他女歌手 4002
+
+
+
 其他组合/乐队 4003
+
+
+
 ```

 **接口地址 :** `/artist/list`
@@ -560,7 +680,9 @@ category Code 取值:
 返回数据如下图 :

 ![精选碟](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/top_playlist.png)
+
 ![对应位置](https://ws2.sinaimg.cn/large/006tKfTcgy1fr3wnpyg6jj317e0vcqdc.jpg)
+
 ![返回数据](https://ws4.sinaimg.cn/large/006tKfTcgy1fr3wqs5lw9j31ic1re4c4.jpg)

 ### 获取精品歌单
@@ -673,6 +795,7 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 **必选参数 :** `keywords` : 关键词

 **可选参数 :**
+
 `limit` : 返回数量 , 默认为 30

 `offset` : 偏移数量，用于分页 , 如
@@ -713,6 +836,7 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 说明 : 调用此接口 , 传入类型和歌单 id 可收藏歌单或者取消收藏歌单

 **必选参数 :**
+
 `t` : 类型,1:收藏,2:取消收藏
 `id` : 歌单 id

@@ -728,6 +852,7 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 说明 : 调用此接口 , 可以添加歌曲到歌单或者从歌单删除某首歌曲 ( 需要登录 )

 **必选参数 :**
+
 `op`: 从歌单增加单曲为 add, 删除为 del

 `pid`: 歌单 id
@@ -760,10 +885,25 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具

 ```
 全部:0
+
+
+
 华语:7
+
+
+
 欧美:96
+
+
+
 日本:8
+
+
+
 韩国:16
+
+
+
 ```

 `limit`: 取出数量 , 默认为 100
@@ -879,11 +1019,29 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具

 ```
 0: 歌曲
+
+
+
 1: mv
+
+
+
 2: 歌单
+
+
+
 3: 专辑
+
+
+
 4: 电台
+
+
+
 5: 视频
+
+
+
 ```

 **接口地址 :** `/comment/hot`
@@ -905,11 +1063,29 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具

 ```
 0: 歌曲
+
+
+
 1: mv
+
+
+
 2: 歌单
+
+
+
 3: 专辑
+
+
+
 4: 电台
+
+
+
 5: 视频
+
+
+
 ```

 **接口地址 :** `comment/like`
@@ -925,17 +1101,36 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 1. 发送评论

   **必选参数**
+
   `t`:1 发送

   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型

   ```
   0: 歌曲
+
+   
+
   1: mv
+
+   
+
   2: 歌单
+
+   
+
   3: 专辑
+
+   
+
   4: 电台
+
+   
+
   5: 视频
+
+   
+
   ```

   `id`:对应资源 id
@@ -947,17 +1142,36 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具
 2. 删除评论

   **必选参数**
+
   `t`:0 删除

   `tpye`: 数字,资源类型,对应歌曲,mv,专辑,歌单,电台,视频对应以下类型

   ```
   0: 歌曲
+
+   
+
   1: mv
+
+   
+
   2: 歌单
+
+   
+
   3: 专辑
+
+   
+
   4: 电台
+
+   
+
   5: 视频
+
+   
+
   ```

   `id`:对应资源 id
@@ -983,8 +1197,17 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具

 ```
 1: mv
+
+
+
 4: 电台
+
+
+
 5: 视频
+
+
+
 ```

 `t`: 操作,1 为点赞,其他未取消点赞
@@ -1195,6 +1418,16 @@ mp3url 不能直接用 , 可通过 `/song/url` 接口传入歌曲 id 获取具

 ![喜欢成功截图](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/likeSuccess.png)

+### 喜欢音乐列表
+
+说明 : 调用此接口 , 传入用户 id, 可获取已喜欢音乐id列表(id数组)
+
+**必选参数 :** `uid`: 用户 id
+
+**接口地址 :** `/likelist`
+
+**调用例子 :** `/likelist?uid=32953014`
+
 ### 垃圾桶

 说明 : 调用此接口 , 传入音乐 id, 可把该音乐从私人 FM 中移除至垃圾桶
@@ -1340,6 +1573,7 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等
 **接口地址 :** `/mv/url`

 **调用例子 :**
+
 `/mv/url?id=5436712`

 ### 相关视频
@@ -1385,29 +1619,101 @@ MV 数据 , 数据包含 mv 名字 , 歌手 , 发布时间 , mv 视频地址等

 ```
 "0": 云音乐新歌榜,
+
+
+
 "1": 云音乐热歌榜,
+
+
+
 "2": 网易原创歌曲榜,
+
+
+
 "3": 云音乐飙升榜,
+
+
+
 "4": 云音乐电音榜,
+
+
+
 "5": UK排行榜周榜,
+
+
+
 "6": 美国Billboard周榜
+
+
+
 "7": KTV嗨榜,
+
+
+
 "8": iTunes榜,
+
+
+
 "9": Hit FM Top榜,
+
+
+
 "10": 日本Oricon周榜
+
+
+
 "11": 韩国Melon排行榜周榜,
+
+
+
 "12": 韩国Mnet排行榜周榜,
+
+
+
 "13": 韩国Melon原声周榜,
+
+
+
 "14": 中国TOP排行榜(港台榜),
+
+
+
 "15": 中国TOP排行榜(内地榜)
+
+
+
 "16": 香港电台中文歌曲龙虎榜,
+
+
+
 "17": 华语金曲榜,
+
+
+
 "18": 中国嘻哈榜,
+
+
+
 "19": 法国 NRJ EuroHot 30周榜,
+
+
+
 "20": 台湾Hito排行榜,
+
+
+
 "21": Beatport全球电子舞曲榜,
+
+
+
 "22": 云音乐ACG音乐榜,
+
+
+
 "23": 云音乐嘻哈榜
+
+
+
 ```

 **接口地址 :** `/top/list`
@@ -1517,6 +1823,7 @@ type='1009' 获取其 id, 如`/search?keywords= 代码时间 &type=1009`
 **必选参数 :** `rid`: 电台 的 id

 **可选参数 :**
+
 `limit` : 返回数量 , 默认为 30

 `offset` : 偏移数量，用于分页 , 如