短信服務(wù)API介紹
阿里云短信發(fā)送:調(diào)用SendSms發(fā)送短信_短信服務(wù)-阿里云幫助中心文章來源：http://www.zghlxwxcb.cn/news/detail-521212.html
<!--springboot項目阿里云發(fā)送短信-->
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-alicloud-sms</artifactId>
<version>2.2.0.RELEASE</version>
</dependency>
?工具類：文章來源地址http://www.zghlxwxcb.cn/news/detail-521212.html
import com.alibaba.fastjson2.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsRequest;
import com.aliyuncs.dysmsapi.model.v20170525.QuerySendDetailsResponse;
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 com.shsq.common.utils.StringUtils;
import java.text.SimpleDateFormat;
import java.util.Collections;
import java.util.Date;
import java.util.HashMap;
import java.util.Map;
public class AliyunSmsUtil {
// 產(chǎn)品名稱:云通信短信API產(chǎn)品,開發(fā)者無需替換
static final String product = "Dysmsapi";
// 產(chǎn)品域名,開發(fā)者無需替換
static final String domain = "dysmsapi.aliyuncs.com";
// TODO 此處需要替換成開發(fā)者自己的AK(在阿里云訪問控制臺尋找)
private static final String accessKeyId = "自己的accessKeyId ";//需要替換
private static final String accessKeySecret = "自己的accessKeySecret";//需要替換
// 簽名
private static final String signName = "模板簽名";//需要替換
//短信模板
public static final String templateCode = "自己的短信模板";//需要替換
//發(fā)送短信失敗錯誤碼對應(yīng)的原因
public static Map<String,String> errorMags;
static {
Map<String,String> jsonObject = new HashMap<>();
jsonObject.put("isp.RAM_PERMISSION_DENY","RAM權(quán)限不足");
jsonObject.put("isv.OUT_OF_SERVICE","業(yè)務(wù)停機");
jsonObject.put("isv.PRODUCT_UN_SUBSCRIPT","未開通云通信產(chǎn)品的阿里云客戶");
jsonObject.put("isv.PRODUCT_UNSUBSCRIBE","產(chǎn)品未開通");
jsonObject.put("isv.ACCOUNT_NOT_EXISTS","賬戶不存在");
jsonObject.put("isv.ACCOUNT_ABNORMAL","賬戶異常");
jsonObject.put("isv.SMS_TEMPLATE_ILLEGAL","該賬號下找不到對應(yīng)模板");
jsonObject.put("isv.SMS_TEST_SIGN_TEMPLATE_LIMIT","測試模板和簽名限制");
jsonObject.put("isv.SMS_SIGNATURE_SCENE_ILLEGAL","簽名和模板類型不一致");
jsonObject.put("isv.SMS_SIGN_ILLEGAL","簽名禁止使用");
jsonObject.put("isv.SMS_SIGNATURE_ILLEGAL","該賬號下找不到對應(yīng)簽名");
jsonObject.put("isp.SYSTEM_ERROR","系統(tǒng)出現(xiàn)錯誤，請重新調(diào)用");
jsonObject.put("isv.MOBILE_NUMBER_ILLEGAL","手機號碼格式錯誤");
jsonObject.put("isv.MOBILE_COUNT_OVER_LIMIT","手機號碼數(shù)量超過限制，最多支持1000條");
jsonObject.put("isv.TEMPLATE_MISSING_PARAMETERS","模板變量中存在未賦值變量");
jsonObject.put("isv.TEMPLATE_PARAMS_ILLEGAL","傳入的變量內(nèi)容和實際申請模板時變量所選擇的屬性類型不配");
jsonObject.put("isv.TEMPLATE_COUNT_OVER_LIMIT","超過單自然日模板申請數(shù)量上限");
jsonObject.put("isv.TEMPLATE_OVER_LIMIT","模板字符數(shù)量超過限制");
jsonObject.put("isv.BUSINESS_LIMIT_CONTROL","觸發(fā)云通信流控限制");
jsonObject.put("isv.INVALID_JSON_PARAM","參數(shù)格式錯誤，請修改為字符串值");
jsonObject.put("isv.INVALID_PARAMETERS","參數(shù)格式不正確");
jsonObject.put("isv.BLACK_KEY_CONTROL_LIMIT","變量中傳入疑似違規(guī)信息");
jsonObject.put("isv.PARAM_LENGTH_LIMIT","參數(shù)超過長度限制");
jsonObject.put("isv.PARAM_NOT_SUPPORT_URL","變量不支持傳入URL");
jsonObject.put("isv.AMOUNT_NOT_ENOUGH","賬戶余額不足");
jsonObject.put("FILTER","關(guān)鍵字?jǐn)r截");
jsonObject.put("VALVE:M_MC","重復(fù)過濾");
jsonObject.put("VALVE:H_MC","重復(fù)過濾");
jsonObject.put("VALVE:D_MC","重復(fù)過濾");
jsonObject.put("MOBILE_SEND_LIMIT","單個號碼日或月發(fā)送上限，流控超限，頻繁發(fā)送超限");
jsonObject.put("isv.TEMPLATE_PARAMS_ILLEGAL","傳入的變量內(nèi)容和實際申請模板時變量所選擇的屬性類型不配");
jsonObject.put("MOBILE_IN_BLACK","手機號在黑名單（平臺或運營商）");
jsonObject.put("MOBILE_IN_BLACK","手機號在黑名單（平臺或運營商）");
jsonObject.put("MOBILE_TERMINAL_ERROR","手機終端問題、內(nèi)存滿、SIM卡滿、非法設(shè)備等");
jsonObject.put("SP_NOT_BY_INTER_SMS","未開通國際短信");
jsonObject.put("USER_REJECT","用戶手機退訂此業(yè)務(wù)、產(chǎn)品未開通");
jsonObject.put("SP_UNKNOWN_ERROR","運營商未知錯誤");
jsonObject.put("MOBILE_ACCOUNT_ABNORMAL","用戶賬戶異常、攜號轉(zhuǎn)網(wǎng)、欠費等");
jsonObject.put("DELIVERED","消息發(fā)送成功");
jsonObject.put("MOBILE_ACCOUNT_ABNORMAL","用戶賬戶異常、攜號轉(zhuǎn)網(wǎng)、欠費等");
jsonObject.put("CONTENT_KEYWORD","內(nèi)容關(guān)鍵字?jǐn)r截");
jsonObject.put("SIGNATURE_BLACKLIST","簽名黑名單");
jsonObject.put("INVALID_NUMBER","號碼不合法");
jsonObject.put("NO_ROUTE","無路由器");
jsonObject.put("CONTENT_ERROR","模板內(nèi)容無退訂");
errorMags = Collections.unmodifiableMap(jsonObject);
}
/**
* 發(fā)送短信驗證碼
* @param phoneNum
* @param templateParam
* @param templateCode
* @return
* @throws ClientException
*/
public static SendSmsResponse sendVerifyCode(String phoneNum, String templateParam, String templateCode)
throws ClientException {
// 可自助調(diào)整超時時間
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);
// 組裝請求對象-具體描述見控制臺-文檔部分內(nèi)容
SendSmsRequest request = new SendSmsRequest();
// 必填:待發(fā)送手機號
request.setPhoneNumbers(phoneNum);
// 必填:短信簽名-可在短信控制臺中找到
request.setSignName(signName);
// 必填:短信模板-可在短信控制臺中找到
request.setTemplateCode(templateCode);
// 可選:模板中的變量替換JSON串,如模板內(nèi)容為"親愛的${name},您的驗證碼為${code}"時,此處的值為
//request.setTemplateParam("{code:" + verifyCode + "}");
//request.setTemplateParam("{\"Express\":\"中通\",\"Address\":\"河南省盛世大廈8號樓菜鳥驛站；配送員：王金鶯;配送員：王金鶯;配d\",\"Pickingcode\":\"kko90\"}");
//request.setTemplateParam("{Address:河南省}");
request.setTemplateParam(templateParam);
//request.setTemplateParam("{Pickingcode:kko90}");
// 選填-上行短信擴展碼(無特殊需求用戶請忽略此字段)
// request.setSmsUpExtendCode("90997");
// 可選:outId為提供給業(yè)務(wù)方擴展字段,最終在短信回執(zhí)消息中將此值帶回給調(diào)用者
//request.setOutId("yourOutId");
// hint 此處可能會拋出異常，注意catch
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
return sendSmsResponse;
}
/**
* 查詢消息的發(fā)送狀態(tài)
* @param phoneNum
* @param bizId 發(fā)送回執(zhí)id,調(diào)用發(fā)送短信api時,會返回
* @return
* @throws ClientException
*/
public static QuerySendDetailsResponse querySendDetails(String phoneNum, String bizId) throws ClientException {
// 可自助調(diào)整超時時間
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);
// 組裝請求對象
QuerySendDetailsRequest request = new QuerySendDetailsRequest();
// 必填-號碼
request.setPhoneNumber(phoneNum);
// 可選-流水號
request.setBizId(bizId);
// 必填-發(fā)送日期 支持30天內(nèi)記錄查詢，格式y(tǒng)yyyMMdd
SimpleDateFormat ft = new SimpleDateFormat("yyyyMMdd");
request.setSendDate(ft.format(new Date()));
// 必填-頁大小
request.setPageSize(10L);
// 必填-當(dāng)前頁碼從1開始計數(shù)
request.setCurrentPage(1L);
// hint 此處可能會拋出異常，注意catch
QuerySendDetailsResponse querySendDetailsResponse = acsClient.getAcsResponse(request);
return querySendDetailsResponse;
}
//獲取錯誤碼對應(yīng)的原因
public static String getSmsSendError(String errCode){
String mags = null;
if(StringUtils.isNotBlank(errorMags.get(errCode))){
mags = errorMags.get(errCode);
}
return mags;
}
public static void main(String[] args) throws ClientException, InterruptedException {
JSONObject jsonObject = new JSONObject();
jsonObject.put("Express","中通");
jsonObject.put("Address","河南省盛世大廈8號樓菜鳥驛站；配送員：王金鶯");
jsonObject.put("Pickingcode","kko90");
// 發(fā)驗證碼短信
SendSmsResponse response = sendVerifyCode("18638888888", jsonObject.toJSONString(),"短信模板");
System.out.println("短信接口返回的數(shù)據(jù)----------------");
System.out.println("Code=" + response.getCode());
System.out.println("Message=" + response.getMessage());
System.out.println("RequestId=" + response.getRequestId());
System.out.println("BizId=" + response.getBizId());//消息回執(zhí)id
//Thread.sleep(3000L);
// 查明細
if (response.getCode() != null && response.getCode().equals("OK")) {
QuerySendDetailsResponse querySendDetailsResponse = querySendDetails("18638888888", response.getBizId());
System.out.println("短信明細查詢接口返回數(shù)據(jù)----------------");
System.out.println("Code=" + querySendDetailsResponse.getCode());
System.out.println("Message=" + querySendDetailsResponse.getMessage());
int i = 0;
for (QuerySendDetailsResponse.SmsSendDetailDTO smsSendDetailDTO : querySendDetailsResponse
.getSmsSendDetailDTOs()) {
System.out.println("SmsSendDetailDTO[" + i + "]:");
System.out.println("Content=" + smsSendDetailDTO.getContent());
System.out.println("ErrCode=" + smsSendDetailDTO.getErrCode());
System.out.println("OutId=" + smsSendDetailDTO.getOutId());
System.out.println("PhoneNum=" + smsSendDetailDTO.getPhoneNum());
System.out.println("ReceiveDate=" + smsSendDetailDTO.getReceiveDate());
System.out.println("SendDate=" + smsSendDetailDTO.getSendDate());
System.out.println("SendStatus=" + smsSendDetailDTO.getSendStatus());
System.out.println("Template=" + smsSendDetailDTO.getTemplateCode());
}
System.out.println("TotalCount=" + querySendDetailsResponse.getTotalCount());
System.out.println("RequestId=" + querySendDetailsResponse.getRequestId());
}
}
}
到了這里，關(guān)于Java阿里云短信發(fā)送工具類的文章就介紹完了。如果您還想了解更多內(nèi)容，請在右上角搜索TOY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
