短信应用场景
异常通知
注册码
重要操作(银行转账的验证码)的验证码
实现步骤
第一步 注册云通讯账号
云通讯网址](https://www.yuntongxun.com/)
第二步 添加测试号码
可添加三个免费测试号码
第三步 关闭鉴权IP
第四步 创建springboot项目
1. 添加依赖
<!--短信验证-->
<dependency>
<groupId>com.cloopen</groupId>
<artifactId>java-sms-sdk</artifactId>
<version>1.0.3</version>
</dependency>
<dependency>
<groupId>com.google.code.gson</groupId>
<artifactId>gson</artifactId>
<version>2.8.6</version>
</dependency>
2. 拷贝API
import com.cloopen.rest.sdk.BodyType;
import com.cloopen.rest.sdk.CCPRestSmsSDK;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
import java.util.Set;
@RestController
@RequestMapping("/sms")
public class SmsController {
@PostMapping("/send")
public String send(){
//生产环境请求地址:app.cloopen.com
String serverIp = "app.cloopen.com";
//请求端口
String serverPort = "8883";
//主账号,登陆云通讯网站后,可在控制台首页看到开发者主账号ACCOUNT SID和主账号令牌AUTH TOKEN
String accountSId = "8aaf07087bc********f43f1e0612";
String accountToken = "221d7c82ac********6d25e5434b361";
//请使用管理控制台中已创建应用的APPID
String appId = "8aaf07087bc8********be3f440050618";
CCPRestSmsSDK sdk = new CCPRestSmsSDK();
sdk.init(serverIp, serverPort);
sdk.setAccount(accountSId, accountToken);
sdk.setAppId(appId);
sdk.setBodyType(BodyType.Type_JSON);
//定义接收短信的手机号
String to = "185****5825"; //可以填写多个手机号,使用","隔开
//定义模板id,如果没有自定义模板,默认为1,自定义之后为自定义的模板id
String templateId= "1";
//模板中所对应的参数
String[] datas = {"6688","3"}; //表示验证码为6688,3分钟内输入有效
String subAppend="1234"; //可选 扩展码,四位数字 0~9999
String reqId="abe"; //可选 第三方自定义消息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"));
}
return "发送成功";
}
}
3. 注意事项
建议Gson版本号2.8.6,亲测有效!