Short Message Service：首次調用API

• 在通過API使用簡訊服務前，請確保您已開通簡訊服務並已完成資質申請，具體操作請參見新手指引。

• 在通過API傳送簡訊前，您還需要完成簡訊簽名、簡訊模板的申請，並等待審核通過。簡訊簽名、簡訊模板的申請可通過控制台或API完成。具體操作請參見新手指引。

1. 建立RAM使用者

   訪問建立RAM使用者，完成相關名稱設定，並選擇訪問方式為OpenAPI 呼叫訪問，單擊確定後即可完成RAM使用者的建立。建立時會顯示AccessKey資訊，請妥善保管。

2. 為RAM使用者授權

   訪問RAM使用者列表，找到您所建立的RAM使用者，單擊操作列的添加許可權。通過文字框搜尋，選擇AliyunDysmsFullAccess，單擊確認新增授權，完成授權操作。

   說明

   • AliyunDysmsFullAccess：管理簡訊服務的許可權。

   • AliyunDysmsReadOnlyAccess：唯讀訪問簡訊服務的許可權。

   如果您需要建立自訂許可權，請參見授權資訊。

為使用SDK進行簡訊服務API的調用，您的Java版本需高於Java 8。您可以通過在終端運行以下命令，來檢查您的Java環境：

java -version

若您尚未完成Java環境的配置或Java版本低於Java 8，請參見在Windows搭建Java開發環境。

您可以通過配置Maven依賴來安裝SDK。

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>dysmsapi20180501</artifactId>
  <version>1.0.8</version>
</dependency>

為避免在代碼中寫入程式碼存取金鑰（AccessKey）而造成泄露，請通過配置環境變數的方式擷取AccessKey。環境變數配置方法，請參見在Linux、macOS和Windows系統配置環境變數。

本文以環境變數名ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET為例，進行後續操作。通過環境變數擷取AccessKey的程式碼範例如下：

Config config = new Config()
        // 請確保代碼運行環境配置了相應環境變數
        .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
        .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));

佈建服務存取點程式碼範例如下：

config.endpoint = "dysmsapi.ap-southeast-1.aliyuncs.com";

請根據您的地區填入相應地址，參見服務存取點。

完整程式碼範例如下：

package com.aliyun.sample;

import com.aliyun.teaopenapi.models.Config;
import com.aliyun.dysmsapi20180501.Client;
import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeRequest;
import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeResponse;
import static com.aliyun.teautil.Common.toJSONString;

public class Sample {
    public static Client createClient() throws Exception {
        Config config = new Config()
                // 配置 AccessKey ID，請確保代碼運行環境配置了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // 配置 AccessKey Secret，請確保代碼運行環境配置了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));

        // 配置 Endpoint
        config.endpoint = "dysmsapi.ap-southeast-1.aliyuncs.com";

        return new Client(config);
    }

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

        // 構造請求對象，請填入請求參數值
        SendMessageToGlobeRequest sendSmsRequest = new SendMessageToGlobeRequest()
                .setTo("<YOUR_VALUE>")
                .setMessage("<YOUR_VALUE>");

        // 擷取響應對象
        SendMessageToGlobeResponse sendSmsResponse = client.sendMessageToGlobe(sendSmsRequest);

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