Alibaba Cloud SDK:Integrasikan SDK

1. Masuk ke SDK Center dan pilih produk untuk API yang ingin Anda panggil, seperti Short Message Service (SMS).

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

Skenario khusus: Konfigurasikan API Advance untuk unggah file

Beberapa produk cloud (seperti Image Search dan Visual Intelligence API) memerlukan API Advance untuk unggah file lokal. API ini menerima aliran file, menyimpan file tersebut sementara di Alibaba Cloud OSS (wilayah default: cn-shanghai), lalu memprosesnya. Contoh ini menggunakan API DetectBodyCount dari Visual Intelligence API.

1. 1. Inisialisasi klien permintaan

   Atur baik RegionId maupun Endpoint. RegionId menentukan wilayah OSS untuk penyimpanan file sementara. Mengabaikan RegionId dapat menyebabkan timeout jika produk dan OSS berada di wilayah berbeda.

   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 diatur.
       AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
       // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET diatur.
       AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
     }
     // Titik akhir dan regionId harus diatur 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

   Gunakan struct AdvanceRequest (bernama <NamaAPI>AdvanceRequest) untuk meneruskan aliran file. Parameter aliran file bertipe io.Reader.

   // 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. Kirim permintaan

   Panggil <NamaAPI>Advance dengan pointer ke struct AdvanceRequest.

   // Anda perlu menambahkan util "github.com/alibabacloud-go/tea-utils/v2/service" ke impor.
   
   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 permintaan.
     detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
       ImageURLObject: file,
     }
     runtime := &util.RuntimeOptions{}
     // Kirim 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 diatur.
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET diatur.
    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 permintaan.
  detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
    ImageURLObject: file,
  }
  runtime := &util.RuntimeOptions{}
  // Kirim 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. Pesan error "You are not authorized to perform this operation" dikembalikan saat saya memanggil OpenAPI.

   Penyebab dan solusi

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

   Solusi: Berikan izin OpenAPI yang diperlukan kepada pengguna RAM. Kelola izin pengguna RAM.

   Sebagai contoh, jika error ini terjadi saat memanggil API SendMessageToGlobe, buat kebijakan kustom dan berikan ke pengguna RAM:

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

2. Pesan error "SDKError: Message: Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host" dikembalikan saat saya memanggil OpenAPI.

   Penyebab dan solusi

   Penyebab: Titik akhir (Endpoint) yang Anda tentukan saat inisialisasi klien tidak didukung oleh OpenAPI yang Anda panggil.

   Solusi: Ubah Titik akhir dan coba lagi. Konfigurasikan titik akhir.

3. Pesan error "SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found." dikembalikan saat saya memanggil OpenAPI.

   Penyebab dan solusi

   Penyebab: AccessKey tidak diteruskan dengan benar.

   Solusi: Verifikasi bahwa AccessKey diteruskan dengan benar saat inisialisasi klien. os.Getenv("XXX") mengambil nilai XXX dari variabel lingkungan.

Error SDK umum lainnya dan solusinya: FAQ.