1. 程式人生 > >簡訊---阿里大魚

簡訊---阿里大魚

注意導包 ,測試成功。 作為紀念(使用的是大眾版 阿里大魚)

傳送簡訊介面(SendSms)
步驟 1 建立阿里雲賬號
為了訪問簡訊服務,您需要有一個阿里雲賬號。如果沒有,可首先按照如下步驟建立阿里雲賬號:

訪問阿里雲 官方網站,單擊頁面上的 免費註冊 按鈕。
按照螢幕提示完成註冊流程並進行實名認證,簡訊服務只支援實名認證使用者使用。為了更好地使用阿里雲服務,建議儘快完成實名認證,否則部分阿里雲服務將無法使用。具體實名認證流程,請參考 這裡。
步驟 2 獲取阿里雲訪問金鑰
為了使用簡訊傳送API-JAVA SDK,您必須申請阿里雲的訪問金鑰。

阿里雲訪問祕鑰是阿里云為使用者使用 API(非控制檯)來訪問其雲資源設計的“安全口令”。您可以用它來簽名 API 請求內容以通過服務端的安全驗證。

該訪問祕鑰成對(AccessKeyId 與 AccessKeySecret)生成和使用。每個阿里雲使用者可以建立多對訪問祕鑰,且可隨時啟用(Active)、禁用(Inactive)或者刪除已經生成的訪問祕鑰對。

您可以通過阿里雲控制檯的 祕鑰管理頁面 建立、管理所有的訪問祕鑰對,且保證它處於“啟用”狀態。由於訪問祕鑰是阿里雲對 API 請求進行安全驗證的關鍵因子,請妥善保管你的訪問祕鑰。如果某些祕鑰對出現洩漏風險,建議及時刪除該祕鑰對並生成新的替代祕鑰對。

步驟 3 在控制檯完成模板與簽名的申請,獲得呼叫介面必備的引數
簡訊簽名

根據使用者屬性來建立符合自身屬性的簽名信息。企業使用者需要上傳相關企業資質證明,個人使用者需要上傳證明個人身份的證明。

注意:簡訊簽名需要稽核通過後才可以使用。

簡訊模板

簡訊模板,即具體傳送的簡訊內容。

簡訊模板可以支援驗證碼、簡訊通知、推廣簡訊、國際/港澳臺訊息四種模式。驗證碼和簡訊通知,通過變數替換實現個性簡訊定製。推廣簡訊不支援在模板中新增變數。

簡訊模板需要稽核通過後才可以使用。

為了成功傳送一條簡訊通知,您至少需要完成以下步驟

一、在控制檯完成簡訊簽名與簡訊模板的申請,獲得呼叫介面必備的引數

在“簡訊簽名”頁面完成簽名的申請,獲得簡訊簽名的字串 簽名申請手冊

在“簡訊模板”頁面完成模板的申請,獲得模板ID。模板申請手冊

引數
入參列表
引數名稱 引數型別 必填與否 樣例取值 引數說明
PhoneNumbers String 必須 15000000000 簡訊接收號碼,支援以逗號分隔的形式進行批量呼叫,批量上限為1000個手機號碼,批量呼叫相對於單條呼叫及時性稍有延遲,驗證碼型別的簡訊推薦使用單條呼叫的方式;傳送國際/港澳臺訊息時,接收號碼格式為00+國際區號+號碼,如“0085200000000”
SignName String 必須 雲通訊 簡訊簽名
TemplateCode String 必須 SMS_0000 簡訊模板ID
TemplateParam String 可選 {“code”:”1234”,”product”:”ytx”} 簡訊模板變數替換JSON串,友情提示:如果JSON中需要帶換行符,請參照標準的JSON協議。
SmsUpExtendCode String 可選 90999 上行簡訊擴充套件碼,無特殊需要此欄位的使用者請忽略此欄位
OutId String 可選 abcdefgh 外部流水擴充套件欄位
出參列表
出參名稱 出參型別 樣例取值 引數說明
RequestId String 8906582E-6722 請求ID
Code String OK 狀態碼-返回OK代表請求成功,其他錯誤碼詳見錯誤碼列表
Message String 請求成功 狀態碼的描述
BizId String 134523^4351232 傳送回執ID,可根據該ID查詢具體的傳送狀態

