简述
- 短信服务(Short Message Service)是阿里云为用户提供的一种通信服务的能力。
- 支持快速发送短信验证码、短信通知等。 三网合一专属通道,与工信部携号转网平台实时互联。电信级运维保障,实时监控自动切换,到达率高达99%。
- 短信服务API提供短信发送、发送状态查询、短信批量发送等能力,在短信服务控制台上添加签名、模板并通过审核之后,可以调用短信服务API完成短信发送等操作。
申请服务
- 注册阿里云找到短信服务点击进行开通
- 根据接收短信的区域选择国内消息或者国际消息,进行相应的签名和模板申请。
签名申请中签名一栏对应消息头,模板申请中模板内容对应消息体内容,由于官方提示文档已经很全面,此处不进行赘述。
不同功能模板中的动态变量需要按照指定格式进行填写,或者你可以点击常用模板库,进行选择模板再次修改内容。
- 申请
AccessKey
获得阿里云账户的操控权限
为了安全考虑这里推荐使用子用户
AccessKey
,给予最小对应权限即可。
请记住申请完子用户
AccessKey
后不要立即关闭窗口,先将申请的AccessKeySecret
进行保存,因为关闭后,再也没办法进行查看AccessKeySecret
,只能查看到AccessKeyId
。
- 准备工作完成后,在短信服务的快速学习栏中,可以使用创建的签名和模板进行发送测试看看效果,没问题后,再进行编码操控。(如提示以下错误码,是因为余额不足,需要先对账户进行充值😂)
Java 编码
官网文档地址,这里使用新版的api进行操控
Maven项目架包依赖如下:
<!--阿里云短信sdk-->
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.1.0</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-dysmsapi</artifactId>
<version>2.0.0</version>
</dependency>
工具类如下:
public class SMSUtils {
private static final String ACCESSKEYID = "你的对应AccessKeyId";
private static final String ACCESSKEYSECRET = "你的对应AccessKeySecret";
/**
* 我所申请的模板号,请对应更改模板号
*/
public static final String VALIDATE_CODE = "SMS_1814****0";
/**
* 发送短信
*
* @param templateCode 短信模板ID。请在控制台模板管理页面模板CODE一列查看。
* @param phoneNumbers 接收短信的手机号码。国内短信:11位手机号码。
* @param authCode 验证码
*/
public static void sendShortMessage(String templateCode, String phoneNumbers, String authCode) {
DefaultProfile profile = DefaultProfile.getProfile( "cn-hangzhou", ACCESSKEYID, ACCESSKEYSECRET );
IAcsClient client = new DefaultAcsClient( profile );
CommonRequest request = new CommonRequest();
request.setMethod( MethodType.POST );
request.setDomain( "dysmsapi.aliyuncs.com" );
request.setVersion( "2017-05-25" );
request.setAction( "SendSms" );
request.putQueryParameter( "RegionId", "cn-hangzhou" );
request.putQueryParameter( "PhoneNumbers", phoneNumbers );
request.putQueryParameter( "SignName", "短信标签" );//短信签名名称。请在控制台签名管理页面签名名称一列查看。
request.putQueryParameter( "TemplateCode", templateCode );
request.putQueryParameter( "TemplateParam", "{\"code\":\"" + authCode + "\"}" ); //拼接成官网指定格式
try {
CommonResponse response = client.getCommonResponse( request );
System.out.println( response.getData() ); //回显消息
} catch (ServerException e) {
e.printStackTrace();
} catch (ClientException e) {
e.printStackTrace();
}
}
}
阿里短信工具类测试如下:
public class SMSUtilsTest {
@Test
public void sendShortMessage() {
//接收短信的手机号
String phoneNumber = "12345678901";
//随机4位数验证码,我这里使用的hutool随机数工具类进行生成
String code = RandomUtil.randomNumbers( 4 );
//发送测试
SMSUtils.sendShortMessage( SMSUtils.VALIDATE_CODE, phoneNumber, code );
}
}
成功回显:
关于上述代码更加详细的内容请自行查阅官方手册,本文章主要梳理大致流程