1、序言
业务中使用短信服务,主要使用了腾讯云和阿里云,价格和使用方式基本一样,但是推荐使用腾讯云,因为会送200条(穷鬼推荐)。
2、步骤
2.1 地址:
2.2 需要申请的参数
- 密钥id(腾讯云:secretId,阿里云:accessKeyId)
- 密钥(腾讯云:secretKey,阿里云:accessKeySecret)
- 短信签名(腾讯云:sign,阿里云:signName)
- 短信模板id(腾讯云:templateID,阿里云:templateCode)
- appid(腾讯云专用:sdkAppid)
3、腾讯云
2.1 密钥申请(包括密钥和密钥id)
链接:腾讯云短信密钥申请
此处没有审核时间,会生成secretId和secretKey
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sQDB9WRa-1620495052115)(http://www.lichuan.cool/images/blog/2020/08/密钥.png “密钥申请”)]
2.2 短信签名申请
链接:腾讯云短信签名申请
一般两个小时能通过审核,开发需要用到短信签名内容
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-FVYpk1BU-1620495052120)(http://www.lichuan.cool/images/blog/2020/08/短信签名.png “腾讯云短信签名申请”)]
2.3 短信模板申请
链接:腾讯云短信模板申请
一般两个小时能通过审核(自定义模板需要注意格式,不然很容易不能通过审核),审核通过后需要使用模板ID
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-64JDRTt5-1620495052121)(http://www.lichuan.cool/images/blog/2020/08/短信模板.png “腾讯云短信模板”)]
2.4 appid申请
链接:appid申请
此处没有审核时间,需要使用到appid
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-8SNBNd2T-1620495052123)(/images/blog/2020/08/appid.png “申请appid”)]
到这里基本申请完毕,开始进入开发阶段
2.5 官方文档和实例代码
文档:腾讯云短信文档
使用腾讯云短信的小伙伴需要注意,腾讯云的文档更新不及时,示例代码也不一定正确,文档仅供参考
但是腾讯云提供了Open API Explorer在线测试工具(阿里云也有),点击相应的应用会生成代码,直接复制到自己的代码里就可以了。Explorer
2.6 正式使用
选择使用SDK开发,文档地址java SDK文档
2.6.1 添加maven依赖
<dependency>
<groupId>com.tencentcloudapi</groupId>
<artifactId>tencentcloud-sdk-java</artifactId>
<version>3.1.62</version><!-- 注:这里只是示例版本号,请获取并替换为 最新的版本号 -->
</dependency>
2.6.2 发送短信
@Service
public class TencentSendSms {
@Autowired
private TencentDySmsParam param;
private static final Logger log = LoggerFactory.getLogger(TencentSendSms.class);
String ok = "Ok";
public String send(String[] phoneArr, String[] templateParams) {
StringBuilder result = new StringBuilder();
try{
Credential cred = new Credential("AKIDwmQq9FWmFTQp0vAx6ycyKPvA8sNchaSE", "4wYtyoeGlGWXJrCYEhvtd8g07pHWXHlj");
HttpProfile httpProfile = new HttpProfile();
httpProfile.setEndpoint("sms.tencentcloudapi.com");
ClientProfile clientProfile = new ClientProfile();
clientProfile.setHttpProfile(httpProfile);
SmsClient client = new SmsClient(cred, "ap-nanjing", clientProfile);
SendSmsRequest req = new SendSmsRequest();
// 添加电话号码
req.setPhoneNumberSet(this.toPullPhoneArr(phoneArr));
// 添加短信签名
req.setSign(param.getSign());
// 添加模板编号
req.setTemplateID(param.getTemplateID());
// 添加sdkAppid
req.setSmsSdkAppid(param.getSdkAppid());
// 设置模板参数
req.setTemplateParamSet(templateParams);
SendSmsResponse resp = client.SendSms(req);
result = new StringBuilder(SendSmsResponse.toJsonString(resp));
System.out.println("返回结果:" + result);
// 返回code,OK就是成功
SendStatus[] sendStatusSet = resp.getSendStatusSet();
for (SendStatus status : sendStatusSet) {
if (ok.equals(status.getCode())) {
log.info(status.getPhoneNumber() + "短信发送成功!");
result.append("1");
} else {
log.error(status.getPhoneNumber() + "短信发送失败!");
result.append("0");
}
}
} catch (TencentCloudSDKException e) {
log.error("短信发送异常");
System.out.println(e.toString());
}
return result.toString();
}
public String[] toPullPhoneArr(String[] phoneArr) {
return Arrays.stream(phoneArr).map(phone -> "+86" + phone).toArray(String[]::new);
}
}
4、阿里云
申请方式和使用方式与腾讯云没什么差别,文档地址
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.5.1</version>
</dependency>
@Service
public class AliSendSms {
@Autowired
private AliDySmsParam dySms;
private static final Logger log = LoggerFactory.getLogger(AliSendSms.class);
public String send(String phone) throws ClientException {
//设置超时时间-可自行调整
System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
System.setProperty("sun.net.client.defaultReadTimeout", "10000");
//初始化ascClient需要的几个参数
//短信API产品名称(短信产品名固定,无需修改)
final String product = "Dysmsapi";
//短信API产品域名(接口地址固定,无需修改)
final String domain = "dysmsapi.aliyuncs.com";
//替换成你的AK
final String accessKeyId = dySms.getAccessKeyId();
//你的accessKeySecret,参考本文档步骤2
final String accessKeySecret = dySms.getAccessKeySecret();
//初始化ascClient,暂时不支持多region(请勿修改)
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId,
accessKeySecret);
DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
IAcsClient acsClient = new DefaultAcsClient(profile);
//组装请求对象
SendSmsRequest request = new SendSmsRequest();
//使用post提交
request.setMethod(MethodType.POST);
//必填:待发送手机号。支持以逗号分隔的形式进行批量调用,批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式;发送国际/港澳台消息时,接收号码格式为国际区号+号码,如“85200000000”
request.setPhoneNumbers(phone);
//必填:短信签名-可在短信控制台中找到
request.setSignName(dySms.getSignName());
//必填:短信模板-可在短信控制台中找到,发送国际/港澳台消息时,请使用国际/港澳台短信模版
request.setTemplateCode(dySms.getTemplateCode());
//可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
//友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含\r\n的情况在JSON中需要表示成\\r\\n,否则会导致JSON在服务端解析失败
//参考:request.setTemplateParam("{\"变量1\":\"值1\",\"变量2\":\"值2\",\"变量3\":\"值3\"}")
request.setTemplateParam("{\"code\":\"123456\"}");
//可选-上行短信扩展码(扩展码字段控制在7位或以下,无特殊需求用户请忽略此字段)
//request.setSmsUpExtendCode("90997");
//可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
// request.setOutId("yourOutId");
//请求失败这里会抛ClientException异常
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
// 请求结果:isv.AMOUNT_NOT_ENOUGH消息账户余额不足
System.out.println("请求结果=" + sendSmsResponse.getCode() + ";消息=" + sendSmsResponse.getMessage());
if(sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) {
//请求成功
log.info(phone + "短信发送成功");
} else {
log.error(phone + "消息发送失败,原因是:" + sendSmsResponse.getMessage());
}
return sendSmsResponse.getMessage();
}
}
如果按照支持逻辑到这一步调用阿里短信服务发送短信,会报一个isv.AMOUNT_NOT_ENOUGH的问题,原因就是没充钱,需要先充钱,不像腾讯云会送短信