神牛教 Oauth2 授权登录接口开发文档

1、开发环境

当前API最新版本：V1.0.0.1
最新更新时间：2018-11-17
作者：小黄牛
PHP环境：PHP5.4+
服务器环境：Windows/Linux/Apache/Nginx
简介：本接口的Appid只限于神牛教成员可获取。

2、使用过程

1、生成授权地址进行跳转
2、获得code状态码
3、使用code状态码获取access_token身份凭证
4、使用access_token获取用户信息
注意：code与access_token均为一次性授权，不管授权成功与否，这两个参数都会被重置，需要重新在步骤1开始获取。

3、详细使用说明：

接口必备参数：
appid 身份ID
redirect_uri 回调地址
state开发者自定义参数，可为空

1、开发者先使用上面三个参数，生成跳转URL，让用户进行触发跳转授权，格式如下：
https://xiuxian.junphp.com/oauth2?appid=身份ID&redirect_uri=回调地址&state=用户随机内容

2、当用户点击进入该链接后，会被要求登录后进行授权确认，确认成功后，神牛教服务器会自动生成code参数，回跳到指点的redirect_uri地址中，code参数为get类型，同时也是会带之前设置的state参数，例如：
https://blog.junphp.com/shenniujiao.jsp?code=A4N1S6K7CC3FDSETK5MYDBFU34M48CSTJ30NHF7GE2ACRACVLDN7GKPM50X8ZAR5&state=

3、当获得code后，开发者使用curl库发送get请求到指定api中，获取access_token，格式如下：
https://xiuxian.junphp.com/oauth2/access_token?appid=身份ID&code=状态码

4、当获得access_token后，开发者再次使用curl库发送get请求到api中，获取用户信息，格式如下：
https://xiuxian.junphp.com/oauth2/get_user?appid=身份ID&access_token=身份凭证

5、最后就是完成开发者，自己的注册与自动登录逻辑了。

4、参数说明

https://xiuxian.junphp.com/oauth2的参数说明如下：

https://xiuxian.junphp.com/oauth2/access_token的参数说明如下：

https://xiuxian.junphp.com/oauth2/get_user的参数说明如下：

5、调用DEMO

<?php # 组装授权地址后，回跳到这里进行处理 $code = Request::get('code'); # 这个链接地址必须是当前链接地址，并且不带?参数。 $appid = ""; // 身份ID $url = "https://xiuxian.junphp.com/oauth2/access_token?appid=$appid&code=$code"; # 发送CURL，获得Access_Token $res = $this->https_request($url); $data = json_decode($res, true); if (empty($data['access_token'])) { $this->error('神牛教授权异常！', 'login'); } # 发送CURL，获得用户的信息 $url = "https://xiuxian.junphp.com/oauth2/get_user?appid=$appid&access_token=".$data['access_token']; $res = $this->https_request($url); $data = json_decode($res, true); if (empty($data['nick'])) { $this->error('神牛教用户信息获取失败！', 'login'); } else { # 查询是否有注册过 $info = Db::name('user')->find(); # 存在，直接登录 if ($info) { Session::set('user', $info); header("Location: ***");exit; } else { # 不存在，注册再直接登录 } }

6、返回值说明

https://xiuxian.junphp.com/oauth2 的返回值为GET参数，参数说明：

https://xiuxian.junphp.com/oauth2/access_token 的返回值为JSON类型，参数说明：

https://xiuxian.junphp.com/oauth2/get_user 的返回值为JSON类型，参数说明：

7、状态码说明

状态码	说明
200	请求成功
10001	AppId错误
10002	redirect_uri错误
10003	AppId 或 Code错误
10004	AppId 或 Access_Token错误
10005	服务器异常