API调用

在网关中的API调用有一般有三种方式:

使用API文档提供的SDK调用

在服务目录中,找到想要调用的API,进入文档查看:

根据开发技术选择对应的SDK:

下载SDK后,加入到自己的工程中即可使用。

这里以JAVA为例,下载JAVA的SDK。

下载后的压缩包是一个maven的标准工程:

直接使用maven安装到本地maven库:

$> mvn install

然后添加maven依赖即可。

JAVA示例:

public class Main {
    public static void main(String[] args) throws ApiException {
        DefaultApi api = new DefaultApi();
        api.getApiClient().setAccessToken("f39fb665-9d39-4ab4-bdaa-67cce69ab1c0");
        User user = api.idGet("1");
        System.out.println("id:"+user.getId());
        System.out.println("name:"+user.getName());
        System.out.println("loginId:"+user.getLoginId());
    }
}

输出结果:

id:1
name:张三
loginId:zhangsan

注意:对于非匿名的API,需要先获取访问令牌(access token)并设置到DefaultApi对象中,访问令牌的获取请参考统一认证

自主开发调用

网关上的API都允许使用自主开发的方式调用。

自主开发主要就是使用http请求API地址,并且设置对应的参数即可。

自主开发使用原生javascript调用api示例:

var xmlhttp = new XMLHttpRequest();
xmlhttp.onreadystatechange = callback;
xmlhttp.open("GET", "https://developer.bingosoft.net:12100/callapi/1", true);
xmlhttp.setRequestHeader("Authorization", "Bearer f39fb665-9d39-4ab4-bdaa-67cce69ab1c0");
xmlhttp.send();
function callback() {
    if (xmlhttp.readyState == 4 && xmlhttp.status == 200) {
        console.log(xmlhttp.response);
    }
}

控制 台打印结果:

{"id":"1","name":"张三","loginId":"zhangsan"}

注: 这里是示例代码和结果是在chrome上运行得到的,不保证在所有浏览器上兼容。

使用第三方框架调用

使用第三方开发框架调用的话,请按照OAuth2标准协议调用API接口,具体用法自行参考第三方框架文档。

上一篇:授权申请 下一篇:平台API