1、准备工作
在调用阿里云短信平台过程中我们需要使用几个必不可少的参数,即AccessKeyId、AccessKeySecret、短信签名、短信模板Code,以下是如何获取这些参数的步骤和方法。
1.1 注册及创建KeyId和Secret
-
注册阿里云账号,并实名认证:https://cn.aliyun.com/
-
主界面右上角头像,进入
AccessKey管理
-
点击
创建AccessKey
-
创建完成后,可以通过点击操作栏中的
查询Secret
,查看AccessKey ID和AccessKey Secret
1.2 开通短信服务
-
在主界面搜索
短信服务
,并点击立即开通
1.3 注册短信签名
-
进入短信服务控制台界面,选择
国内消息-签名管理-添加签名
-
按照要求依次填写签名、使用场景等信息,其中涉及第三方权益时,需要提交补充材料,包含① 签名归属方的企业营业执照、组织机构代码证、税务登记证三证合一的证明 ② 授权委托书(授权委托书模板可在当前页面进行下载)
1.4 注册短信模板
-
进入短信服务控制台界面,选择
国内消息-模板管理-添加模板
-
按照要求依次填写模板类型、名称、模板内容,注意:
建议先申请相关签名再申请模板
,申请时请提供业务指引,如APP、链接等;
2、使用
详细的开发指南:https://help.aliyun.com/document_detail/101298.html
以下是使用阿里云短信平台发送短信的一个流程示例:
2.1 引入依赖
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>4.0.6</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-dysmsapi</artifactId>
<version>1.1.0</version>
</dependency>
2.2 初始化短信客户端
//产品名称:云通信短信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";
//初始化acsClient,暂不支持region化
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou", accessKeyId, accessKeySecret);
DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product, domain);
IAcsClient acsClient = new DefaultAcsClient(profile);
2.3 构造请求体
//组装请求对象-具体描述见控制台-文档部分内容
SendSmsRequest request = new SendSmsRequest();
//必填:待发送手机号
request.setPhoneNumbers("15000000000");
//必填:短信签名-可在短信控制台中找到
request.setSignName("云通信");
//必填:短信模板-可在短信控制台中找到
request.setTemplateCode("SMS_1000000");
//可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
request.setTemplateParam("{\"name\":\"Tom\", \"code\":\"123\"}");
2.4 发送与响应
//hint 此处可能会抛出异常,注意catch
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
API错误码地址:https://help.aliyun.com/document_detail/101346.html