官方文檔有詳細說明,以下引用一下:
發送短信接口(SendSms)
爲了訪問短信服務,您需要有一個阿里雲賬號。如果沒有,可首先按照如下步驟創建阿里雲賬號:
- 訪問阿里雲 官方網站,單擊頁面上的 免費註冊 按鈕。
- 按照屏幕提示完成註冊流程並進行實名認證,短信服務只支持實名認證用戶使用。爲了更好地使用阿里雲服務,建議儘快完成實名認證,否則部分阿里雲服務將無法使用。具體實名認證流程,請參考 這裏。
爲了使用短信發送API-JAVA SDK,您必須申請阿里雲的訪問密鑰。
阿里雲訪問祕鑰是阿里云爲用戶使用 API(非控制檯)來訪問其雲資源設計的“安全口令”。您可以用它來簽名 API 請求內容以通過服務端的安全驗證。
該訪問祕鑰成對(AccessKeyId 與 AccessKeySecret)生成和使用。每個阿里雲用戶可以創建多對訪問祕鑰,且可隨時啓用(Active)、禁用(Inactive)或者刪除已經生成的訪問祕鑰對。
您可以通過阿里雲控制檯的 祕鑰管理頁面 創建、管理所有的訪問祕鑰對,且保證它處於“啓用”狀態。由於訪問祕鑰是阿里雲對 API 請求進行安全驗證的關鍵因子,請妥善保管你的訪問祕鑰。如果某些祕鑰對出現泄漏風險,建議及時刪除該祕鑰對並生成新的替代祕鑰對。
步驟 3 在控制檯完成模板與簽名的申請,獲得調用接口必備的參數
短信簽名
根據用戶屬性來創建符合自身屬性的簽名信息。企業用戶需要上傳相關企業資質證明,個人用戶需要上傳證明個人身份的證明。
注意:短信簽名需要審覈通過後纔可以使用。
短信模板
短信模板,即具體發送的短信內容。
短信模板可以支持驗證碼、短信通知、推廣短信、國際/港澳臺消息四種模式。驗證碼和短信通知,通過變量替換實現個性短信定製。推廣短信不支持在模板中添加變量。國際/港澳臺消息只能使用國際/港澳臺短信模版發送短信。
短信模板需要審覈通過後纔可以使用。
爲了成功發送一條短信通知,您至少需要完成以下步驟
一、在控制檯完成短信簽名與短信模板的申請,獲得調用接口必備的參數
在“短信簽名”頁面完成簽名的申請,獲得短信簽名的字符串 簽名申請手冊
在“短信模板”頁面完成模板的申請,獲得模板ID。模板申請手冊
以上說明真實操作如下:
1、登錄阿里雲官網(https://www.aliyun.com/),進入之後打開控制檯,左上角點擊產品與服務,然後選擇短信服務,如圖:
2.創建AccessKey,(Access Key ID -- Access Key Secret)如圖:
3.進行 短信簽名 和 短信模板 設定,如圖:
基本配置完成後,我們就需要寫代碼了
首先,添加jar包或在maven中添加配置:
相關jar包:
aliyun-java-sdk-core-3.2.2.jar
aliyun-java-sdk-dysmsapi-1.0.0-SANPSHOT.jar
用Maven導入jar包:
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-core</artifactId>
<version>3.2.8</version> 注:如提示報錯,先升級基礎包版,無法解決可聯繫技術支持
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
<artifactId>aliyun-java-sdk-dysmsapi</artifactId>
<version>1.1.0</version>
</dependency>
StaticParam.java (爲了方便配置和明確易懂,我把配置參數放到這個類中)
package com.beishan.util;
public class StaticPeram {
/**
* 手機驗證部分配置
*/
// 設置超時時間-可自行調整
final static String defaultConnectTimeout = "sun.net.client.defaultConnectTimeout";
final static String defaultReadTimeout = "sun.net.client.defaultReadTimeout";
final static String Timeout = "10000";
// 初始化ascClient需要的幾個參數
final static String product = "Dysmsapi";// 短信API產品名稱(短信產品名固定,無需修改)
final static String domain = "dysmsapi.aliyuncs.com";// 短信API產品域名(接口地址固定,無需修改)
// 替換成你的AK (產品密)
final static String accessKeyId = "accessKeyId";// 你的accessKeyId,填你自己的 上文配置所得 自行配置
final static String accessKeySecret = "accessKeySecret";// 你的accessKeySecret,填你自己的 上文配置所得 自行配置
// 必填:短信簽名-可在短信控制檯中找到
final static String SignName = "簽名"; // 阿里雲配置你自己的短信簽名填入
// 必填:短信模板-可在短信控制檯中找到
final static String TemplateCode = "SMS_91945080"; // 阿里雲配置你自己的短信模板填入
}
PhoneCode.java(工具類,基本可以直接使用,裏面加入了main方法,可以直接在main方法中設置你的手機號碼進行測試)
package com.beishan.util;
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.exceptions.ServerException;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;
public class PhoneCode {
private static String code ;
public static void main(String[] args) {
String phone = "手機號碼"; //此處可輸入你的手機號碼進行測試
getPhonemsg(phone);
}
/**
* 阿里雲短信服務配置
* @param mobile
* @return
*/
public static String getPhonemsg(String mobile) {
/**
* 進行正則關係校驗
*/
System.out.println(mobile);
if (mobile == null || mobile == "") {
System.out.println("手機號爲空");
return "";
}
/**
* 短信驗證---阿里大於工具
*/
// 設置超時時間-可自行調整
System.setProperty(StaticPeram.defaultConnectTimeout, StaticPeram.Timeout);
System.setProperty(StaticPeram.defaultReadTimeout, StaticPeram.Timeout);
// 初始化ascClient需要的幾個參數
final String product = StaticPeram.product;// 短信API產品名稱(短信產品名固定,無需修改)
final String domain = StaticPeram.domain;// 短信API產品域名(接口地址固定,無需修改)
// 替換成你的AK
final String accessKeyId = StaticPeram.accessKeyId;// 你的accessKeyId,參考本文檔步驟2
final String accessKeySecret = StaticPeram.accessKeySecret;// 你的accessKeySecret,參考本文檔步驟2
// 初始化ascClient,暫時不支持多region
IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou",
accessKeyId, accessKeySecret);
try {
DefaultProfile.addEndpoint("cn-hangzhou", "cn-hangzhou", product,
domain);
} catch (ClientException e1) {
e1.printStackTrace();
}
//獲取驗證碼
code = vcode();
IAcsClient acsClient = new DefaultAcsClient(profile);
// 組裝請求對象
SendSmsRequest request = new SendSmsRequest();
// 使用post提交
request.setMethod(MethodType.POST);
// 必填:待發送手機號。支持以逗號分隔的形式進行批量調用,批量上限爲1000個手機號碼,批量調用相對於單條調用及時性稍有延遲,驗證碼類型的短信推薦使用單條調用的方式
request.setPhoneNumbers(mobile);
// 必填:短信簽名-可在短信控制檯中找到
request.setSignName(StaticPeram.SignName);
// 必填:短信模板-可在短信控制檯中找到
request.setTemplateCode(StaticPeram.TemplateCode);
// 可選:模板中的變量替換JSON串,如模板內容爲"親愛的${name},您的驗證碼爲${code}"時,此處的值爲
// 友情提示:如果JSON中需要帶換行符,請參照標準的JSON協議對換行符的要求,比如短信內容中包含\r\n的情況在JSON中需要表示成\\r\\n,否則會導致JSON在服務端解析失敗
request.setTemplateParam("{ \"number\":\""+code+"\"}");
// 可選-上行短信擴展碼(無特殊需求用戶請忽略此字段)
// request.setSmsUpExtendCode("90997");
// 可選:outId爲提供給業務方擴展字段,最終在短信回執消息中將此值帶回給調用者
request.setOutId("yourOutId");
// 請求失敗這裏會拋ClientException異常
SendSmsResponse sendSmsResponse;
try {
sendSmsResponse = acsClient.getAcsResponse(request);
if (sendSmsResponse.getCode() != null
&& sendSmsResponse.getCode().equals("OK")) {
// 請求成功
System.out.println("獲取驗證碼成功!!!");
} else {
//如果驗證碼出錯,會輸出錯誤碼告訴你具體原因
System.out.println(sendSmsResponse.getCode());
System.out.println("獲取驗證碼失敗...");
}
} catch (ServerException e) {
e.printStackTrace();
return "由於系統維護,暫時無法註冊!!!";
} catch (ClientException e) {
e.printStackTrace();
return "由於系統維護,暫時無法註冊!!!";
}
return "true";
}
/**
* 生成6位隨機數驗證碼
* @return
*/
public static String vcode(){
String vcode = "";
for (int i = 0; i < 6; i++) {
vcode = vcode + (int)(Math.random() * 9);
}
return vcode;
}
}