* 数组还可以提供一个额外的 'return'=>'json|array' 的键值对,用来将查询结果返回而不是直接打印 json 字符串,当通过 ajax 访问时不要使用; * 数组的其他的键值对是易班 API 接口的请求参数,'access_token' 默认从授权后的 cookie 中获取,无需手动提供,因此请忽略这个参数。 * 这个类返回的信息都是直接从易班 API 原样返回的,所以请直接登录 https://open.yiban.cn/wiki/index.php?page=%E6%98%93%E7%8F%ADapi 查看可能的返回值,包括上文提到的接口路径和请求参数也请自行查看。 * 非常特殊的一点,无论如何也不要在 'path'=>'some/path' 键值对中填写 'oauth/authorize' 或 'oauth/access_token' 的接口路径; * 因为这两个是用来直接转跳到易班登录接口并获取 access_token 的,而获取方法本 php 文件已经写好了。 * 下面是仅需要做的步骤: * (1) 到易班开放平台创建应用并获取 AppID 和 AppSecret; * (2) 如果是第三方网站,在创建应用时将 oauth2.0 回调地址填写为本 php 文件的地址或者引用本 php 文件的地址; * 如果是站内应用或轻应用,则将将应用地址填写为本 php 文件的地址或者引用本 php 文件的地址; * (3) 修改上文中的配置应用信息中的 $appId 和 $appSecret 两个属性的值为所创建应用的 AppID 和 AppSecret; * (4) 在 html 页面中使用如 <a href="/yiban.api.php?action=authorize">授权</a> 的 url 参数方式转跳并调用授权接口; * (5) 最后一步,在浏览器点击页面设置的“授权”锚链,网页会自动跳转到易班登录界面,输入账号密码后提交登录就大功告成了,默认会返回设置锚链的页面。 */ /* 在任何 include 了该 php 文件的页面,都可以使用 if(YibanApi::authorized()){} 来判断是否已获得授权从而引导用户进行授权 */ /* * 下面的判断语句用来实现通过 url 地址参数的方式调用本 php 文件的接口并获得授权信息; * 用法和上述 php 引用类似,只是将数组写为 url 查询字符串的形式,通常在 ajax 中使用; * url 地址访问的文件可以是本文件或者任何 include 了本文件的 php 文件; * url 地址中需要使用 action=request 参数来访问 YibanApi::request() 方法。 */ if (isset($_REQUEST['action'])) { $action = $_REQUEST['action']; if ($action == 'login') { $action = 'authorize'; } YibanApi::$action($_REQUEST); } else { if (isset($_GET['code']) || isset($_GET['verify_request'])) { YibanApi::authorize($_GET); } }