Java版SDK
使用说明授权模块不是独立的应用,是其他应用模块接入的前提,申请其他应用时,都需要一并申请账号授权的能力。当申请了其他的能力并选择使用Java版SDK接入时,可参考以下的SDK接口说明。若还未下载SDK,请先下载SDK。
SDK获取开发语言资源下载环境要求Java适用于Java语言、jdk版本1.7以上的环境
SDK相关接口调用
注意: 在调用SDK的支付相关接口前,需要先配置SDK的应用信息:
publicstaticvoidsetConfig(Stringappid,StringappKey);
参数说明
参数参数类型说明appidstring应用唯一标识
appKeystring应用秘钥
调用方式:Config.setConfig(appId, appKey);
SDK接口说明如下:
1, 通过code换取网页授权access_token
通过code换取网页授权access_token
publicstaticTokengetToken(Stringcode);
尤其注意:由于应用appkey和获取到的access_token安全级别比较高,后续刷新access_token、通过access_token获取用户信息等步骤,必须从服务器调用接口。
参数说明
参数参数类型说明codestring填写第一步获取的code参数
调用方式:Token token = OAuth2.getToken(code);
2, 刷新access_token (如果需要)publicstaticTokenrefreshAccessToken(Stringrefresh_token);
由于access_token的有效期较短,当access_token超时后,可以使用refresh_token进行刷新,refresh_token有效期为90天,当refresh_token失效之后,需要用户重新授权。使用refresh_token刷新access_token时,会返回一个新的refresh_token。
参数说明
参数参数类型说明refresh_tokenstring填写通过code获取到的refresh_token参数
调用方式:Token token = OAuth2.refreshAccessToken(refreshToken);
3, 拉取用户信息publicstaticUserInfogetUserInfo(Stringaccess_token,Stringopenid);
参数说明
参数参数类型说明access_tokenstringaccess_token
openidstring用户标识openid
调用方式:UserInfo userInfo = OAuth2.getUserInfo(accessToken, openId);
4, 获取RPCTOken(RPC)publicstaticStringgetRPCToken(Stringaccess_token,Stringscope);
由于access_token的安全级别比较高,当需要客户端调用某些接口时,需要通过access_token换取一个rpc_token。客户端可以通过rpc_token直接调用接口。
参数说明
参数参数类型说明access_tokenstringaccess_token
scopestring用户授权的作用域(share_file,upload_file,get_user_info)
调用方式:String rpcToken = OAuth2.getRPCToken(accessToken);
5, 检测RPCTOken的权限publicstaticbooleancheckRPCToken(Stringrpc_token,Stringscope);
参数说明参数参数类型说明rpc_tokenstringrpc_token
scopestring用户授权的作用域
调用方式:boolean result = OAuth2.checkRPCToken(rpcToken, scope);