集成开发步骤

准备:

  • 第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个部分:

1571205690069

GYS系统地址hostAddress:每一个授权文件,均包含有GYS系统地址的信息(例如:https://xmgl.glodon.com ),必须通过SDK提供的接口函数获取第三方不要自己设置GYS系统地址,否则当平台地址设置错误/平台地址发生变化的时候会出现认证失败、获取不到数据等情况;

接口请求地址apiURI:每个接口均对应着一个接口请求地址。GYS系统提供的接口详见开放接口;

请求参数requestParams:用来设定某类数据请求范围的参数。

  • 第5步~第7步,完成请求地址的拼接。

发送请求数据

  • 第8步,准备请求数据。由第三方完成数据的准备,数据的格式需要符合接口数据格式要求。

  • 第9步,发送请求。SDK支持post或者get请求。详细的使用可以参见SDK示例。

处理请求返回结果

第9步进行数据请求之后,从获取的返回数据中能够判断是否推送/获取成功,SDK提供了是否请求成功的判断函数。

请求成功

  • 第10步,处理数据。第三方系统根据需求,对获取的数据进行持久化、分析汇总等处理。

请求失败

  • 第11步,请求失败时,根据返回结果提示信息排查失败原因,并自行处理。必要时可联系广联达开发人员协助排查问题。

results matching ""

    No results matching ""