Alibaba Cloud SDK：Integrasikan SDK

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

2. Pada halaman Install, dan untuk All Languages, pilih Go. Kemudian, pada tab Quick Start, Anda dapat menemukan metode instalasi SDK untuk Short Message Service (SMS).

Skenario khusus: Unggah file melalui operasi Advance

Saat menggunakan Image Search atau Visual Intelligence API (VIAPI) untuk memproses citra di mesin 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), dan membaca file sementara tersebut dari OSS bila diperlukan. Wilayah default OSS adalah cn-shanghai. Contoh berikut menunjukkan cara memanggil operasi DetectBodyCount VIAPI:

1. Inisialisasi klien permintaan

   Pastikan bahwa 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.

   import (
     "os"
   
     openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
     facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v5/client"
     "github.com/alibabacloud-go/tea/tea"
   )
   
   func CreateClient() (_result *facebody20191230.Client, _err error) {
     config := &openapi.Config{
       // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah disetel di lingkungan runtime Anda.
       AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
       // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah disetel di lingkungan runtime Anda.
       AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
     }
     // Titik akhir dan regionId harus disetel ke wilayah yang sama.
     config.RegionId = tea.String("cn-shanghai")
     config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
     _result, _err = facebody20191230.NewClient(config)
     return _result, _err
   }

2. Buat instans struct AdvanceRequest

   Saat mengunggah file lokal, Anda harus menggunakan struct AdvanceRequest yang disediakan oleh SDK untuk meneruskan aliran file. Format penamaan untuk struct AdvanceRequest adalah <Nama operasi OpenAPI>AdvanceRequest. Untuk menemukan nama parameter untuk meneruskan aliran file, carilah parameter bertipe io.Reader dalam struct AdvanceRequest yang sesuai.

   // Ganti dengan path file.
   filePath := `<FILE_PATH>`
   // Buka file dan buat aliran.
   file, err := os.Open(filePath)
   if err != nil {
     return fmt.Errorf("Gagal membuka file: %v", err)
   }
   defer file.Close() // Tutup file.
   // Buat instans struct AdvanceRequest.
   detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
     ImageURLObject: file,
   }

3. Memulai permintaan

   Panggil fungsi <Nama Operasi>Advance untuk memulai permintaan. Parameter inputnya adalah pointer ke struct AdvanceRequest.

   // Anda perlu menambahkan 'util "github.com/alibabacloud-go/tea-utils/v2/service"' ke pernyataan import.
   
   func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
     client, _err := CreateClient()
     if _err != nil {
       return nil, _err
     }
   
     // Ganti dengan path file.
     filePath := `<FILE_PATH>`
     // Buka file dan buat aliran.
     file, err := os.Open(filePath)
     if err != nil {
       return nil, fmt.Errorf("Gagal membuka file: %v", err)
     }
     defer file.Close() // Tutup file.
     // Buat objek request.
     detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
       ImageURLObject: file,
     }
     runtime := &util.RuntimeOptions{}
     // Memulai permintaan.
     response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
   
     if _err != nil {
       return nil, _err
     }
     return response, nil
   }

package main

import (
  "fmt"
  "os"

  openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v5/client"
  util "github.com/alibabacloud-go/tea-utils/v2/service"
  "github.com/alibabacloud-go/tea/tea"
)

func CreateClient() (_result *facebody20191230.Client, _err error) {

  config := &openapi.Config{
    // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah disetel di lingkungan runtime Anda.
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah disetel di lingkungan runtime Anda.
    AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
  }
  config.RegionId = tea.String("cn-shanghai")
  config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
  _result, _err = facebody20191230.NewClient(config)
  return _result, _err
}

func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
  client, _err := CreateClient()
  if _err != nil {
    return nil, _err
  }

  // Ganti dengan path file.
  filePath := `<FILE_PATH>`
  // Buka file dan buat aliran.
  file, err := os.Open(filePath)
  if err != nil {
    return nil, fmt.Errorf("Gagal membuka file: %v", err)
  }
  defer file.Close() // Tutup file.
  // Buat objek request.
  detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
    ImageURLObject: file,
  }
  runtime := &util.RuntimeOptions{}
  // Memulai permintaan.
  response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)

  if _err != nil {
    return nil, _err
  }
  return response, nil
}
func main() {
  response, err := _main()
  if err != nil {
    panic(err)
  }
  fmt.Println(response)
}

FAQ

1. Bagaimana cara menangani error "You are not authorized to perform this operation" yang dilemparkan oleh operasi API?

   Kemungkinan penyebab dan solusi

   Kemungkinan penyebab: Pasangan AccessKey milik pengguna Resource Access Management (RAM) tidak memiliki izin untuk memanggil operasi API tersebut.

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

   Sebagai contoh, 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": "*"
       }
     ]
   }

2. Bagaimana cara menangani error "SDKError: Message: Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host" yang dilemparkan oleh operasi API?

   Kemungkinan penyebab dan solusi

   Kemungkinan penyebab: Operasi API tidak mendukung titik akhir yang Anda tentukan saat menginisialisasi klien permintaan.

   Solusi: Tentukan titik akhir yang didukung dan coba lagi. Untuk informasi lebih lanjut, lihat Konfigurasikan titik akhir.

3. Bagaimana cara menangani error "SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found" yang dilemparkan oleh operasi API?

   Kemungkinan penyebab dan solusi

   Kemungkinan penyebab: Pasangan AccessKey tidak diteruskan dengan benar ke permintaan.

   Solusi: Pastikan Pasangan AccessKey diteruskan dengan benar saat Anda menginisialisasi klien permintaan. Nilai XXX dari os.Getenv("XXX") diperoleh dari variabel lingkungan.

Untuk informasi lebih lanjut tentang cara menangani error SDK, lihat FAQ.