API文档介绍: API概览 (aliyun.com)
一、自己测试
1、快速使用
-
搜索阿里云,打开官网
-
点击右上角的注册,或者登录,支付宝就可以进行注册。
-
在导航栏找到
产品->短信服务
。 -
点击免费开通
-
如果里面没有钱的话,我们需要先进行充值。
-
这里我们充值个1块钱就够测试用的了(平均每条短信为¥0.045元)。
-
充值完毕以后,我们回到刚才的短信控制台页面,点击左侧导航栏的“快速学习”,往下翻
-
接下啦我们就会跳到如下页面
-
我们需要先点击右侧的获取AK,点击继续使用
-
创建AccessKey
-
创建好的id为账号,Secret为密码,我们需要记住或者保存下来(后期需要也可以过来查看,但是需要验证码才能获取密码,很麻烦)。
-
创建好以后我们就可以在IDEA中创建Maven项目了。
-
创建好Maven项目以后,导入Pom依赖。
-
导入完依赖以后我们就可以创建一个包,然后把代码全部粘贴进去。
package com.tcc.util; import com.aliyun.dysmsapi20170525.Client; import com.aliyun.dysmsapi20170525.models.SendSmsRequest; import com.aliyun.dysmsapi20170525.models.SendSmsResponse; import com.aliyun.teaopenapi.models.Config; /** * @author 宇辰 * 2022/4/16 - 21:28 */ public class SmsUtil { /** * 使用AK&SK初始化账号Client * @param accessKeyId * @param accessKeySecret * @return Client * @throws Exception */ public static Client createClient(String accessKeyId, String accessKeySecret) throws Exception { Config config = new Config() // 您的AccessKey ID .setAccessKeyId(accessKeyId) // 您的AccessKey Secret .setAccessKeySecret(accessKeySecret); // 访问的域名 config.endpoint = "dysmsapi.aliyuncs.com"; return new Client(config); } public static void main(String[] args) throws Exception { //这里的accessKeyId需要我们填入刚刚添加的AccessKey的账号,后面那个参数为密码 Client client = SmsUtil.createClient("accessKeyId", "accessKeySecret"); SendSmsRequest sendSmsRequest = new SendSmsRequest() //短信的签名 .setSignName("阿里云短信测试") //短信的模板码 .setTemplateCode("SMS_154950909") //收短信的手机号,必须与刚刚添加的测试手机号一致,否则接收不到 .setPhoneNumbers("xxxxxxxxxxx") //code后面的值为验证码,code的值只支持4-6位纯数字 .setTemplateParam("{\"code\":\"1314\"}"); // 复制代码运行请自行打印 API 的返回值 client.sendSms(sendSmsRequest); } }
-
运行main方法,等待手机收到短信就好了。
2、调试
方法一:
-
当我们没有收到短信验证码的时候,我们可以回到页面中,使用可视化进行查看响应
-
调用以后,如果我们还是没有收到短信,那么我们点击右侧的“调用结果”,查看响应信息,进行排错。
方法二:
-
在代码中接收响应值并进行打印
public static void main(String[] args) throws Exception { //这里的accessKeyId需要我们填入刚刚添加的AccessKey的账号,后面那个参数为密码 Client client = SmsUtil.createClient("LTAI5tNd5HsCngLTomRmBPv6", "UySXNeBkGzB5Mw2vrSwyqvQd87FRm6"); SendSmsRequest sendSmsRequest = new SendSmsRequest() //短信的签名 .setSignName("阿里云短信测试") //短信的模板码 .setTemplateCode("SMS_154950909") //收短信的手机号,必须与刚刚添加的测试手机号一致,否则接收不到 .setPhoneNumbers("17630620280") //code后面的值为验证码,code的值只支持4-6位纯数字 .setTemplateParam("{\"code\":\"5201314\"}"); // 复制代码运行请自行打印 API 的返回值 SendSmsResponse res = client.sendSms(sendSmsRequest); System.out.println(new Gson().toJson(res.body)); }
-
code是故意写错的,我们查看一下结果:
-
可以很清晰的查看出代码出错的原因。
二、商业使用
看这个步骤之前建议先看一看上面测试的步骤。
1、快速使用
因为刚开始步骤和上面测试的步骤一样,就不详解了。
-
打开阿里云官网。
-
登录/注册自己的阿里云账号。
-
点击工具栏的产品->短信服务。
-
点击免费开通,打开控制台。
-
如果没有钱的话,记得先充值(步骤上面有)。
-
点击左侧导航栏的
国内消息
,然后添加签名。 -
根据步骤依次填入信息,点击提交
-
创建好签名后,等待审核,然后创建模板
-
根据步骤填内容,完成以后,点击添加,等待审核
-
添加完毕以后,我们把鼠标放到右上角我的头像上面,创建一个AccessKey并保存(上面有步骤)
-
准备完毕后,我们回到短信服务页面,点击API介入参考,或当前页面顶端的网址。
-
点击左侧的SDK参考->java SDk
-
导入依赖
-
复制以下代码到工具类中,并进行优化修改
package com.tcc.util; import com.aliyun.dysmsapi20170525.Client; import com.aliyun.dysmsapi20170525.models.SendSmsRequest; import com.aliyun.dysmsapi20170525.models.SendSmsResponse; import com.aliyun.teaopenapi.models.Config; import com.google.gson.Gson; import jdk.nashorn.internal.ir.ReturnNode; /** * @author 宇辰 * 2022/4/16 - 21:28 */ public class SmsUtil { /** * 随机生成6位数的code码 * @return */ public static String getCode(){ int code = (int)((Math.random()*9+1)*100000); return code+""; } /** * 使用AK&SK初始化账号Client * @param accessKeyId * @param accessKeySecret * @return Client * @throws Exception */ public static Client createClient(String accessKeyId, String accessKeySecret) throws Exception { Config config = new Config() // 您的AccessKey ID .setAccessKeyId(accessKeyId) // 您的AccessKey Secret .setAccessKeySecret(accessKeySecret); // 访问的域名 config.endpoint = "dysmsapi.aliyuncs.com"; return new Client(config); } public static String sendSms2(String phone) throws Exception { String code = SmsUtil.getCode(); //这里的accessKeyId需要我们填入刚刚添加的AccessKey的账号,后面那个参数为密码 Client client = SmsUtil.createClient("LTAI5tNd5HsCngLTomRmBPv6", "UySXNeBkGzB5Mw2vrSwyqvQd87FRm6"); SendSmsRequest sendSmsRequest = new SendSmsRequest() //短信的签名,改成自己申请的签名 .setSignName("阿里云短信测试") //短信的模板码,改成自己申请的模板码 .setTemplateCode("SMS_154950909") //收短信的手机号,接收前台传来的手机号。 .setPhoneNumbers(phone) //code后面的值为验证码,code的值只支持4-6位纯数字 .setTemplateParam("{\"code\":"+code+"}"); SendSmsResponse res = client.sendSms(sendSmsRequest); //返回响应的值 return new Gson().toJson(res.body); } }
-
添加测试类当做controller,调用方法
package com.tcc.test; import com.aliyun.dysmsapi20170525.Client; import com.aliyun.dysmsapi20170525.models.SendSmsRequest; import com.aliyun.dysmsapi20170525.models.SendSmsResponse; import com.aliyun.dysmsapi20170525.models.SendSmsResponseBody; import com.google.gson.Gson; import com.tcc.util.SmsUtil; /** * @author 宇辰 * 2022/4/16 - 21:32 */ public class Test { public static void main(String[] args) { try { String s = SmsUtil.sendSms2("xxxxxxxxxxx"); System.out.println(s); } catch (Exception e) { e.printStackTrace(); } } }
-
结果:
-