学习笔记HTML-css-JS.zip

# NeteaseCloudMusicApi 网易云音乐 NodeJS 版 API ## 灵感来自 [disoul/electron-cloud-music](https://github.com/disoul/electron-cloud-music) [darknessomi/musicbox](https://github.com/darknessomi/musicbox) [sqaiyan/netmusic-node](https://github.com/sqaiyan/netmusic-node) ## 工作原理 跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API ## 功能特性 1. 登录 2. 刷新登录 3. 获取用户信息 , 歌单，收藏，mv, dj 数量 4. 获取用户歌单 5. 获取用户电台 6. 获取用户关注列表 7. 获取用户粉丝列表 8. 获取用户动态 9. 获取用户播放记录 10. 获取精品歌单 11. 获取歌单详情 12. 搜索 13. 搜索建议 14. 获取歌词 15. 歌曲评论 16. 收藏单曲到歌单 17. 专辑评论 18. 歌单评论 19. mv 评论 20. 电台节目评论 21. banner 22. 获取歌曲详情 23. 获取专辑内容 24. 获取歌手单曲 25. 获取歌手 mv 26. 获取歌手专辑 27. 获取歌手描述 28. 获取相似歌手 29. 获取相似歌单 30. 相似 mv 31. 获取相似音乐 32. 获取最近 5 个听了这首歌的用户 33. 获取每日推荐歌单 34. 获取每日推荐歌曲 35. 私人 FM 36. 签到 37. 喜欢音乐 38. 垃圾桶 39. 歌单 ( 网友精选碟 ) 40. 新碟上架 41. 热门歌手 42. 最新 mv 43. 推荐 mv 44. 推荐歌单 45. 推荐新音乐 46. 推荐电台 47. 推荐节目 48. 独家放送 49. mv 排行 50. 获取 mv 数据 51. 播放 mv/视频 52. 排行榜 53. 歌手榜 54. 云盘 55. 电台 - 推荐 56. 电台 - 分类 57. 电台 - 分类推荐 58. 电台 - 订阅 59. 电台 - 详情 60. 电台 - 节目 61. 给评论点赞 62. 获取动态 63. 获取热搜 64. 发送私信 65. 发送私信歌单 66. 新建歌单 67. 收藏/取消收藏歌单 68. 歌单分类 69. 收藏的歌手列表 70. 订阅的电台列表 71. 相关歌单推荐 72. 付费精选接口 73. 音乐是否可用检查接口 74. 登录状态 75. 获取视频数据 76. 发送/删除评论 77. 热门评论 78. 视频评论 79. 退出登录 80. 所有榜单 81. 所有榜单内容摘要 82. 收藏视频 83. 收藏 MV 84. 视频详情 85. 相关视频 86. 关注用户 87. 新歌速递 88. 喜欢音乐列表(无序) 89. 收藏的 MV 列表 90. 获取最新专辑 91. 听歌打卡 ## 安装 ```shell $ git clone git@github.com: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 ``` ## 可以使用代理 在 query 参数中加上 proxy=your-proxy 即可让这一次的请求使用 proxy ```javascript // 例子 const url = `http://localhost:3000/song/url?id=33894312&proxy=http://121.196.226.246:84` fetch(url).then(function() { // do what you want }) // 结果 // {"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+ 将不再维护 ## Docker 容器运行 > 注意: 在 docker 中运行的时候, 由于使用了 request 来发请求, 所以会检查几个 proxy 相关的环境变量(如下所列), 这些环境变量 会影响到 request 的代理, 详情请参考[request 的文档](https://github.com/request/request#proxies), 如果这些环境变量 指向的代理不可用, 那么就会造成错误, 所以在使用 docker 的时候一定要注意这些环境变量. 不过, 要是你在 query 中加上了 proxy 参数, 那么环境变量会被覆盖, 就会用你通过 proxy 参数提供的代理了. request 相关的环境变量 1. http_proxy 2. https_proxy 3. HTTP_PROXY 4. HTTPS_PROXY 5. no_proxy 6. NO_PROXY ```shell docker pull binaryify/netease_cloud_music_api docker run -d -p 3000:3000 --name netease_cloud_music_api binaryify/netease_cloud_music_api // 或者 docker run -d -p 3000:3000 binaryify/netease_cloud_music_api // 去掉或者设置相关的环境变量 docker run -d -p 3000:3000 --name netease_cloud_music_api -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= binaryify/netease_cloud_music_api // 或者 docker run -d -p 3000:3000 -e http_proxy= -e https_proxy= -e no_proxy= -e HTTP_PROXY= -e HTTPS_PROXY= -e NO_PROXY= binaryify/netease_cloud_music_api ``` > 以下是自行 build docker 镜像方式 ``` $ 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 ``` ## 接口文档 ### 调用前须知 !> 为使用方便,降低门槛,登录接口直接使用了 get 明文请求,请按实际需求对源码修改 !> 由于接口做了缓存处理 ( 缓存 2 分钟,不缓存数据极容易引起网易服务器高频ip错误 , 可在 app.js 设置 , 可能会导致登陆后获取不 到 cookie), 相同的 url 会在两分钟内只向网易服务器发一次请求 , 如果遇到不需要缓 存结果的接口 , 可在请求 url 后面加一个时间戳参数使 url 不同 , 例子 : `/simi/playlist?id=347230&timestamp=1503019930000` !> 如果是跨域请求 , 请在所有请求带上 `xhrFields: { withCredentials: true }` 否则 可能会因为没带上 cookie 导致 301, 具体例子可看 `public/test.html`, 例子使用 jQuery, axios 版本也类似 !> 301 错误基本都是没登录就调用了需要登录的接口,如果登陆了还是提示 301, 基本都是缓存把数据缓存起来了,解决方法是等待 2 分钟或者重启服务重新登录后再调用接口 !> 部分接口如登录接口不能调用太频繁 , 否则可能会触发 503 错误或者 ip 高频错误 ,若需频繁调用 , 需要准备 IP 代理池 (更新:已加入缓存机制,但仍需注意). !> 本项目仅供学习使用 , 文档可能会有缓存 , 如果文档版本和 github 上的版本不一致,请清除缓存再查看 !> 由于网易限制,此项目在国外服务器上使用会受到限制,如需解决 , 可使用大陆服务器或者使用代理 , 感谢 [@hiyangguo](https://github.com/hiyangguo)提出的[解决方法](https://github.com/Binaryify/NeteaseCloudMusicApi/issues/29#issuecomment-298358438): 在 'util.js' 的 'headers' 处增加 `X-Real-IP':'211.161.244.70' // 任意国内 IP` 即可解决 ### 登录 说明 : 登录有两个接口 #### 1. 手机登录 **必选参数 :** `phone`: 手机号码 `password`: 密码 **接口地址 :** `/login/cellphone` **调用例子 :** `/login/cellphone?phone=xxx&password=yyy` #### 2. 邮箱登录 ~~ 注意 : 此接口被网易和谐了 , 待修复 , 暂时使用手机登录 (2017.05.20)~~ > 更新 : 此接口已经可以正常使用(2018.07.03) **必选参数 :** `email`: 163 网易邮箱 `password`: 密码 **接口地址 :** `/login` **调用例子 :** `/login?email=xxx@163.com&password=yyy` 返回数据如下图 :  完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies #### 注意 调用登录接口的速度比调用其他接口慢 , 因为登录过程调用了加密算法 ### 刷新登录 