使用 Java 调用阿里云短信服务

简述

• 短信服务（Short Message Service）是阿里云为用户提供的一种通信服务的能力。
• 支持快速发送短信验证码、短信通知等。 三网合一专属通道，与工信部携号转网平台实时互联。电信级运维保障，实时监控自动切换，到达率高达99%。
• 短信服务API提供短信发送、发送状态查询、短信批量发送等能力，在短信服务控制台上添加签名、模板并通过审核之后，可以调用短信服务API完成短信发送等操作。

申请服务

1. 注册阿里云找到短信服务点击进行开通

短信服务界面

2. 根据接收短信的区域选择国内消息或者国际消息，进行相应的签名和模板申请。

签名和模板

参数解释

签名申请中签名一栏对应消息头，模板申请中模板内容对应消息体内容，由于官方提示文档已经很全面，此处不进行赘述。

模板注意事项

不同功能模板中的动态变量需要按照指定格式进行填写，或者你可以点击常用模板库，进行选择模板再次修改内容。

3. 申请AccessKey获得阿里云账户的操控权限

申请

创建Accesskey

为了安全考虑这里推荐使用子用户AccessKey，给予最小对应权限即可。

授予短信权限

得到权限

请记住申请完子用户AccessKey后不要立即关闭窗口，先将申请的AccessKeySecret进行保存，因为关闭后，再也没办法进行查看AccessKeySecret，只能查看到AccessKeyId。

4. 准备工作完成后，在短信服务的快速学习栏中，可以使用创建的签名和模板进行发送测试看看效果，没问题后，再进行编码操控。(如提示以下错误码，是因为余额不足，需要先对账户进行充值)

发送测试

Java 编码

官网文档地址，这里使用新版的api进行操控

Maven项目架包依赖如下：

 
    com.aliyun
    aliyun-java-sdk-core
    4.1.0


    com.aliyun
    aliyun-java-sdk-dysmsapi
    2.0.0
      

工具类如下：

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

成功回显：

测试通过

关于上述代码更加详细的内容请自行查阅官方手册，本文章主要梳理大致流程