阿里云短信服务（JAVA）

Posted 2022-07-16 fenjyang

一，前言

? 短信验证码想必大家都不陌生，在很多网站，APP中都有使用到。比如登录，注册，身份校验等场景。不过通常情况下，短信服务都是外包给第三方公司的，接下来向大家分享如何使用阿里的短信服务。

二，云通信

? 阿里云官网：https://www.aliyun.com/

? 忘记说了，没有账号的可以直接使用阿里旗下的任何一款账号进行登录，支付宝，淘宝，钉钉等都可以，或者也可以单独进行注册，这里就不再讲述如何注册了。

? 登录成功以后，首页如下，在上方搜索框中搜索短信服务：

?

? 1，点击短信服务控制台，如图：

?

? 2，点击快速学习。

?

? 显示对号表示已经学习完成，如果是初次使用，可依此点击上面的5个选项，按照提示完成操作即可。

? 补充一点，使用阿里短信服务在账户中是必须要有余额，也就是先充值再消费。如图点击充值即可：

?

? 3，以上步骤完成以后，在左侧目录点击国内消息。首先进行签名管理，然后添加模板管理。
切记，签名管理通过后产生的AK一定要保存好，后期调用接口会用到。

?

? 到这里为止，前期都是基本的准备工作，可能有些细节问题没有描述到，但是按照官网的指示也基本差不多。然后再去看官网提供的API接口文档说明。

三，API学习

3.1，基本参数介绍

? 阿里短信API提供多种编程语言的DEMO，可以根据自己的需要进行选择。

? 其实阿里短信服务的API介绍的非常详细，从上图中可以看出，除了可以单独给用户发送短信，还支持批量发送，以及短信详情查询。首先我们可以先了解如何单独给用户发送验证码，请看下图的基本参数：

?

? 以上３个参数是调用API必须要填写的，第一个参数为手机号，第二个参数为签名。签名就是之前说过的，申请签名通过后的签名名称。而最后一个是模板代码，同样在上面介绍过模板申请通过后，会产生一个模板CODE。

3.2，引入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>1.1.0</version>
</dependency>

3.3，示例代码(官网提供)

//设置超时时间-可自行调整
   System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");
        //初始化ascClient需要的几个参数
        final String product = "Dysmsapi";//短信API产品名称（短信产品名固定，无需修改）
        final String domain = "dysmsapi.aliyuncs.com";//短信API产品域名（接口地址固定，无需修改）
        //替换成你的AK
        //final String accessKeyId = "yourAccessKeyId";//你的accessKeyId,参考本文档步骤2
        // final String accessKeySecret = "yourAccessKeySecret";//你的accessKeySecret，参考本文档步骤2
        //初始化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);
        //1，必填:待发送手机号。支持以逗号分隔的形式进行批量调用，批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式；发送国际/港澳台消息时，接收号码格式为国际区号+号码，如“85200000000”
        request.setPhoneNumbers("");
        //2，必填:短信签名-可在短信控制台中找到
        request.setSignName("");
        //3，必填:短信模板-可在短信控制台中找到，发送国际/港澳台消息时，请使用国际/港澳台短信模版
        request.setTemplateCode("");
        //可选:模板中的变量替换JSON串,如模板内容为"亲爱的$name,您的验证码为$code"时,此处的值为
        //友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含\\r\\n的情况在JSON中需要表示成\\\\r\\\\n,否则会导致JSON在服务端解析失败
        request.setTemplateParam("");
        SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);

        // 判断是否发送成功
        if (sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) 
            //请求成功
            System.out.println("返回的状态码：" + sendSmsResponse.getCode());
            System.out.println("返回的信息：" + sendSmsResponse.getMessage());
        

? 将以上的3个参数填成自己的，启动工程便可以成功发送短信。

? 结果如图所示：

?

    ![](https://img2018.cnblogs.com/blog/1655301/201908/1655301-20190815203410419-327235263.jpg)

四，总结

? 是不是调用很简单，但是在真正的项目中还是要进一步优化，尤其在分布式项目中调用。比如将参数抽取到配置文件，及抽取成工具类等。

? 最后由于时间仓促只是简短的记录，有很多细节没有为大家分享到，所以如果遇到什么问题可以在下方留言，看到后会第一时间回复。感谢阅读！