一,前言
短信验证码想必大家都不陌生,在很多网站,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)
四,总结
是不是调用很简单,但是在真正的项目中还是要进一步优化,尤其在分布式项目中调用。比如将参数抽取到配置文件,及抽取成工具类等。
最后由于时间仓促只是简短的记录,有很多细节没有为大家分享到,所以如果遇到什么问题可以在下方留言,看到后会第一时间回复。感谢阅读!