Alibaba Cloud SDK：Integrasi SDK

1. Masuk ke SDK Center dan pilih layanan yang SDK-nya ingin Anda gunakan. Pada contoh ini, Short Message Service (SMS) dipilih.

2. Pada halaman Short Message Service, lalu pilih C# pada bagian All languages. Pada tab Quick Start, dapatkan metode instalasi SDK Short Message Service (SMS).

Skenario khusus: Unggah file melalui operasi Advance

Saat menggunakan Image Search atau Visual Intelligence API (VIAPI) untuk memproses citra lokal atau mengunggah citra, API Image Search atau VIAPI yang dijelaskan dalam dokumentasi tidak mendukung unggahan langsung. Untuk mengunggah citra, Anda perlu menggunakan operasi Advance, yang mendukung transmisi aliran file. Layanan cloud menyimpan sementara file yang diunggah di Object Storage Service (OSS), lalu membaca file tersebut dari OSS bila diperlukan. Wilayah default OSS adalah cn-shanghai. Contoh berikut menunjukkan cara memanggil operasi DetectBodyCount VIAPI:

1. Inisialisasi klien permintaan

   Pastikan parameter RegionId dan endpoint layanan cloud keduanya ditentukan. RegionId menunjukkan wilayah OSS tempat file sementara disimpan. Jika Anda tidak mengonfigurasi parameter RegionId, layanan cloud mungkin menggunakan wilayah yang berbeda dari OSS, sehingga menyebabkan timeout API.

   public static AlibabaCloud.SDK.Facebody20191230.Client CreateClient()
   {
       AlibabaCloud.OpenApiClient.Models.Config config =
           new AlibabaCloud.OpenApiClient.Models.Config
           {
               // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_ID. 
               AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
               // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
               AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
           };
       config.RegionId = "cn-shanghai";
       config.Endpoint = "facebody.cn-shanghai.aliyuncs.com";
       return new AlibabaCloud.SDK.Facebody20191230.Client(config);
   }

2. Buat objek permintaan

   Buat objek permintaan <Operasi API>AdvanceRequest untuk meneruskan aliran file. Dalam objek permintaan, atur nama parameter menjadi ImageURLObject.

   AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest detectBodyCountAdvanceRequest =
       new AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest
       {
           ImageURLObject = File.OpenRead(@"<FILE_PATH>"), // Ganti <FILE_PATH> dengan path file aktual.
       };   

3. Kirim permintaan

   Panggil fungsi <Nama operasi API>Advance untuk mengirim permintaan.

   // Konfigurasikan parameter runtime.
   AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
   AlibabaCloud.SDK.Facebody20191230.Client client = CreateClient();
   // Kirim permintaan.
   AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountResponse response = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
   Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(response));

// dotnet add package AlibabaCloud.SDK.Facebody20191230 --version 4.1.2

using System;
using System.Collections;
using System.Collections.Generic;
using System.IO;
using System.Threading.Tasks;
using Tea;
using Tea.Utils;

namespace AlibabaCloud.SDK.Sample
{
    public class Sample
    {
        public static AlibabaCloud.SDK.Facebody20191230.Client CreateClient()
        {
            AlibabaCloud.OpenApiClient.Models.Config config =
                new AlibabaCloud.OpenApiClient.Models.Config
                {
                    // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_ID. 
                    AccessKeyId = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_ID"),
                    // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
                    AccessKeySecret = Environment.GetEnvironmentVariable("ALIBABA_CLOUD_ACCESS_KEY_SECRET"),
                };
            config.RegionId = "cn-shanghai";
            config.Endpoint = "facebody.cn-shanghai.aliyuncs.com";
            return new AlibabaCloud.SDK.Facebody20191230.Client(config);
        }

        public static void Main(string[] args)
        {
            try
            {
                AlibabaCloud.SDK.Facebody20191230.Client client = CreateClient();
                // Ganti <FILE_PATH> dengan path file aktual.
                using (FileStream fileStream = File.OpenRead(@"<FILE_PATH>"))
                {
                    AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest detectBodyCountAdvanceRequest =
                        new AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountAdvanceRequest
                        {
                            ImageURLObject = fileStream,
                        };
                    AlibabaCloud.TeaUtil.Models.RuntimeOptions runtime = new AlibabaCloud.TeaUtil.Models.RuntimeOptions();
                    AlibabaCloud.SDK.Facebody20191230.Models.DetectBodyCountResponse response =
                        client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
                    Console.WriteLine(AlibabaCloud.TeaUtil.Common.ToJSONString(response));
                }
            }
            catch (TeaException error)
            {
                // Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error messages displayed in this example are for reference only. 
                Console.WriteLine(error.Message);
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
            catch (Exception _error)
            {
                TeaException error = new TeaException(
                    new Dictionary<string, object> { { "message", _error.Message } }
                );
                // Handle exceptions with caution based on your actual business scenario and do not ignore exceptions in your project. The error messages displayed in this example are for reference only. 
                Console.WriteLine(error.Message);
                AlibabaCloud.TeaUtil.Common.AssertAsString(error.Message);
            }
        }
    }
}

FAQ

• Saat memanggil OpenAPI, Anda menerima pesan error 'You are not authorized to perform this operation'.

  Penyebab: Pasangan AccessKey yang digunakan oleh pengguna Resource Access Management (RAM) tidak memiliki izin untuk memanggil operasi API tersebut.

  Solusi: Berikan izin yang diperlukan kepada pengguna RAM. Untuk informasi selengkapnya, lihat Berikan izin kepada pengguna RAM.

  Misalnya, jika error "You are not authorized to perform this operation" dilemparkan oleh operasi API SendMessageToGlobe, buat kebijakan kustom berikut untuk memberikan izin yang diperlukan kepada pengguna RAM:

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

• Memanggil OpenAPI mengembalikan error berikut: "System.UnretryableException: One or more errors occurred."

  Penyebab: Operasi API tidak mendukung endpoint yang Anda tentukan saat menginisialisasi client permintaan.

  Solusi: Tentukan endpoint yang didukung dan coba lagi. Untuk informasi selengkapnya, lihat Konfigurasikan endpoint.

• Pemanggilan OpenAPI mengembalikan error berikut: `ErrorCode":"InvalidAccessKeyId.NotFound","ErrorMessage":"Specified access key is not found."`.

  Penyebab: Pasangan AccessKey tidak diteruskan dengan benar ke permintaan.

  Solusi: Pastikan pasangan AccessKey diteruskan dengan benar saat menginisialisasi client permintaan. Environment.GetEnvironmentVariable("XXX") menunjukkan bahwa nilai XXX diambil dari variabel lingkungan.

Untuk informasi selengkapnya mengenai penanganan error SDK, lihat FAQ.