文档编辑

欢迎使用智城云开发者工具套件（SDK）。这里向您介绍如何获取智城云Java SDK并开始调用。

使用对象

企业智能云平台开发者 

环境准备

智城云Java SDK需要1.8以上的JDK。

安装SDK

SDK下载地址 智城JAVA SDK

如果您使用Apache Maven来管理Java项目，只需在项目的pom.xml文件加入相应的依赖项即可。您可以在智城云SDK频道中下载各云产品的Maven依赖。

<dependency>
    <groupId>cn.zcyun.xcloud.tools</groupId>
    <artifactId>xcloud-api-sdk</artifactId>
    <version>1.0-SNAPSHOT</version>
</dependency>

无论您使用Eclipse还是IntelliJ作为集成开发环境，都可以通过导入JAR文件的方式安装智城云Java SDK。

Eclipse集成SDK

• 完成以下操作，在Eclipse的项目中安装智城云Java SDK：
• 将下载的xcloud-api-sdk-XXX.jar文件复制到您的项目文件夹中。
• 在Eclipse中打开您的项目，右键单击该项目，单击Properties。
• 在弹出的对话框中，单击Java Build Path > Libraries > Add JARs，添加下载的JAR文件。

单击Apply and Close。

IntelliJ集成SDK

• 完成以下操作，在IntelliJ的项目中安装智城云Java SDK。
• 将下载的xcloud-api-sdk-XXX.jar文件复制到您的项目文件夹中。
• 在IntelliJ中打开您的项目，在菜单栏中单击File > Project Structure。
• 在弹出的对话框中，单击Modules > Dependencies。在出现的列表中单击add > JARs or directories，选择要添加的JAR文件。
  

单击Apply，然后单击OK。

使用SDK

OpenAPI SDK(个人版)

以下这个代码示例向您展示了调用智城云 OpenAPI SDK的3个主要步骤：

• 创建PersonalOpenAPISDK实例并初始化。
• 创建API请求并设置参数。
• 发起请求并处理应答或异常。

事例代码

public class PersonalSDKDemo {
	public static void main(String[] args) throws Exception {
	    // enterpriseId 企业平台ID
		PersonalOpenAPISDK.getInstance().init(enterpriseId);
		// 企业智能平台账号、密码登录 
		JSONObject user = PersonalOpenAPISDK.getInstance().login("<your-acount>", "<your-password>");

		// get请求方式示例
		PersonalOpenAPISDK.getInstance().invokeAPIWithAuth("/v1/user", "get", null, user.getString("openId"));

		// PUT请求方式示例
		JSONObject body = new JSONObject();
		body.put("nickname", "openapi测试修改昵称");
		body.put("sex", "2");
		body.put("birthday", "1986-01-02");
		PersonalOpenAPISDK.getInstance().invokeAPIWithAuth("/v1/user", "PUT", body, user.getString("openId"));
	}
}

enterpriseId 请登陆企业智能云平台在账户中心-账户信息 中查询。如下图

OpenAPI SDK(企业版)

以下这个代码示例向您展示了调用智城云 OpenAPI SDK(企业版)的3个主要步骤：

• 创建BusinessOpenAPISDK实例并初始化。
• 创建API请求并设置参数。
• 发起请求并处理应答或异常。

事例代码

public class BusinessSDKDemo {
	public static void main(String[] args) throws Exception {
		BusinessOpenAPISDK.getInstance().init(applicationId, applicationKey);
		// GET请求方式示例
		BusinessOpenAPISDK.getInstance().invokeAPI("/v1/user/bae5ad877197461aa9be85a62c97338a", "get", null);
		// POST请求方式示例
		JSONObject body = new JSONObject();
		body.put("platformId", 2);
		BusinessOpenAPISDK.getInstance().invokeAPI("/v1/users", "POST", null);
	}
}

名词解释

名词	含义
applicationId	应用ID，每个企业开发者的唯一标识，可以在企业管理平台用户中心中查看，一个企业只有一个应用标识
applicationKey	应用密钥，每个企业开发者的密钥，做请求签名时必须加上的参数