所有开发者使用平台提供的服务之前,均需要获得平台认证的访问身份,该身份可以让您监控应用对平台API的调用频率, 方便管理维护应用,同时也可以保证平台可以实时和您取得联系。
获取访问账号首先需要注册成为平台开发者(如果您尚未注册,请您点击此处 注册成为应用开发者), 然后创建自己的应用(如果您尚未创建应用,请点击此处 页面创建应用), 之后便可凭借平台分配的应用id和secret去申请使用平台提供的服务。
数据开放平台提供的服务分为默认服务和高级服务,对于默认服务,应用开发者无需申请便可以使用,对于高级服务, 应用开发者可以点击此处 申请使用服务,已申请的高级服务需要由系统管理员审核(服务提供者)审核,审核通过后,即可使用相应的服务。
数据开放平台提供的服务均可以通过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
本示例应用在开发过程中需调用“模板测试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();