package test;
 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;
/**
 * 
 * @author Lsc
 *
 */
public class SMSSender {
    //產品名稱:雲通訊簡訊API產品,開發者無需替換  固定除非阿里那邊更改   注意版本 目前作者使用的是v20170525  之前的版本是Sms
    static final String product = "Dysmsapi";
    //產品域名,開發者無需替換   固定除非阿里那邊更改   注意版本 目前作者使用的是v20170525   之前的版本是sms.aliyuncs.com
    static final String domain = "dysmsapi.aliyuncs.com";
    //開發者自己的AK(在阿里雲訪問控制檯尋找)  阿里給你的祕鑰對
    static final String accessKeyId = "XXXXXXX";
    static final String accessKeySecret = "XXXXXXX";

    //簡訊模板稽核通過平臺會給你一個code  或者自己申請的模板CODE
    public static final String TEMPLATE_CODE_NOTIFY = "SMS_112635023"; 
    public static final String[] TEMPLATE_CODES = {
            TEMPLATE_CODE_NOTIFY
    };

    /**傳送簡訊
     * @param templateCode
     * @param phones
     * @param verify
     * @return
     * @throws ClientException
     */
    public static SendSmsResponse sendSms(String templateCode, String phones, String key, String value) throws ClientException {

        //可自助調整超時時間
        System.setProperty("sun.net.client.defaultConnectTimeout", "10000");
        System.setProperty("sun.net.client.defaultReadTimeout", "10000");

        //初始化acsClient,暫不支援region化   
        //region一般為cn-hangzhou但也有其他區域的 具體請去看API或者網上自行搜尋
        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(phones);
        //必填:簡訊簽名-可在簡訊控制檯中找到
        request.setSignName("公司名字");
        //必填:簡訊模板-可在簡訊控制檯中找到
        request.setTemplateCode(templateCode);
        //可選:模板中的變數替換JSON串,如模板內容為"親愛的${name},歡迎來到..."
        //key是簡訊模板中的變數名 value就是變數值 eg:key=>name value=>小明
        String paramString="{\"name\":\"lsc\",\"address\":\"天上人間\",\"fee\":\"500000000\",\"pay\":\"100000000\"}";
        request.setTemplateParam(paramString);

        //選填-上行簡訊擴充套件碼(無特殊需求使用者請忽略此欄位)   
        //request.setSmsUpExtendCode("90997");

        //可選:outId為提供給業務方擴充套件欄位,最終在簡訊回執訊息中將此值帶回給呼叫者,可以自定義
        request.setOutId("此引數自己設定 並可以自發送成功後返回到你自己伺服器 用來做特殊業務    自行選擇");

        //hint 此處可能會丟擲異常,注意catch
        SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);
        if (sendSmsResponse != null) {
            System.out.println("簡訊介面返回的資料----------------");
            System.out.println("Code="+sendSmsResponse.getCode());
            System.out.println("Message="+sendSmsResponse.getMessage());
            System.out.println("RequestId="+sendSmsResponse.getRequestId());
            System.out.println("BizId="+sendSmsResponse.getBizId());
        }

        return sendSmsResponse;
    }

    public static void main(String[] args) {
        try {
            SendSmsResponse smsResponse = sendSms(SMSSender.TEMPLATE_CODES[0], "1534830xxxx", "1111", "一隻特立獨行的研究者");
            if (smsResponse != null) {
                System.out.println("簡訊介面返回的資料----------------");
                System.out.println("Code="+smsResponse.getCode());
                System.out.println("Message="+smsResponse.getMessage());
                System.out.println("RequestId="+smsResponse.getRequestId());
                System.out.println("BizId="+smsResponse.getBizId());
            }
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}