# 开发文档阅读说明

有数开放了丰富的服务端接口能力，开发者可以借助这些接口能力，实现企业系统与有数的集成打通。

调用有数接口时，需要使用HTTPS协议、JSON数据格式、UTF8编码，访问域名为https://open-ushu.hillinsight.tech。POST请求请在HTTP Header中设置 Content-Type:application/json。

接口说明格式如下：

请求方式：GET/POST（HTTPS）
请求地址：https://open-ushu.hillinsight.tech/cgi/token/get?app_key=KEY&app_secret=SECRET
请求包体：
...
参数说明：
...
返回结果：
...

1. 请求方式，标明接口调用的HTTP方法，区分HttpGet/HttpPost请求。所有的请求都为HTTPS协议。
2. 请求地址，接口的请求地址。
3. 请求包体/参数说明，标明请求参数示例及说明，参数说明包括字段含义、取值范围。
4. 返回结果/参数说明，标明返回参数示例及及说明。所有接口的返回结果里都有error_code、message。开发者需根据error_code是否为0判断是否调用成功（error_code意义请见全局错误码）。而message仅作参考，后续可能会有变动，因此不可作为是否调用成功的判据。

# 接口调用流程

1. 获取access_token，参考文档
2. 缓存和刷新access_token。 开发者需要缓存access_token，用于后续接口的调用（注意：不能频繁调用gettoken接口，否则会受到频率拦截）。当access_token失效或过期时，需要重新获取。
3. 调用具体的业务接口