一、阿里云平台账号注册
1.阿里云官网地址:https://www.aliyun.com/
2.注册并实名认证,使用阿里云短信服务必须进行实名认证。
二、开通短信服务
1.点击右上角控制台进入控制台界面。
2.搜索短信服务,点击立即开通,开通短信服务为免费,后续发短信的时候才需要充值。
三、获取AccessKey
AccessKey为API密钥,代码中会用到。
1.点击右上角个人头像,点击AccessKey管理,进入AccessKey管理界面。
2.点击创建AccessKey按钮。
3.按要求填写相关信息,创建AccessKey成功即可。
四、创建短信签名及短信模版
1.如图,选择国内短信后分别添加签名和模版。
2.添加模版完成后会生成模版Code,代码中也会用到。
五,接下来,终于到了写代码的部分,话不多说,上代码。
1.首先新建Maven项目,所使用的maven依赖如下:
短信服务的jar包只需要aliyun下的两个jar即可,我这里为了方便参考,将我测试项目中的所有jar都展示出来。
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>3.2.8</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-dysmsapi</artifactId>
<version>1.1.0</version>
</dependency>
2.发送短信代码如下,导包语句我也有一并复制过来,以供参考,代码中需要修改的地方有四处,分别为accessKeyId和accessKeySecret,这两个可以到阿里云平台点击头像选择AccessKey管理中查看,还有短信签名和短信模版也可以在控制台中查看,修改即可。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsRequest;
import com.aliyuncs.dysmsapi.model.v20170525.SendSmsResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import java.util.Map;
@Controller
public class MsgSend {
// 产品名称:云通信短信API产品,开发者无需替换
static final String product = "Dysmsapi";
// 产品域名,开发者无需替换
static final String domain = "dysmsapi.aliyuncs.com";
// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台点击个人头像的AccessKey管理即可查看)
static final String accessKeyId = "XXXXXX"; // TODO 改这里
static final String accessKeySecret = "XXXXX"; // TODO 改这里
public static SendSmsResponse sendSms(String telephone, String code) throws ClientException {
// 可自助调整超时时间
System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
System.setProperty("sun.net.client.defaultReadTimeout", "10000");
// 初始化acsClient,暂不支持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();
// 必填:待发送手机号
request.setPhoneNumbers(telephone);
// 必填:短信签名-可在短信控制台中找到
request.setSignName("XXXX"); // TODO 改这里
// 必填:短信模板-可在短信控制台中找到
request.setTemplateCode("XXXX"); // TODO 改这里
// 可选:模板中的变量替换JSON串,如模板内容为"亲爱的用户,您的验证码为${code}"时,此处的值为
request.setTemplateParam("{\"code\":\"" + code + "\"}");
// 选填-上行短信扩展码(无特殊需求用户请忽略此字段)
// request.setSmsUpExtendCode("90997");
// 可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
request.setOutId("yourOutId");
// hint 此处可能会抛出异常,注意catch
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
if(sendSmsResponse.getCode()!= null && sendSmsResponse.getCode().equals("OK")){
System.out.println("短信发送成功!");
}else {
System.out.println("短信发送失败!");
}
return sendSmsResponse;
}
}
3.接下来可以写一个测试类,启动测试
public String sendMgs(@RequestBody Map<String,Object> map) throws Exception {
String code = Integer.toString((int)(Math.random()*9999)+100);//每次调用生成一次四位数的随机数
String telephone=map.get("phone").toString();
SendSmsResponse sendSms =sendSms(telephone,code);//填写你需要测试的手机号码
System.out.println("短信接口返回的数据----------------");
System.out.println("Code=" + sendSms.getCode());
System.out.println("Message=" + sendSms.getMessage());
System.out.println("RequestId=" + sendSms.getRequestId());
System.out.println("BizId=" + sendSms.getBizId());
return code;
}
这个时候就万事俱备,只欠东风啦,目前所有的操作都做完了,可以启动测试类,用postman测试一下就可以了。
PS:这个时候如果阿里云的账户没有余额或者余额不足,发送短信会报余额不足的错误,只要在阿里云的用户中心进行充值即可。
充值后啥也不需要设置,直接再发短信,就可以啦。
OK啦,大功告成!有问题欢迎评论区探讨。