阿里云短信服务使用简介

笔者最近的SpringBoot项目中使用到了阿里云的短信服务,在此做些总结。

阿里云短信服务官方指导教程:https://help.aliyun.com/document_detail/59210.html?spm=a2c4g.11174283.4.1.n6Pa55

步骤:

1、注册阿里云账号通过实名认证

2、开通短信服务(开通免费)

开通后可在控制台短信服务栏中查看


3、创建Access Key,获取Access Key ID 和 Access Key Secret(具体看阿里云官方教程)

Access Key用于在程序中调用阿里云的服务API,个人理解相当于账号密码,用于认证个人信息的(程序中会用到)。可以创建多个Access Key,但Access Key具体内容只能在创建初期查看,之后是无法查看的,因此需要及时下载到本地。

4、创建短信签名和短信模板

    短信签名一般用于标记公司名或者是具体的业务,它会以下的形式出现在短信中:

[短信签名] 短信内容....

    短信模板描述了短信的具体内容,可以提供变量来替代具体的数据,程序中会以JSON的形式向短信模板提供变量。

注意:短信签名和短信模板创建后都需要通过审核,审核一般在几个小时内就能完成。


短信模板中的"模板CODE"在程序中会被使用到,通过模板CODE来明确使用哪一个模板。


5、Maven项目中引入阿里云短信服务依赖


6、参看官方Demo编写发送短信的接口

/**
 * 阿里云短信服务机器人
 *
 * @author minghui.y
 * @create 2018-05-16 9:54
 **/
public class SmsRobotTunnel {

    private static final Logger LOGGER = LoggerFactory.getLogger(SmsRobotTunnel.class);

    /**短信API产品名称(短信产品名固定,无需修改)*/
    private static final String PRODUCT = "Dysmsapi";
    /**短信API产品域名(接口地址固定,无需修改)*/
    private static final String DOMAIN = "dysmsapi.aliyuncs.com";
    /**AccessKeyId*/
    private static final String  ACCESSKEYID = "your access key id";
    /**accessKeySecret*/
    private static final String ACCESSKEYSECRET = "your access key secret";
    /**短信签名*/
    private static final String SMSSIGN = "your sms sign";
    /**短信模板CODE*/
    private static final String SMSTEMPLATE0 = "SMS_xxxxxxx";
    private static final String SMSTEMPLATE1 = "SMS_xxxxxxx";

    /**
     * 发送短信方法
     * @param contentJSON字串,替代短信模板中的变量
     * @param phones:可以使多个手机号,以逗号分隔
     * @return:发送成功则返回true
     */
    public static boolean send(String content, String phones, SmsBizType bizType) {

        //可自助调整超时时间
        System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");

        try {
            //初始化acsClient,暂不支持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();
            //必填:待发送手机号
            request.setPhoneNumbers(phones);
            //必填:短信签名
            request.setSignName(SMSSIGN);
            //必填:短信模板
            String templcateCode = null;
            switch (bizType) {
                case SMS_CREATE_SERVICE:
                    templcateCode = SMSTEMPLATE0;
                    break;
                case SMS_PROCESS_SERVICE:
                    templcateCode = SMSTEMPLATE1;
                    break;
                default:
                    templcateCode = SMSTEMPLATE0;
                    break;
            }
            request.setTemplateCode(templcateCode);
            //可选:模板中的变量替换JSON,如模板内容为"亲爱的${name},您的验证码为${code}",此处的值为
            request.setTemplateParam(content);


            SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
            //解析短信响应结果
            if(sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) {
                //请求成功
                return true;
            }
        } catch (Exception e) {
            LOGGER.error("短信发送服务异常!", e);
        }

        return false;
    }

}

以上代码有几处需要根据你的实际情况修改:

1、AccessKeyID和AccessKeySecret

2、短信签名(直接写内容,例如短信签名是"abc",此处就是"abc")

3、短信模板CODE,可以有多个,可以存储到Map中根据不同的业务场景选择不同的短信模板

4、send方法的三个参数

      content:json格式的字符串,用于替代短信模板中的变量

       phone:手机号码字符串,可以是以逗号分隔的多个手机号

       bizType:自定义的一个枚举,用来根据场景选择短信模板

7、收到的短信效果:





版权声明:本文为SomeoneMH原创文章,遵循CC 4.0 BY-SA版权协议,转载请附上原文出处链接和本声明。