Java SDK

1. 前提条件

在安装和使用Java SDK前,确保您已经:
  • 安装Java环境。云通讯 Java SMS SDK要求使用JDK1.7或更高版本
  • 已经注册云通讯账号且已获取auth token,并已开通应用

2. Java SDK安装方式

  • 添加maven依赖
  • 在集成开发环境中导入JAR文件
2.1 添加maven依赖
如果您使用Maven管理Java项目,可以通过在pom.xml文件中添加Maven依赖安装云通讯 Java SMS SDK。您可以在Maven库中查看Maven依赖信息。
  • <dependency>
  •     <groupId>com.cloopen</groupId>
  •     <artifactId>java-sms-sdk</artifactId>
  •     <version>1.0.4</version>
  • </dependency>
2.2 在集成开发环境中导入JAR文件
无论您使用Eclipse还是IntelliJ作为集成开发环境,都可以通过导入 java-sms-sdk JAR文件的方式安装云通讯 Java SMS SDK

3. Java SDK GitHub地址

4. 调用示例

  • //生产环境请求地址:app.cloopen.com
  •     String serverIp = "app.cloopen.com";
  •     //请求端口
  •     String serverPort = "8883";
  •     //主账号,登陆云通讯网站后,可在控制台首页看到开发者主账号ACCOUNT SID和主账号令牌AUTH TOKEN
  •     String accountSId = "accountSId";
  •     String accountToken = "auth token";
  •     //请使用管理控制台中已创建应用的APPID
  •     String appId = "appId";
  •     CCPRestSmsSDK sdk = new CCPRestSmsSDK();
  •     sdk.init(serverIp, serverPort);
  •     sdk.setAccount(accountSId, accountToken);
  •     sdk.setAppId(appId);
  •     sdk.setBodyType(BodyType.Type_JSON);
  •     String to = "1352*******";
  •     String templateId= "templateId";
  •     String[] datas = {"变量1","变量2","变量3"};
  •     String subAppend="1234";  //可选 扩展码,四位数字 0~9999
  •     String reqId="fadfafas";  //可选 第三方自定义消息id,最大支持32位英文数字,同账号下同一自然天内不允许重复
  •     //HashMap<String, Object> result = sdk.sendTemplateSMS(to,templateId,datas);
  •     HashMap<String, Object> result = sdk.sendTemplateSMS(to,templateId,datas,subAppend,reqId);
  •     if("000000".equals(result.get("statusCode"))){
  •         //正常返回输出data包体信息(map)
  •         HashMap<String,Object> data = (HashMap<String, Object>) result.get("data");
  •         Set<String> keySet = data.keySet();
  •         for(String key:keySet){
  •             Object object = data.get(key);
  •             System.out.println(key +" = "+object);
  •         }
  •     }else{
  •         //异常返回输出错误码和错误信息
  •         System.out.println("错误码=" + result.get("statusCode") +" 错误信息= "+result.get("statusMsg"));
  •     }