open api认证和调用教程

方法教程

方法介绍


一、openapi接口调用流程
1、管理员账号登录系统 > 后台管理中心 > 开放平台
2、开发者资料 > 获取系统分配Corpid;
3、应用管理 > 请选择创建应用的类型 > 填写应用名称、认证类型、接口加密
4、提交审核,审核通过后会生成应用人员唯一userid、系统分配app_key及app_secret(请看图一的相关操作);
5、获取授权码CODE(参见 获取code信息);
6、根据code获取应用令牌access_token(参见 获取accessToken信息 );
7、使用access_token调用具体接口。

注意:
code:有效时间为10分钟,且只能使用一次
access_token:有效时间为2小时,建议开发者存储该值,到期后自动获取一次,目前不支持access_token的刷新即续期。


另外系统提供了SDK方式调用
SDK-jar包下载地址,以及代码示例(请看下面的在线文档,搜索sdk即有下载地址)

详细文档和教程说明请看在线文档

图一:


CallApiUtil工具类代码案例

package com.weaver.seconddev.broadsync;

import cn.hutool.http.HttpRequest;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;

public class CallApiUtil {
    /** 通过后台管理中心-开放平台-开发者资料 中获取  */
    public static String CORPID = "eae6b0463e13652416969fd53617a6ab";

    /** 通过后台管理中心-开放平台-应用管理--打开对应的应用 中获取  */
    public static String app_key = "3438a70b8de35954e756fc7c3785b85f";

    /** 通过后台管理中心-开放平台-开发者资料--打开对应的应用 中获取  */
    public static String app_secret = "444878d707652665c9f00efcca910552";

    public static String HOST = "http://ip:20600/papi/openapi";

    public static String RESPONSE_TYPE = "code";

    public static String STATE = "test1234";

    public static String GRANT_TYPE = "authorization_code";
    /**
     * 1、获取code信息
     * @return
     */
    public static String getCode(){
        String code = "";
        try {
            String url = HOST + "/oauth2/authorize?corpid=%s&response_type=%s&state=%s";
            String result = HttpRequest.get(String.format(url,CORPID,RESPONSE_TYPE,STATE)).execute().body();

            JSONObject resultObj = JSON.parseObject(result);
            String errcode = resultObj.getString("errcode");
            if("0".equals(errcode)){
                code = resultObj.getString("code");
            }
        }catch (Exception e){}
        return code;
    }
    /**
     * 1、获取AccessToken信息
     * @return
     */
    public static String getAccessToken(String code){
        String accessToken = "";
        try {
            String url = HOST + "/oauth2/access_token";
            String result = HttpRequest.post(url).form("app_key", app_key).form("app_secret", app_secret).form("grant_type", GRANT_TYPE).form("code", code)
                    .execute().body();
            JSONObject resultObj = JSON.parseObject(result);
            String errcode = resultObj.getString("errcode");
            if("0".equals(errcode)){
                accessToken = resultObj.getString("accessToken");
            }
        }catch (Exception e){}

        return accessToken;
    }
    public static void main(String[] args) {
        String code = getCode();
        System.out.println("1::getCode==>" + code);

        String accessToken = getAccessToken(code);
        System.out.println("2::getAccessToken==>" + accessToken);
    }
}