使用java代码写调用阿里云接口发送短信
1.阿里云官网
阿里云官网:阿里云
开通短信服务
申请签名+模版
获取AK(accessKeyId)
获取AKS(accessKeySecret)
以上内容省略,有兴趣的同学可以前往阿里云官网查看 官方示例 教学自行学习,本篇内容从代码部分讲起。
2.阿里接口调用模版
/**
* Created on 20/9/22.
* 短信API产品的DEMO程序,工程中包含了一个SmsDemo类,直接通过
* 执行main函数即可体验短信产品API功能(只需要将AK替换成开通了云通信-短信产品功能的AK即可)
* 工程依赖了2个jar包(存放在工程的libs目录下)
* 1:aliyun-java-sdk-core.jar
* 2:aliyun-java-sdk-dysmsapi.jar
*
* 备注:Demo工程编码采用UTF-8
* 国际短信发送请勿参照此DEMO
*/
public class SMSsend {
//产品名称:云通信短信API产品,开发者无需替换
static final String product = "Dysmsapi";
//产品域名,开发者无需替换
static final String domain = "dysmsapi.aliyuncs.com";
// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
static final String accessKeyId = "你自己的AK码";
static final String accessKeySecret = "你的AccessKey Secret";
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, domain);
IAcsClient acsClient = new DefaultAcsClient(profile);
//组装请求对象-具体描述见控制台-文档部分内容
SendSmsRequest request = new SendSmsRequest();
//必填:待发送手机号
request.setPhoneNumbers("待接收短信的手机号");
//必填:短信签名-可在短信控制台中找到
request.setSignName("你的签名名称");
//必填:短信模板-可在短信控制台中找到
request.setTemplateCode("你的模版名称");
//可选:模板中的变量替换JSON串,如模板内容为"亲爱的${name},您的验证码为${code}"时,此处的值为
request.setTemplateParam("{\"name\":\"Tom\", \"code\":\"123\"}");
//选填-上行短信扩展码(无特殊需求用户请忽略此字段)
//request.setSmsUpExtendCode("90997");
//可选:outId为提供给业务方扩展字段,最终在短信回执消息中将此值带回给调用者
request.setOutId("yourOutId");
//hint 此处可能会抛出异常,注意catch
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
return sendSmsResponse;
}
public static void main(String[] args) throws ClientException {
SendSmsResponse sendSms = sendSms();
boolean result= sendSms.getCode().equals("OK");
if(result) {
System.out.println("成功....");
}else {
System.out.println("失败....");
}
}
}
3.举例
/*接口部分*/
public class SMSsend {
static final String product = "Dysmsapi";
static final String domain = "dysmsapi.aliyuncs.com";
// TODO 此处需要替换成开发者自己的AK(在阿里云访问控制台寻找)
static final String accessKeyId = "accessKeyId";
static final String accessKeySecret = "accessKeySecret";
public String sendSms(String mobileNo) throws ClientException {
System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
System.setProperty("sun.net.client.defaultReadTimeout", "10000");
String code = generateCaptcha(6);//获取六位验证码
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(mobileNo);//手机号
request.setSignName("高克莱");//签名
request.setTemplateCode("SMS_123456789");
//可选:模板中的变量替换JSON串,如模板内容为"尊敬的用户您好,您的验证码:${code},有效期为5分钟,请及时验证。"时,此处的值为
request.setTemplateParam("{\"code\":\""+code+"\"}");
SendSmsResponse sendSms = acsClient.getAcsResponse(request);
//返回结果及验证码给调用方以便进行校验时的判断
if (sendSms.getCode().equals("OK")){
return sendSms.getCode()+code;
}
return sendSms.getCode();
}
//验证码基参
private static final String CHARACTERS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789";
/**
* 生成指定长度的验证码 数字+字母组合或仅字母
* @param length
* @return
*/
public static String generateCaptcha(int length) {
StringBuilder captcha = new StringBuilder();
Random random = new Random();
for (int i = 0; i < length; i++) {
int index = random.nextInt(CHARACTERS.length());
captcha.append(CHARACTERS.charAt(index));
}
return captcha.toString();
}
}
/*调用部分*/
public static void main(String[] args) {
//传入手机号码
String tel = "188****8888";
SMSsend sms = new SMSsend();
//调用接口,向188****8888手机号码发送验证码并返回发送结果及验证码
String smsCode = sms.sendSms(tel);
String code = "";
if(smsCode.startsWith("OK")){
code = smsCode.substring(2);
}
}
//发送成功:code = "xxxxxx" (xxxxxx为随机六位数字母数字验证码)
//发送失败:smsCode = 失败码
短信示例:
【高克莱】亲尊敬的用户您好,您的验证码:xxxxxx,有效期为5分钟,请及时验证。
4.阿里云短信服务 - 错误码
常见错误码及描述
错误码 | 错误描述 |
---|---|
OK | 请求成功。 |
isv.ACCOUNT_NOT_EXISTS | 账户不存在。 |
isv.ACCOUNT_ABNORMAL | 账户异常。 |
isv.INVALID_PARAMETERS | 参数异常。 |
isp.SYSTEM_ERROR | 系统错误。 |
isv.MOBILE_NUMBER_ILLEGAL | 非法手机号。 |
isv.INVALID_JSON_PARAM | JSON参数不合法,只接受字符串值。 |
isv.AMOUNT_NOT_ENOUGH | 账户余额不足。 |
参考阿里云官方API文档 错误码
5.接口部分需要引用的jar包
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 java.util.Random;
6.阿里云jar包下载
百度网盘地址:
链接:https://pan.baidu.com/s/101-a7L_2btq38gY9liMmFA?pwd=tcdo
提取码:tcdo
阿里云官方地址:
阿里云官方下载地址