Alibaba Cloud SDK：Integrasikan SDK

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'yourAccessKeySecret', [System.EnvironmentVariableTarget]::User)

[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_ID', 'yourAccessKeyID', [System.EnvironmentVariableTarget]::Machine)
[System.Environment]::SetEnvironmentVariable('ALIBABA_CLOUD_ACCESS_KEY_SECRET', 'yourAccessKeySecret', [System.EnvironmentVariableTarget]::Machine)

$env:ALIBABA_CLOUD_ACCESS_KEY_ID = "yourAccessKeyID"
$env:ALIBABA_CLOUD_ACCESS_KEY_SECRET = "yourAccessKeySecret"

Gunakan SDK

Topik ini menggunakan API SendMessageToGlobe dari Short Message Service (SMS) sebagai contoh. Untuk informasi lebih lanjut tentang API SendMessageToGlobe, lihat SendMessageToGlobe.

1. Inisialisasi klien permintaan

Dalam SDK, semua pemanggilan OpenAPI dimulai dari klien permintaan (Client). Sebelum memanggil OpenAPI, Anda harus menginisialisasi klien permintaan. Klien permintaan dapat diinisialisasi dengan berbagai cara. Contoh ini menunjukkan cara menggunakan AccessKey untuk menginisialisasi klien. Untuk informasi lebih lanjut tentang metode inisialisasi, lihat Kelola kredensial akses.

public static com.aliyun.dysmsapi20180501.Client createClient() throws Exception {
    com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
            // Wajib, pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah disetel.
            .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
            // Wajib, pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah disetel.
            .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
    // Lihat https://api.alibabacloud.com/product/Dysmsapi.
    config.endpoint = "dysmsapi.aliyuncs.com";
    return new com.aliyun.dysmsapi20180501.Client(config);
}

2. Buat objek permintaan

Saat memanggil OpenAPI, Anda dapat menggunakan objek permintaan yang disediakan oleh SDK untuk meneruskan parameter. Objek permintaan untuk OpenAPI dinamai dalam format <NamaOpenAPI>Request. Misalnya, objek permintaan untuk API SendSms adalah SendSmsRequest. Untuk informasi lebih lanjut tentang parameter permintaan, lihat dokumentasi API untuk SendMessageToGlobe.

com.aliyun.dysmsapi20180501.models.SendMessageToGlobeRequest sendMessageToGlobeRequest = new com.aliyun.dysmsapi20180501.models.SendMessageToGlobeRequest()
                .setTo("8521245567****")
                .setMessage("Hello");

3. Lakukan permintaan

Saat menggunakan klien permintaan untuk memanggil OpenAPI, kami merekomendasikan menggunakan fungsi dalam format <namaApi>WithOptions, di mana <namaApi> adalah nama OpenAPI dalam camel case. Fungsi ini memiliki dua parameter: objek permintaan dari langkah sebelumnya dan parameter runtime. Parameter runtime mengonfigurasi perilaku permintaan, seperti pengaturan timeout dan konfigurasi proxy. Untuk informasi lebih lanjut, lihat Konfigurasi lanjutan.

Objek tanggapan untuk OpenAPI dinamai dalam format <NamaOpenAPI>Response. Misalnya, objek tanggapan untuk API SendSms adalah SendSmsResponse.

com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
Client client = createClient();
// panggil api
client.sendMessageToGlobeWithOptions(sendMessageToGlobeRequest, runtime);

4. Tangani pengecualian

Java SDK mengklasifikasikan pengecualian menjadi `TeaUnretryableException` dan `TeaException`.

• `TeaUnretryableException`: Pengecualian ini biasanya disebabkan oleh masalah jaringan dan dilemparkan setelah jumlah maksimum percobaan ulang tercapai.

• `TeaException`: Pengecualian ini terutama disebabkan oleh kesalahan bisnis.

Untuk informasi lebih lanjut tentang penanganan pengecualian, lihat Penanganan pengecualian.

import com.aliyun.dysmsapi20180501.Client;
import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeRequest;
import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeResponse;
import com.aliyun.tea.TeaException;
import com.aliyun.tea.TeaUnretryableException;
import com.aliyun.teaopenapi.models.Config;
import com.aliyun.teautil.models.RuntimeOptions;
import com.google.gson.Gson;

public class Sample {
    public static Client createClient() throws Exception {
        Config config = new Config()
                // Wajib, pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah disetel.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Wajib, pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah disetel.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        // Lihat https://api.alibabacloud.com/product/Dysmsapi.
        config.endpoint = "dysmsapi.aliyuncs.com";
        return new Client(config);
    }

    public static void main(String[] args_) {
        try {
            Client client = Sample.createClient();
            SendMessageToGlobeRequest sendMessageToGlobeRequest = new SendMessageToGlobeRequest()
                    .setTo("8521245567****")
                    .setMessage("Hello");
            RuntimeOptions runtime = new RuntimeOptions();

            SendMessageToGlobeResponse sendMessageToGlobeResponse = client.sendMessageToGlobeWithOptions(sendMessageToGlobeRequest, runtime);
            System.out.println(new Gson().toJson(sendMessageToGlobeResponse.body));
        } catch (TeaUnretryableException ue) {
            // Hanya contoh pencetakan. Harap berhati-hati dalam penanganan pengecualian dan jangan mengabaikan pengecualian secara langsung dalam proyek rekayasa.
            ue.printStackTrace();
            // cetak pesan kesalahan
            System.out.println(ue.getMessage());
            System.out.println(ue.getLastRequest());
        } catch (TeaException e) {
            // Hanya contoh pencetakan. Harap berhati-hati dalam penanganan pengecualian dan jangan mengabaikan pengecualian secara langsung dalam proyek rekayasa.
            e.printStackTrace();
            // cetak pesan kesalahan
            System.out.println(e.getCode());
            System.out.println(e.getMessage());
            System.out.println(e.getData());
        } catch (Exception e) {
            // Hanya contoh pencetakan. Harap berhati-hati dalam penanganan pengecualian dan jangan mengabaikan pengecualian secara langsung dalam proyek rekayasa.
            e.printStackTrace();
        }
    }
}

/**
 * <dependency>
 *   <groupId>com.aliyun</groupId>
 *   <artifactId>facebody20191230</artifactId>
 *   <version>5.1.2</version>
 * </dependency>
 */

import com.aliyun.tea.*;
import com.google.gson.Gson;
import java.nio.file.Files;
import java.nio.file.Paths;

public class Sample {

    public static com.aliyun.facebody20191230.Client createClient() throws Exception {
        com.aliyun.teaopenapi.models.Config config = new com.aliyun.teaopenapi.models.Config()
                // Wajib. System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID") mendapatkan ID AccessKey dari variabel lingkungan.
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // Wajib. System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET") mendapatkan Rahasia AccessKey dari variabel lingkungan.
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));
        config.regionId = "cn-shanghai";
        config.endpoint = "facebody.cn-shanghai.aliyuncs.com";
        return new com.aliyun.facebody20191230.Client(config);
    }

    public static void main(String[] args_) {
        try {
            com.aliyun.facebody20191230.Client client = Sample.createClient();
            com.aliyun.facebody20191230.models.DetectBodyCountAdvanceRequest detectBodyCountAdvance = new com.aliyun.facebody20191230.models.DetectBodyCountAdvanceRequest()
                    .setImageURLObject(Files.newInputStream(Paths.get("<FILE_PATH>")));  // Ganti <FILE_PATH> dengan path file sebenarnya.
            com.aliyun.teautil.models.RuntimeOptions runtime = new com.aliyun.teautil.models.RuntimeOptions();
            com.aliyun.facebody20191230.models.DetectBodyCountResponse resp = client.detectBodyCountAdvance(detectBodyCountAdvance, runtime);
            System.out.println(new Gson().toJson(resp.body));
        } catch (TeaUnretryableException ue) {
            ue.printStackTrace();
            // Cetak pesan kesalahan.
            System.out.println(ue.getMessage());
            // Cetak catatan permintaan untuk menanyakan informasi permintaan saat terjadi kesalahan.
            System.out.println(ue.getLastRequest());
        } catch (TeaException e) {
            e.printStackTrace();
            // Cetak kode kesalahan.
            System.out.println(e.getCode());
            // Cetak pesan kesalahan, yang mencakup RequestId.
            System.out.println(e.getMessage());
            // Cetak konten kesalahan spesifik yang dikembalikan oleh server.
            System.out.println(e.getData());
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

FAQ

• Pesan kesalahan "You are not authorized to perform this operation." dikembalikan saat saya memanggil OpenAPI.

  Penyebab: Pengguna Resource Access Management (RAM) yang sesuai dengan AccessKey yang Anda gunakan tidak memiliki izin untuk memanggil API tersebut.

  Solusi: Berikan izin OpenAPI yang diperlukan kepada pengguna RAM. Untuk informasi lebih lanjut tentang cara memberikan izin kepada pengguna RAM, lihat Berikan izin kepada pengguna RAM.

  Sebagai contoh, jika kesalahan "You are not authorized to perform this operation." dikembalikan saat Anda memanggil SendMessageToGlobe, Anda dapat membuat kebijakan kustom berikut dan memberikan izin yang sesuai kepada pengguna RAM.

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": "dysms:SendMessageToGlobe",
        "Resource": "*"
      }
    ]
  }

• Pesan kesalahan "The specified endpoint can't operate this region." dikembalikan saat saya memanggil OpenAPI.

  Penyebab: OpenAPI yang Anda panggil tidak mendukung titik akhir yang Anda tentukan saat menginisialisasi klien permintaan.

  Solusi: Lihat Konfigurasi titik akhir, ubah titik akhir, lalu panggil kembali OpenAPI.

• Pesan kesalahan "java.lang.NullPointerException..." dikembalikan saat saya memanggil OpenAPI.

  Penyebab: AccessKey Anda tidak diteruskan dengan benar.

  Solusi: Saat menginisialisasi klien permintaan, periksa apakah AccessKey diteruskan dengan benar. Perhatikan bahwa System.getenv("XXX") mengambil nilai XXX dari variabel lingkungan.

Untuk solusi lebih lanjut mengenai kesalahan yang terjadi saat menggunakan SDK, lihat FAQ.