阿里云短信服务(JAVA)

Posted fenjyang

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了阿里云短信服务(JAVA)相关的知识,希望对你有一定的参考价值。

一,前言

? 短信验证码想必大家都不陌生,在很多网站,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)

四,总结

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

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

以上是关于阿里云短信服务(JAVA)的主要内容,如果未能解决你的问题,请参考以下文章

请问 哪有阿里云 短信服务 api 请求签名PHP教程

阿里云短信服务(JAVA)

java开通短信验证功能详解

阿里云短信验证

JAVA实现《阿里云发送短信验证码以及短信通知》

阿里云短信 javasdk 需要下哪些