集成开发步骤
准备:
第1步:授权文件下载。
第2步:下载SDK。
Java SDK ,建议JDK版本使用JDK8
C# SDK ,支持.NET Core和.NET Framework(版本不能低于.NET Framework 4.5)
第三方系统使用时,需要将我们提供的jar包、dll文件导入至相应的工程中。
授权验证:
- 第3步、第4步:通过SDK创建客户端实例,并加载授权文件,通过验证后,即可获得可以访问具备GYS系统数据权限的客户端,该客户端的数据访问范围在授权文件中进行了限制。 详见 Java版的Demo C#版的Demo
拼接请求地址
GYS系统通过http提供对外数据接口,每一个类型的数据接口均对应着一个网址。完整的示例网址如下图所示,它包含3个部分:
GYS系统地址hostAddress:每一个授权文件,均包含有GYS系统地址的信息(例如:https://xmgl.glodon.com ),必须通过SDK提供的接口函数获取,第三方不要自己设置GYS系统地址,否则当平台地址设置错误/平台地址发生变化的时候会出现认证失败、获取不到数据等情况;
接口请求地址apiURI:每个接口均对应着一个接口请求地址。GYS系统提供的接口详见开放接口;
请求参数requestParams:用来设定某类数据请求范围的参数。
- 第5步~第7步,完成请求地址的拼接。
发送请求数据
第8步,准备请求数据。由第三方完成数据的准备,数据的格式需要符合接口数据格式要求。
第9步,发送请求。SDK支持post或者get请求。详细的使用可以参见SDK示例。
处理请求返回结果
第9步进行数据请求之后,从获取的返回数据中能够判断是否推送/获取成功,SDK提供了是否请求成功的判断函数。
请求成功
- 第10步,处理数据。第三方系统根据需求,对获取的数据进行持久化、分析汇总等处理。
请求失败
- 第11步,请求失败时,根据返回结果提示信息排查失败原因,并自行处理。必要时可联系广联达开发人员协助排查问题。