阿里云短信服务(JAVA)

若如初见. 提交于 2019-11-27 10:49:47

一,前言

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

二,云通信

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

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

​ 登录成功以后,首页如下,在上方搜索框中搜索短信服务:

​ 1,点击短信服务控制台,如图:

​ 2,点击快速学习。

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

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

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

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

三,API学习

3.1,基本参数介绍

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

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

​ 以上3个参数是调用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)

四,总结

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

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

易学教程内所有资源均来自网络或用户发布的内容,如有违反法律规定的内容欢迎反馈
该文章没有解决你所遇到的问题?点击提问,说说你的问题,让更多的人一起探讨吧!