5.2API调用
5.2.1获取api访问账号

所有开发者使用平台提供的服务之前,均需要获得平台认证的访问身份,该身份可以让您监控应用对平台API的调用频率, 方便管理维护应用,同时也可以保证平台可以实时和您取得联系。

获取访问账号首先需要注册成为平台开发者(如果您尚未注册,请您点击此处 注册成为应用开发者), 然后创建自己的应用(如果您尚未创建应用,请点击此处 页面创建应用), 之后便可凭借平台分配的应用id和secret去申请使用平台提供的服务。

5.2.2申请服务

数据开放平台提供的服务分为默认服务和高级服务,对于默认服务,应用开发者无需申请便可以使用,对于高级服务, 应用开发者可以点击此处 申请使用服务,已申请的高级服务需要由系统管理员审核(服务提供者)审核,审核通过后,即可使用相应的服务。

5.2.3使用服务

数据开放平台提供的服务均可以通过Rest方式进行调用,返回结果统一采用JSON格式

环境地址:即调用接口(API)时,都通过访问该地址,来获取该接口需要获取的数据。

正式环境:http://10.110.16.38/devweb/api

示例:模板测试1017分页查询服务(如下图) ,通过查看该服务的信息可知该服务的请求地址为:/cataLog_4cb5bab3365c4e729c6bab94c3d470d4/get_datalist_page/1.0,私有参数必填有:SIZE和START两个参数,然后获取服务所属应用的应用ID和应用密钥。点击 个人中心->应用管理,点击相应的应用即可查看应用ID和应用密钥 分别对应参数client_id和client_secret。本服务所属应用ID为:5657,应用密钥为:d2b4c8dfc78c289ce82cf927a25cc11e

完整http请求地址:

http://10.110.16.38/devweb/api/cataLog_4cb5bab3365c4e729c6bab94c3d470d4/get_datalist_page/1.0?client_id=5657&client_secret=d2b4c8dfc78c289ce82cf927a25cc11e&SIZE=8&START=1

5.2.4具体例子

本示例应用在开发过程中需调用“模板测试1017分页查询服务接口为例,应用已通过申请获得该服务授权。 平台的开放服务接口均通过Rest方式进行调用。

开发者可通过查看服务详细信息,获知服务的请求地址、请求参数、返回参数以及返回数据格式等。

模板测试1017分页查询服务接口详细信息如下:





调用方式如下:

首先需要修改config.properties配置文件中的client_ID,client_SERCRET,baseURL三个属性为当前服务对应的值

//取配置文件中client_ID(应用ID)、client_SERCRET(应用密钥)

String client_ID = Config.getValue("client_ID");

String client_SERCRET = Config.getValue("client_SERCRET");

//定义请求路径包括上下文context和版本号version

String context = "cataLog_4cb5bab3365c4e729c6bab94c3d470d4/get_datalist_page";

String version = "1.0";

//创建调用对象

OpenApi api = new OpenApi(client_ID,client_SERCRET);

// 组装传递参数

PostParameter[] params = new PostParameter[4];

// 说明是客户端的请求

params[0] = new PostParameter("grant_type", "client_credentials");

params[1] = new PostParameter("method", "client");

// 业务参数

params[2] = new PostParameter("SIZE","具体数值");

params[3] = new PostParameter("START","具体数值");

//调用服务得到结果

String result = api.getResponse(context, version, "post", params).toString();