短信服务简介:
目前市场上有很多第三方提供短信发送服务,这些第三方与各个运行商(移动、电信、联通)对接,我们只需要注册成为会员并按照提供的开发文档调用就可以发送短信,需要说明的是这些短信服务都是需要收取费用的。
短信服务常用于:发送短信验证码、短信通知等。
我们介绍阿里云提供的短息服务。短信服务API提供短信发送、发送状态查询、短信批量发送等能力,在阿里云短信服务控制台上添加签名、模板并通过审核之后,可以调用短信服务API完成短信发送等操作。
点击进入阿里云官网:阿里云官网
一.服务使用流程
- 注册阿里云账号并登录
- 登录后按照如下方式进入短信服务的控制台
- 添加签名,根据具体信息进行填写并等待审核
- 添加短信模板(要注意变量 ${code} 等,在代码中进行操作时需要使用)
5. 记录自己的AccessKey:
二.Maven导入坐标
java程序使用短信服务
导入maven坐标:
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-dysmsapi</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>3.4.0</version>
</dependency>
三.短信发送通用模板
package com.zj.utils;
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.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
/**
* 短信发送工具类
* 需要提前知道的信息:模板Code、签名名称、accesskey、accessKeySecret、手机号码、短息中的变量、
*/
public class SMSUtils {
// 模板对应的模板Code,要发多少种就使用多少种模板
public static final String VALIDATE_CODE = "SMS_159620392";//发送短信验证码
public static final String ORDER_NOTICE = "SMS_159771588";//体检预约成功通知
/**
* 发送短信
* @param phoneNumbers
* @param param
* @throws ClientException
*/
public static void sendShortMessage(String templateCode,String phoneNumbers,String param) throws ClientException{
// 设置超时时间-可自行调整
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 = "你的accessKeyId";// 你的accessKeyId,参考本文档步骤2
final String accessKeySecret = "你的accessKeySecret";// 你的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);
// 必填:待发送手机号。支持以逗号分隔的形式进行批量调用,批量上限为1000个手机号码,批量调用相对于单条调用及时性稍有延迟,验证码类型的短信推荐使用单条调用的方式
request.setPhoneNumbers(phoneNumbers);
// 必填:短信签名-可在短信控制台中找到
request.setSignName("你的短信签名");
// 必填:短信模板-可在短信控制台中找到
request.setTemplateCode(templateCode);
// 可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
// 友情提示:如果JSON中需要带换行符,请参照标准的JSON协议对换行符的要求,比如短信内容中包含\r\n的情况在JSON中需要表示成\\r\\n,否则会导致JSON在服务端解析失败
request.setTemplateParam("{\"code\":\""+param+"\"}");
// 可选-上行短信扩展码(扩展码字段控制在7位或以下,无特殊需求用户请忽略此字段)
// request.setSmsUpExtendCode("90997");
// 可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
// request.setOutId("yourOutId");
// 请求失败这里会抛ClientException异常
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
if (sendSmsResponse.getCode() != null && sendSmsResponse.getCode().equals("OK")) {
// 请求成功
System.out.println("请求成功");
}
}
}
- 使用时只需要修改相应的模板Code、签名名称、accesskey、accessKeySecret、手机号码、短息中的变量等信息即可
- 更多java操作短信服务请查看文末的阿里云短信服务API
四.测试
package com.zj.utils;
public class Test {
public static void main(String[] args) {
try{
SMSUtils.sendShortMessage(SMSUtils.ORDER_NOTICE,"1239138*32","8734");
}catch (Exception e){
System.out.println(e);
}
}
}
验证通过即可收到相应的手机号
其他:阿里云短信服务API文档