前言
短信服务--SMS
一、短信服务介绍
短信服务(Short Message Service)是云服务商为用户提供的一种通信服务的能力。下面以阿里云为例进行介绍。
-
产品优势:覆盖全面、高并发处理、消息堆积处理、开发管理简单、智能监控调度
-
产品功能:短信通知、短信验证码、推广短信、异步通知、数据统计
-
应用场景:短信验证码、系统信息推送、推广短信等
二、短信服务使用
接下来,我们使用短信验证码功能来演示短信服务的使用。流程如下:
1. 准备工作
- 实名认证操作
- 开通短信服务
3. 申请认证秘钥
4. 申请短信签名
5. 申请短信模板
2. 短信服务API介绍
- 短信发送(SendSms)
调用SendSms发送短信。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
PhoneNumbers | String | 是 | 15900000000 | 接收短信的手机号码。 |
SignName | String | 是 | 阿里云 | 短信签名名称。 |
TemplateCode | String | 是 | SMS_153055065 | 短信模板ID。 |
TemplateParam | String | 否 | {“code”:“1111”} | 短信模板变量的值,JSON格式 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
BizId | String | 900619746936498440^0 | 发送回执ID,可根据它查询具体的发送状态。 |
Code | String | OK | 请求状态码。返回OK代表请求成功。 |
Message | String | OK | 状态码的描述。 |
RequestId | String | F655A8D5-B967-440B-8683 | 请求ID。 |
- 短信查询(QuerySendDetails)
调用QuerySendDetails接口查看短信发送记录和发送状态。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
CurrentPage | Long | 是 | 1 | 分页查看,指定发送记录的的当前页码。 |
PageSize | Long | 是 | 10 | 分页查看,指定每页显示的短信记录数量。 |
PhoneNumber | String | 是 | 15900000000 | 接收短信的手机号码。 |
SendDate | String | 是 | 20181228 | 短信发送日期,支持查询最近30天的记录。 |
BizId | String | 否 | 134523^4351232 | 发送回执ID,即发送流水号。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | OK | 请求状态码。返回OK代表请求成功。 |
Message | String | OK | 状态码的描述。 |
RequestId | String | 819BE656-D2E0 | 请求ID。 |
SmsSendDetailDTOs | Array | 短信发送明细。 | |
TotalCount | String | 1 | 短信发送总条数。 |
- 功能测试
第1步: 引入阿里云服务依赖
<!--短信发送-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alicloud-sms</artifactId>
</dependency>
第2步: 使用阿里云提供的Demo测试短信发送
<!--短信发送-->
public class SmsDemo {
//产品名称:云通信短信API产品,开发者无需替换
static final String product = "Dysmsapi";
//产品域名,开发者无需替换
static final String domain = "dysmsapi.aliyuncs.com";
// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
static final String accessKeyId = "yourAccessKeyId";
static final String accessKeySecret = "yourAccessKeySecret";
//短信发送
public static SendSmsResponse sendSms() 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,