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"));
- }