diff --git a/README.md b/README.md index 4ebf35e0be20fc8e754fc5e87ac241e99b531f52..1d06dbf1eca807ac40633a3e6d2f2f46bd030127 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -## Netease-cloud-api +## 网易云音乐刷等级API

Author @@ -8,6 +8,10 @@ 这是一个能够提供网易云音乐每日听满300首歌曲的基于PHP语言的API项目,配合python全自动脚本项目使用更佳。全自动脚本项目:https://github.com/ZainCheung/netease-cloud +## 灵感来自 + +[Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi) + ## 功能特性 1. 登录 @@ -27,3 +31,78 @@ 5. 访问你的接口看到欢迎页面即部署成功 使用这种方式部署网站接口,0成本且快速可用,且不用担心环境部署运维等问题,当然如果有条件用自己的服务器搭建也是可以的。 + +## 接口文档 + +### 调用前须知 + +> 本项目不提供线上 demo,请不要轻易信任使用他人提供的公开服务,如果使用,填写密码时一定要自己加密MD5,以免发生安全问题,泄露自己的账号和密码。 + +> 为使用方便,降低门槛, 文档示例接口直接使用了 GET 请求,本项目同时支持 GET/POST 请按实际需求使用 + +> 本项目仅供学习使用,请尊重版权,请勿利用此项目从事商业行为 + +> API登陆接口只接收MD5加密后的密码,并且不会储存你的个人信息,原密码除了你自己谁也不知道 + +> 使用本项目不会影响你的听歌风格,刷的歌都来自你的每日推荐歌单。 + +### 登录 + +说明 : 登录有两个接口,建议使用`encodeURIComponent`对密码编码或者使用`POST`请求,避免某些特殊字符无法解析,如`#`(`#`在url中会被识别为hash,而不是query) + +#### 1. 手机登录 + +**必选参数 :** +`uin`: 手机号码 + +`pwd`: 密码 + +**接口地址 :** `/?do=login` + +**可选参数 :** `r`: 0至1的随机数,例如`0.20246864764818318` + +**调用例子 :** `/?do=login&uin=xxx&pwd=yyy` + +#### 2. 邮箱登录 + +**必选参数 :** + +`uin`: 163 网易邮箱 + +`pwd`: 密码 + +**接口地址 :** `/?do=email` + +**调用例子 :** `/?do=email&uin=xxx&pwd=yyy` + +完成登录后 , 会在浏览器保存一个 Cookies 用作登录凭证 , 大部分 API 都需要用到这个 Cookies,请求会自动带上 Cookies + +### 签到 + +说明:调用接口这个接口可以签到 + +**接口地址 :** `/?do=sign` + +### 打卡听歌 + +说明:由于网易云官方问题,打卡听歌只刷了一部分,可以多请求几次,建议每次间隔30秒请求3次左右 + +**接口地址 :** `/?do=daka` + +### 获取用户详情 + +说明 : 登陆后调用此接口 , 传入用户 id, 可以获取用户详情 + +**必选参数 :** `uid` : 用户 id + +**接口地址 :** ``/?do=detail` + +**调用例子 :** `/`/?do=detail&uid=32953014` + +注意获取用户信息接口传入的时`uid`,而登陆接口传入的是`uin`,不要搞混淆 + +### 检查接口 + +说明:调用此接口可检查当前项目API是否可用,建议在调用接口前先调用此接口做个判断 + +**接口地址 :** `/?do=check`