新增登录状态查询接口 #302 ,完善文档,完善路由注册 #297 v2.17.0

CHANGELOG.MD

@@ -1,4 +1,7 @@
 # 更新日志
+### 2.17.0 | 2018.08.28
+新增登录状态查询接口 #302 ,完善文档,完善路由注册 #297
+
 ### 2.16.0 | 2018.08.09
 - Fixed #288,#289,#290
 

docs/README.md

@@ -15,6 +15,9 @@
 跨站请求伪造 (CSRF), 伪造请求头 , 调用官方 API
 
 ## 版本新特性
+### 2.17.0 | 2018.08.28
+新增登录状态查询接口
+
 ### 2.15.0 | 2018.07.30
 新增相关歌单推荐和付费精选接口,增加歌手列表接口按首字母索引查找参数
 
@@ -131,6 +134,8 @@ banner 接口 , 增加刷新登录接口 , 增加电台相关接口 , 补充评
 70. 订阅的电台列表
 71. 相关歌单推荐
 72. 付费精选接口
+73. 音乐是否可用检查接口
+74. 登录状态
 
 
 ## 安装
@@ -269,8 +274,17 @@ Cookies
 
 说明 : 调用此接口 , 可刷新登录状态
 
+
 **调用例子 :** `/login/refresh`
 
+
+### 登录状态
+说明 : 调用此接口,可获取登录状态
+
+**接口地址 :** `/login/status`
+返回数据如下图:
+![数据](https://ws2.sinaimg.cn/large/006tNbRwgy1fup6q18kk6j316i0nw0wa.jpg)
+
 ### 获取用户详情
 
 说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户详情
@@ -588,6 +602,17 @@ category Code 取值:
 返回数据如下图 :
 ![音乐 url](https://raw.githubusercontent.com/Binaryify/NeteaseCloudMusicApi/master/static/%E9%9F%B3%E4%B9%90%20url.png)
 
+### 音乐是否可用
+说明: 调用此接口,传入歌曲 id, 可获取音乐是否可用,返回 `{ success: true, message: 'ok' }` 或者 `{ success: false, message: '亲爱的,暂无版权' }`
+
+**必选参数 :** `id` : 歌曲 id
+
+**可选参数** : `br`: 码率,默认设置了999000即最大码率,如果要 320k 则可设置为 320000,其他类推
+
+**接口地址 :** `/check/music`
+
+**调用例子 :** `/check/music?id=33894312`
+
 ### 搜索
 
 说明 : 调用此接口 , 传入搜索关键词可以搜索该音乐 / 专辑 / 歌手 / 歌单 / 用户 ,

package.json

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

router/check_music.js

@@ -1,27 +1,27 @@
 module.exports = (req, res, createWebAPIRequest, request) => {
-  const id = parseInt(req.query.id);
-  const br = parseInt(req.query.br || 999000);
+  const id = parseInt(req.query.id)
+  const br = parseInt(req.query.br || 999000)
   const data = {
     ids: [id],
     br: br,
-    csrf_token: ""
-  };
-  const cookie = req.get("Cookie") ? req.get("Cookie") : "";
+    csrf_token: ''
+  }
+  const cookie = req.get('Cookie') ? req.get('Cookie') : ''
 
   createWebAPIRequest(
-    "music.163.com",
-    "/weapi/song/enhance/player/url",
-    "POST",
+    'music.163.com',
+    '/weapi/song/enhance/player/url',
+    'POST',
     data,
     cookie,
     music_req => {
       if (JSON.parse(music_req).code == 200) {
-        return res.send({ success: true, message: "ok" });
+        return res.send({ success: true, message: 'ok' })
       }
-      return res.send({ success: false, message: "亲爱的,暂无版权" });
+      return res.send({ success: false, message: '亲爱的,暂无版权' })
     },
     err => {
-      res.status(502).send("fetch error");
+      res.status(502).send('fetch error')
     }
-  );
-};
+  )
+}