環(huán)境與參數(shù)配置

本文以Java語言為例，進行后續(xù)操作。更多語言及其SDK安裝方式，請參見安裝與使用教程。

1. 請檢查您的Java版本是否高于Java 8。Java環(huán)境配置的方法，請參見在Windows搭建Java開發(fā)環(huán)境。

2. 請通過配置Maven依賴，完成SDK的安裝。

   <dependency>
     <groupId>com.aliyun</groupId>
     <artifactId>dysmsapi20170525</artifactId>
     <version>3.1.0</version>
   </dependency>

3. 請配置環(huán)境變量，通過環(huán)境變量讀取訪問密鑰（AccessKey）。環(huán)境變量配置方法，請參見在Linux、macOS和Windows系統(tǒng)配置環(huán)境變量。

   說明

   為避免在代碼中硬編碼AccessKey而造成泄露，請通過配置環(huán)境變量的方式，來獲取AccessKey。

接口調(diào)用流程

1. 申請短信簽名：使用CreateSmsSign接口。

   簽名信息需遵守短信簽名規(guī)范。

2. 申請短信模板：使用CreateSmsTemplate接口。

   國內(nèi)短信模板與國際/港澳臺短信模板不通用。

3. 等待審核：申請的簽名和模板，均審核通過后才可以發(fā)送短信。您可使用GetSmsSign、GetSmsTemplate接口查看簽名和模板的審核狀態(tài)。

4. 發(fā)送短信：使用SendSms接口，或使用SendBatchSms接口批量發(fā)送短信。

   發(fā)送短信前確保您賬戶余額充足。更多詳情，請參見計費概述。

5. 查看短信發(fā)送詳情：您可使用接口或回執(zhí)消息查看短信發(fā)送詳情。

   • 使用QuerySendDetails接口。

   • 配置回執(zhí)消息：短信發(fā)送后，通過配置輕量消息隊列（原 MNS）消費模式和HTTP批量推送模式，可以接收短信發(fā)送狀態(tài)的結(jié)果和用戶回復(fù)的短信內(nèi)容，幫助您了解短信的發(fā)送成功率，并為其他業(yè)務(wù)提供支持。

更多接口信息，請參見API概覽。

代碼示例

使用SDK發(fā)送短信（調(diào)用SendSms接口）的代碼示例如下，請根據(jù)注釋完成參數(shù)填寫。

package com.aliyun.sample;

import com.aliyun.teaopenapi.models.Config;
import com.aliyun.dysmsapi20170525.Client;
import com.aliyun.dysmsapi20170525.models.SendSmsRequest;
import com.aliyun.dysmsapi20170525.models.SendSmsResponse;
import static com.aliyun.teautil.Common.toJSONString;

public class Sample {
    public static Client createClient() throws Exception {
        Config config = new Config()
                // 配置 AccessKey ID，請確保代碼運行環(huán)境設(shè)置了環(huán)境變量。
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // 配置 AccessKey Secret，請確保代碼運行環(huán)境設(shè)置了環(huán)境變量。
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
                // System.getenv()方法表示獲取系統(tǒng)環(huán)境變量，請配置環(huán)境變量后，在此填入環(huán)境變量名稱，不要直接填入AccessKey信息。
        
        // 配置 Endpoint
        config.endpoint = "dysmsapi.aliyuncs.com";

        return new Client(config);
    }

    public static void main(String[] args) throws Exception {
        // 初始化請求客戶端
        Client client = Sample.createClient();

        // 構(gòu)造請求對象，請?zhí)钊胝埱髤?shù)值
        SendSmsRequest sendSmsRequest = new SendSmsRequest()
                .setPhoneNumbers("1390000****")
                .setSignName("阿里云")
                .setTemplateCode("SMS_15305****")
                .setTemplateParam("{\"name\":\"張三\",\"number\":\"1390000****\"}");

        // 獲取響應(yīng)對象
        SendSmsResponse sendSmsResponse = client.sendSms(sendSmsRequest);

        // 響應(yīng)包含服務(wù)端響應(yīng)的 body 和 headers
        System.out.println(toJSONString(sendSmsResponse));
    }
}

您可以訪問 OpenAPI 門戶，查看各語言 SDK 請求完整示例。

常見問題

• 短信服務(wù)API調(diào)用阿里云的IP服務(wù)器地址是固定的嗎？

• 提交模板時報錯SmsContent.Illegal，怎么處理？

• 如果發(fā)送的短信沒有收到，會有發(fā)送失敗的回執(zhí)或反饋嗎？

• 如何判斷短信發(fā)送成功還是失敗？

• 給用戶發(fā)送短信后，如何獲取用戶的短信回復(fù)？

• 短信發(fā)送失敗后支持自動補發(fā)嗎？

• 如何查看用戶回復(fù)的短信內(nèi)容？

• 短信下行狀態(tài)報告推送失敗10次怎么辦？

視頻教程