SDK说明#
为简化ISV调用接口传参,提供sdk上传文件到oss服务SDK提供了结构化的API请求入参,对API调用提供了公共调用结构化封装。
SDK提供了完整的访问凭证(access_token)生命周期管理能力,无需开发者自己获取并刷新访问凭证。
目前我们仅提供了Java语言的SDK,核心文件edf-agg-sdk.jar,其他语言后续提供支持。在使用SDK的过程中,如果遇到问题,请联系我们的客服。SDK调用#
引入SDK#
<dependency>
<groupId>io.github.qixiangyun</groupId>
<artifactId>edf-agg-sdk</artifactId>
<version>1.0.24</version>
</dependency>
SDK调用#
参考以下代码,使用获取的appKey、appSecret初始化sdk AggOpenAPI aggOpenAPI = new AggOpenAPI(apiHost, appKey, appSecret);
| 参数名称 | 参数类型 | 说明 |
|---|
| apiHost | String | 对接地址 |
| appKey | String | 分配的账号 |
| appSecret | String | 分配的秘钥 |
上传文件示例,返回的objectId为最终需要业务使用的参数#
AggOpenAPI aggOpenAPI = new AggOpenAPI(apiHost, appKey, appSecret);
aggOpenAPI.setSocketTimeout(45000);
aggOpenAPI.setConnectTimeout(3000);
String objectId = aggOpenAPI.uploadFile(new File("D:\\1.pdf"));
项目使用示例#
注: AggOpenAPI 处理了 access token 的缓存,请保持单例调用,不要多次实例化
@Bean
public AggOpenAPI getOpenApi()
{
AggOpenAPI aggOpenAPI = new AggOpenAPI(apiHost, appKey, appSecret);
aggOpenAPI.setSocketTimeout(45000);
aggOpenAPI.setConnectTimeout(3000);
return aggOpenAPI;
}
@Autowired
AggOpenAPI openApi;
public void uploadFile()
{
String objectId = openApi.uploadFile(newFile("D:\\1.pdf"));
}