阿里雲SMS

阿里雲SMS（Short Message Service）是一項基於雲計算的簡訊服務，可以幫助開發者快速、高效地推送簡訊。以下是阿里雲SMS的幾個方面的詳細闡述。

一、簡訊發送

1. 申請AccessKey

在使用阿里雲SMS之前，需要先申請一個AccessKey。申請方式為進入阿里雲控制台獲取，需要輸入身份信息，完成身份驗證後就可以獲取到AccessKey。

    // 阿里雲簡訊SDK的Java代碼示例
    IAcsClient acsClient = new DefaultAcsClient(profile);
    SendSmsRequest request = new SendSmsRequest();
    request.setPhoneNumbers("13800000000");
    request.setSignName("示遠科技");
    request.setTemplateCode("SMS_71150113");
    request.setTemplateParam("{\"code\":\"1234\"}");
    SendSmsResponse sendSmsResponse = acsClient.getAcsResponse(request);

2. 編寫API程序

使用阿里雲提供的SMS API，可以輕鬆地調用簡訊發送功能，以下是Java代碼示例。首先創建一個IAcsClient對象，並根據模板規則設置好請求參數，然後通過調用getAcsResponse()方法獲得發送結果。

3. 簡訊發送API參數說明

建議在使用簡訊發送API時先熟悉下面這些參數的用途，可以更準確地設置簡訊發送的各種規則。

參數一：PhoneNumbers

簡訊接收號碼，支持csv格式，最多一次性發送1000個號碼，號碼之間以英文逗號分隔。如”13000000000,13500000000″。

參數二：SignName

簡訊簽名名稱，阿里雲控制台創建簽名後獲取，必須是已審核通過的簽名。如示例中的”示遠科技”。

參數三：TemplateCode

簡訊模板ID，阿里雲控制台創建模板後獲取，必須是已審核通過的關鍵字模板。如示例中的”SMS_71150113″。

參數四：TemplateParam

簡訊模板變數參數，值為JSON格式的字元串。如示例中的”{\”code\”:\”1234\”}”。

二、簡訊模板

1. 模板類型

阿里雲SMS支持兩種類型的簡訊模板：普通和變數。其中普通簡訊模板僅用於發送固定內容的簡訊，而變數簡訊模板可以在發送時替換模板中的變數內容。

2. 模板規則

在使用阿里雲SMS的簡訊模板時，需要知道模板格式和模板規則。模板格式包括模板內文本、變數符號和變數名，例如：驗證碼${code}。變數符號和變數名可以自定義，阿里雲SMS會根據請求參數中的變數名進行自動替換。模板規則是指驗證碼、簡訊內容、變數等在發送時的要求。

3. 模板審核

在使用阿里雲SMS發送簡訊模板時，必須先提交審核。審核過程包括模板內容審核和簽名審核兩個部分，總的時間時長大約為1~2天。審核通過後的模板ID才能用於簡訊發送。

三、簡訊上行

1. 上行概述

除了簡訊發送功能外，阿里雲SMS還支持簡訊上行功能。簡訊上行是指簡訊接收者通過簡訊回復的方式將信息回傳到簡訊平台，由平台接收並處理。

2. 上行流程

簡訊上行流程為：設備發送簡訊至阿里雲SMS平台，平台接收信息並判斷是否符合規則要求，如果符合則會將信息分發至接收簡訊的應用程序。應用程序可以使用類似簡訊發送的API介面獲取信息並處理。

    // 阿里雲簡訊SDK的Java代碼示例
    IAcsClient acsClient = new DefaultAcsClient(profile);
    QueryInterSmsIsoInfoRequest request = new QueryInterSmsIsoInfoRequest();
    request.setStartTime(startTime);
    request.setEndTime(endTime);
    request.setQueryTimeUnit("min");
    QueryInterSmsIsoInfoResponse queryInterSmsIsoInfoResponse = acsClient.getAcsResponse(request);

3. 上行API參數說明

使用阿里雲SMS的簡訊上行功能，使用上行API介面設置以下參數：

參數一：startTime

查詢起始時間，格式為”yyyyMMddHHmmss”。

參數二：endTime

查詢結束時間，格式為”yyyyMMddHHmmss”。

參數三：queryTimeUnit

查詢單位，根據時間跨度不同設置不同單位。如本示例中的”min”。

四、簡訊狀態

1. 狀態概述

阿里雲SMS支持簡訊狀態查詢功能。簡訊狀態是指簡訊發送方在發送後，能夠獲得簡訊的發送狀態，包括成功、失敗、待審核等狀態。

2. 狀態查詢流程

簡訊狀態查詢流程為：設備發送簡訊至阿里雲SMS平台，平台接收信息並進行處理，設備使用簡訊狀態API介面查詢結果並處理。

    // 阿里雲簡訊SDK的Java代碼示例
    IAcsClient acsClient = new DefaultAcsClient(profile);
    QuerySendDetailsRequest request = new QuerySendDetailsRequest();
    request.setPhoneNumber("13800000000");
    request.setSendDate("20190910");
    request.setPageSize(10L);
    request.setCurrentPage(1L);
    QuerySendDetailsResponse querySendDetailsResponse = acsClient.getAcsResponse(request);

3. 狀態查詢API參數說明

使用阿里雲SMS的簡訊狀態查詢功能，使用狀態查詢API介面設置以下參數：

參數一：PhoneNumber

簡訊接收號碼。

參數二：SendDate

簡訊發送日期，支持30天內的數據查詢，格式為yyyyMMdd。

參數三：PageSize

分頁大小，默認值為10。

參數四：CurrentPage

當前頁碼，默認值為1。

五、結語

阿里雲SMS提供了豐富的功能，包括簡訊發送、簡訊模板、簡訊上行和簡訊狀態查詢等。通過API介面可以輕鬆地接入阿里雲SMS服務，同時可以使用阿里雲控制台進行操作和管理。無論是企業用戶還是個人用戶，都可以通過阿里雲SMS實現快速、高效、安全的簡訊發送。