Java版阿里雲通信短信發送API接口實例(新)


阿里雲通信(原名阿里大於)的短信服務(Short Message Service)是阿里雲為用戶提供的一種通信服務的能力,支持快速發送短信驗證碼、短信通知等。 完美支撐雙11期間2億用戶,發送6億短信。三網合一專屬通道,與工信部攜號轉網平台實時互聯。電信級運維保障,實時監控自動切換,到達率高達99%。

具體阿里大於是什么時候改版到阿里雲通信的,不是太清楚,反正以前的短信發送驗證碼、短信通知的接口最近用不了了(提示的錯誤見下面的日志),於是只能根據阿里雲通信提供的API對接口重新改版。

ERROR com.taobao.api.internal.util.TaobaoLogger: 2017-12-08 12:09:52.181^_^LTAIR3x1VogOJPz5^_^alibaba.aliqin.fc.sms.num.send^_^172.19.38.254^_^Windows Server 2012 R2^_^46^_^http://gw.api.taobao.com/router/rest^_^^_^{"error_response":{"code":11,"msg":"Insufficient isv permissions","sub_code":"isv.permission-api-package-limit","sub_msg":"scope ids is 11022 11600 11863","request_id":"rxn0ipvhba2f"}}

發現錯誤后的第一反應當然是根據錯誤信息去找原因:

Insufficient isv permissions:開發者權限不足
isv.permission-api-package-limit:沒有和任何訪問包關聯,建議根據業務規則申請對應的權限

這樣的解釋似乎並不能幫助我們解決掉問題?

接下來的做法,當然是去看阿里雲通信官方給出的API,等待把Java版的短信產品相關的SDK及DEMO程序下載到本地后,我明白了。

新的jar包

aliyun-java-sdk-core-3.3.1.jar
aliyun-java-sdk-dysmsapi-1.0.0.jar

原來調用的jar包

taobao-sdk-java-auto_1455552377940-20160607.jar

sdk已經發生了變化,當然舊版的短信接口99%是用不了的。

那么新版的阿里雲通信短信發送API該怎么調用呢?

1)創建阿里雲賬號

2)獲取阿里雲訪問密鑰

這里寫圖片描述

3)在控制台完成模板與簽名的申請,獲得調用接口必備的參數

這里寫圖片描述

添加模板的時候,請一定要注意,模板的格式是需要一定規則的,后面編寫Java代碼時需要進行匹配,舉例如下:

這里寫圖片描述

${code}在后面調用阿里雲API的時候要傳遞。

這里寫圖片描述

${username}${password}同樣在后面調用阿里雲API的時候要傳遞。

模板提交后,阿里雲通信會在2個小時候內審批,審批完成后就可以看到模板CODE,該參數在后面調用API的時候同樣是必須的。

4)下載Java版的SDK

如果你使用的是maven,阿里提供的方式是:

如果你們公司有自己搭建倉庫,可以把SDK里面提供的本地jar上傳上去即可
或者你走你的本地jar依賴方式

<dependency>
<groupId>*</groupId>
<artifactId>*</artifactId>
<version>*</version>
<systemPath>${project.basedir}/lib/*.jar</systemPath>
</dependency>
<scope> compile</scope>

如果是常規的Java或者Javaweb項目(直接放在WEB-INF的lib包下),則可以把以下兩個jar包引入到工程當中:

aliyun-java-sdk-core-3.3.1.jar
aliyun-java-sdk-dysmsapi-1.0.0.jar

5)編寫發送短信的util類

package com.honzh.common.util;


import java.text.SimpleDateFormat;
import java.util.Date;

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.honzh.common.sys.OrderException;

public class MoblieMessageUtil {

// 產品名稱:雲通信短信API產品,開發者無需替換
private static final String product = "Dysmsapi";
// 產品域名,開發者無需替換
private static final String domain = "dysmsapi.aliyuncs.com";

// 此處需要替換成開發者自己的AK(在阿里雲訪問控制台尋找)
private static String accessKeyId = "yourAccessKeyId";
private static String accessKeySecret = "yourAccessKeySecret";
private static String signName = "yourAccessKeySecret";
private static String identifyingTempleteCode = "yourAccessKeySecret";
private static String registTempleteCode = "yourAccessKeySecret";

public static void init(String accessKeyId, String accessKeySecret, String signName, String identifyingTempleteCode,
String registTempleteCode) {
MoblieMessageUtil.accessKeyId = accessKeyId;
MoblieMessageUtil.accessKeySecret = accessKeySecret;
MoblieMessageUtil.signName = signName;
MoblieMessageUtil.identifyingTempleteCode = identifyingTempleteCode;
MoblieMessageUtil.registTempleteCode = registTempleteCode;
}

public static void main(String[] args) {
MoblieMessageUtil.init("key", "keysecret", "沉默王二", "SMS_110",
"SMS_112");
// 發短信
SendSmsResponse response = MoblieMessageUtil.sendIdentifyingCode("手機號", "123456");
System.out.println("短信接口返回的數據----------------");
System.out.println("Code=" + response.getCode());
System.out.println("Message=" + response.getMessage());
System.out.println("RequestId=" + response.getRequestId());
System.out.println("BizId=" + response.getBizId());

response = MoblieMessageUtil.sendNewUserNotice("18637903705", "123456", "4512");
System.out.println("短信接口返回的數據----------------");
System.out.println("Code=" + response.getCode());
System.out.println("Message=" + response.getMessage());
System.out.println("RequestId=" + response.getRequestId());
System.out.println("BizId=" + response.getBizId());

}
public static SendSmsResponse sendSms(String mobile, String templateParam, String templateCode)
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(mobile);
// 必填:短信簽名-可在短信控制台中找到
request.setSignName(signName);
// 必填:短信模板-可在短信控制台中找到
request.setTemplateCode(templateCode);

// 可選:模板中的變量替換JSON串,如模板內容為"親愛的${name},您的驗證碼為${code}"時,此處的值為
request.setTemplateParam(templateParam);

// 選填-上行短信擴展碼(無特殊需求用戶請忽略此字段)
// request.setSmsUpExtendCode("90997");

// 可選:outId為提供給業務方擴展字段,最終在短信回執消息中將此值帶回給調用者
request.setOutId("yourOutId");

// hint 此處可能會拋出異常,注意catch
SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);

return sendSmsResponse;
}
public static SendSmsResponse sendNewUserNotice(String mobile, String username, String password) {
try {
return sendSms(mobile, "{\"username\":\"" + username + "\", \"password\":\"" + password + "\"}",
registTempleteCode);
} catch (ClientException e) {
throw new OrderException(e.getMessage());
}
}

public static SendSmsResponse sendIdentifyingCode(String mobile, String code) {
try {
return sendSms(mobile, "{\"code\":\"" + code + "\"}", identifyingTempleteCode);
} catch (ClientException e) {
throw new OrderException(e.getMessage());
}
}
}

API的調用方式是阿里雲提供的,不過這里需要注意的是參數的json字符串一定要正確。

上文中驗證碼模板的參數格式是{"code":"123456"},盡管123456是數字,也要按照字符串傳遞。
注冊模板的參數格式是“`{“username”:”沉默王二”,”password”:”123456”}。

另外,模板CODE一定要傳遞正確!一般是以SMS_開頭的,例SMS_113121051



免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM