Springboot调用腾讯云发短信服务
腾讯云官网 https://cloud.tencent.com
搜索短信,来到短信文档
https://cloud.tencent.com/document/product/382/37745
跟着文档很清楚,一步一步往下做
我们认证的是个人,只要注册个微信公众号,就可以有两百条免费的国内短信
账号注册以及认证完成后,我们往下拉,点击快速入门
进行创建短信签名和短信正文模板,短信签名主要是我们收到的短信开头的公司署名
我们是通过注册公众号认证个人短信服务的,所以这个署名基本和我们的公众号名字相似,创建签名我们选择公众号,这个签名内容就是署名
第二个签名是我用公众号创的如下图,紧接着我们来到正文模板管理,创建短信的内容与要传的验证码参数
点击创建短信正文模板
这个模板名称只是个备注作用不影响,模板里的参数是从1开始的,比如参数1格式是 {1},待会再利用方法传参进去
短信模板等注册完之后,我们来回到文档中心,点击SDK文档,Java SDK就可以看到官方的实现发送短信的相关代码
添加相关依赖
<dependency>
<groupId>com.tencentcloudapigroupId>
<artifactId>tencentcloud-sdk-javaartifactId>
<version>3.1.270version>
dependency>
发送短信的相关代码,我们进行按自己需要精简
public class SendMessageUtils {
public static String sendmsg(String secretId, String secretKey, String phoneNumber, String templateId) {
try {
/* 必要步骤:
* 实例化一个认证对象,入参需要传入腾讯云账户密钥对secretId,secretKey。
* 这里采用的是从环境变量读取的方式,需要在环境变量中先设置这两个值。
* 你也可以直接在代码中写死密钥对,但是小心不要将代码复制、上传或者分享给他人,
* 以免泄露密钥对危及你的财产安全。
* SecretId、SecretKey 查询: https://console.cloud.tencent.com/cam/capi */
Credential cred = new Credential(secretId, secretKey);
/* 实例化要请求产品(以sms为例)的client对象
* 第二个参数是地域信息,可以直接填写字符串ap-guangzhou,支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 */
SmsClient client = new SmsClient(cred, "ap-guangzhou");
/* 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数
* 你可以直接查询SDK源码确定接口有哪些属性可以设置
* 属性可能是基本类型,也可能引用了另一个数据结构
* 推荐使用IDE进行开发,可以方便的跳转查阅各个接口和数据结构的文档说明 */
SendSmsRequest req = new SendSmsRequest();
/* 填充请求参数,这里request对象的成员变量即对应接口的入参
* 你可以通过官网接口文档或跳转到request对象的定义处查看请求参数的定义
* 基本类型的设置:
* 帮助链接:
* 短信控制台: https://console.cloud.tencent.com/smsv2
* sms helper: https://cloud.tencent.com/document/product/382/3773 */
/* 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId,示例如1400006666 */
String sdkAppId = "1400580838";
req.setSmsSdkAppId(sdkAppId);
/* 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名,签名信息可登录 [短信控制台] 查看 */
String signName = "写点说说个人网";
req.setSignName(signName);
/* 国际/港澳台短信 SenderId: 国内短信填空,默认未开通,如需开通请联系 [sms helper] */
String senderid = "";
req.setSenderId(senderid);
/* 模板 ID: 必须填写已审核通过的模板 ID。模板ID可登录 [短信控制台] 查看 */
req.setTemplateId(templateId);
/* 下发手机号码,采用 E.164 标准,+[国家或地区码][手机号]
* 示例如:+8613711112222, 其中前面有一个+号 ,86为国家码,13711112222为手机号,最多不要超过200个手机号 */
String[] phoneNumberSet = {phoneNumber};
req.setPhoneNumberSet(phoneNumberSet);
/* 模板参数: 若无模板参数,则设置为空 */
String rancode = RandomCodeUtils.randomcode();
String[] templateParamSet = {rancode};
req.setTemplateParamSet(templateParamSet);
/* 通过 client 对象调用 SendSms 方法发起请求。注意请求方法名与请求对象是对应的
* 返回的 res 是一个 SendSmsResponse 类的实例,与请求对象对应 */
SendSmsResponse res = client.SendSms(req);
// 输出json格式的字符串回包
System.out.println(SendSmsResponse.toJsonString(res));
// 也可以取出单个值,你可以通过官网接口文档或跳转到response对象的定义处查看返回字段的定义
System.out.println(res.getRequestId());
return rancode;
} catch (TencentCloudSDKException e) {
e.printStackTrace();
}
return null;
}
}
这个方法的前两个参数是密钥,通过点击Java SDK文档中的API密钥管理进去获得
没有密钥就自己新建一个
方法的第三个参数是要发送的客户手机号码,第四个是短信模板ID如下图
第五个参数值是应用的sdkAppId如下图
第六个参数signName就是签名内容,即署名
第七个参数是字符数组,把手机号放进去即可,第八个参数templateParamSet是短信数组参数,按顺序放进去
第一个模板只有{1},则放一个参数,第二个模板{1}{2},则往字符数组依次放两个参数{“参数1”,“参数2”},
但是我们一般只需要一个参数,就是验证码,短信服务主要用来验证,短信过期时间可以写死
第八个参数的验证码rancode是通过工具类生成的,可以自己写个简单的生成随机数
public class RandomCodeUtils {
public static String randomcode(){
String retstr="";
// 0
Integer code= (int)((Math.random()*9+1)*100000) ;
retstr=code.toString();
return retstr;
}
}
这样就行了,我们则直接调用SendMessageUtils这个工具类的发短信服务即可