本文介绍 EDAS Open API 的接入步骤以及注意事项。
1、获取 SDK
EDAS Open API 的 Java SDK 可以通过选择对应的版本进行下载安装(目前暂时在试用期,后续版本稳定后会发布到 Maven 官方仓库):
版本 2.12.3: http://edas.oss-cn-hangzhou.aliyuncs.com/edas-open-api-sdk/2017-02-11/edas-open-api-sdk-2.12.3.jar
历史版本
- 版本 2.10.1: http://edas.oss-cn-hangzhou.aliyuncs.com/edas-open-api-sdk/2016-06-23/edas-open-api-sdk-2.10.1.jar
- 版本 2.12.3: http://edas.oss-cn-hangzhou.aliyuncs.com/edas-open-api-sdk/2017-02-11/edas-open-api-sdk-2.12.3.jar
2、获取项目依赖 SDK
[backcolor=transparent]使用 Maven 的客户
通过下面命令将 JAR 包添加到本地仓库:[backcolor=transparent]
mvn install[backcolor=transparent]
:[backcolor=transparent]
install[backcolor=transparent]
-[backcolor=transparent]
file [backcolor=transparent]
-[backcolor=transparent]
Dfile[backcolor=transparent]
=[backcolor=transparent]
$[backcolor=transparent]
{[backcolor=transparent]
/path/[backcolor=transparent]
to[backcolor=transparent]
/[backcolor=transparent]
jarfile[backcolor=transparent]
}[backcolor=transparent]
- [backcolor=transparent]-[backcolor=transparent]DgroupId[backcolor=transparent]=[backcolor=transparent]com[backcolor=transparent].[backcolor=transparent]alibaba[backcolor=transparent].[backcolor=transparent]edas [backcolor=transparent]-[backcolor=transparent]DartifactId[backcolor=transparent]=[backcolor=transparent]edas[backcolor=transparent]-[backcolor=transparent]open[backcolor=transparent]-[backcolor=transparent]api[backcolor=transparent]-[backcolor=transparent]sdk
- [backcolor=transparent]-[backcolor=transparent]Dversion[backcolor=transparent]=[backcolor=transparent]$[backcolor=transparent]{[backcolor=transparent]VERSION[backcolor=transparent]}[backcolor=transparent] [backcolor=transparent]-[backcolor=transparent]Dpackaging[backcolor=transparent]=[backcolor=transparent]jar
通过 Maven 坐标:
-
[backcolor=transparent]
<parent>
- [backcolor=transparent]<groupId>[backcolor=transparent]com.alibaba.edas[backcolor=transparent]</groupId>
- [backcolor=transparent]<artifactId>[backcolor=transparent]edas-open-api-sdk[backcolor=transparent]</artifactId>
- [backcolor=transparent]<version>[backcolor=transparent]${VERSION}[backcolor=transparent]</version>
- [backcolor=transparent]</parent>
[backcolor=transparent]非 Maven 的客户
请直接将 JAR 包添加到项目工程中。
3、获取阿里云 Access Key ID 和 Access Key Secret
Access Key ID:访问阿里云产品使用的账号的 Access Key ID,由阿里云官网获得,调用时传入给 EDAS 后台用于身份验证,调用 EDAS Open API 只能操作对应账号下的资源。
Access Key Secret:访问阿里云产品使用的账号的 Access Key ID 秘钥,由阿里云官网获得,调用时传入,用于计算访问请求的签名。
登录阿里云,您可以在
https://ak-console.aliyun.com/#/accesskey 链接上查看自己的 Access Key ID 和 Access Key Secret。如果没有,请先创建。如果有多个 AK、SK,那么尽量使用最后创建的那个。
4、获取 EDAS 环境的调用 URL
公共云用户:
http://edas.console.aliyun.com/api
专有云用户请咨询对应的业务架构师。
5、初始化 EDAS Open API SDK Client
请按以下方式进行初始化。
- [backcolor=transparent]EdasApiClient[backcolor=transparent] edasApiClient [backcolor=transparent]=[backcolor=transparent]
- [backcolor=transparent] [backcolor=transparent]new[backcolor=transparent] [backcolor=transparent]EdasApiClient[backcolor=transparent]([backcolor=transparent]"http://edas.console.aliyun.com/api"[backcolor=transparent],[backcolor=transparent] AK[backcolor=transparent],[backcolor=transparent] SK[backcolor=transparent]);
- [backcolor=transparent]// 这里的 AK、SK 需要替换成上文获取到的 AK、SK