Alibaba Cloud SDK：整合SDK

1. 登入SDK Center，選擇將要使用產品，例如您將要調用Short Message Service (SMS)的API。

2. 在安裝頁面，所有語言選擇Go。然後在快速入門頁簽中，您可以擷取Short Message Service (SMS)的SDK安裝方式。

特殊情境：檔案上傳Advance介面配置

在使用Image Search、視覺智能開放平台等雲產品處理本地圖片或上傳圖片時，官方文檔中提供的OpenAPI介面不支援直接上傳檔案。若需上傳檔案，可以使用雲產品提供的Advance介面，該介面支援傳遞檔案流對象。其底層實現機製為：雲產品會將上傳的檔案臨時儲存於阿里雲OSS上，預設儲存地區為cn-shanghai，並通過讀取該OSS中的臨時檔案來實現相關功能。以阿里雲提供的視覺智能開放平台-人臉人體的DetectBodyCount介面為例：

1. 初始化請求用戶端

   請注意需同時設定RegionId和雲產品的Endpoint。其中，RegionId表示臨時檔案在OSS中所儲存的地區。如果未設定RegionId，可能會由於雲產品與OSS所在地區不同，導致在調用OpenAPI時出現逾時等問題。

   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{
       // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
       AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
       // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
       AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
     }
     // endpoint 和 regionId 需設定為同一地區
     config.RegionId = tea.String("cn-shanghai")
     config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
     _result, _err = facebody20191230.NewClient(config)
     return _result, _err
   }

2. 建立AdvanceRequest結構體執行個體

   在上傳本地檔案時，需要通過SDK提供的AdvanceRequest結構體來傳遞檔案流。AdvanceRequest結構體命名格式為<OpenAPI名稱>AdvanceRequest，關於傳遞檔案流的參數名，請在相應的AdvanceRequest結構體中尋找參數類型為io.Reader的參數。

   // 需替換檔案路徑
   filePath := `<FILE_PATH>`
   // 開啟檔案並建立流
   file, err := os.Open(filePath)
   if err != nil {
     return fmt.Errorf("開啟檔案失敗: %v", err)
   }
   defer file.Close() // 關閉檔案
   // 建立AdvanceRequest結構體執行個體
   detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
     ImageURLObject: file,
   }

3. 發起請求

   調用函數<介面名稱>Advance發起請求，入參為指向AdvanceRequest結構體的指標。

   //  需要在import中添加  util "github.com/alibabacloud-go/tea-utils/v2/service"
   
   func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
     client, _err := CreateClient()
     if _err != nil {
       return nil, _err
     }
   
     // 需替換檔案路徑
     filePath := `<FILE_PATH>`
     // 開啟檔案並建立流
     file, err := os.Open(filePath)
     if err != nil {
       return nil, fmt.Errorf("開啟檔案失敗: %v", err)
     }
     defer file.Close() // 關閉檔案
     // 建立請求對象
     detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
       ImageURLObject: file,
     }
     runtime := &util.RuntimeOptions{}
     // 發起請求
     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{
    // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
    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
  }

  // 需替換檔案路徑
  filePath := `<FILE_PATH>`
  // 開啟檔案並建立流
  file, err := os.Open(filePath)
  if err != nil {
    return nil, fmt.Errorf("開啟檔案失敗: %v", err)
  }
  defer file.Close() // 關閉檔案
  // 建立請求對象
  detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
    ImageURLObject: file,
  }
  runtime := &util.RuntimeOptions{}
  // 發起請求
  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)
}

常見問題

1. 調用OpenAPI時報錯，提示“You are not authorized to perform this operation”。

   問題原因及解決方案

   問題原因：您所使用的AccessKey對應的RAM使用者沒有許可權調用該API。

   解決方案：請為該RAM使用者授予相應OpenAPI許可權。關於如何為RAM使用者進行授權，請參見為RAM使用者授權。

   例如，當您在調用SendMessageToGlobe時提示“You are not authorized to perform this operation”，您可以建立如下所示的自訂權限原則，並為該RAM使用者授予相應的許可權。

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

2. 調用OpenAPI時報錯，提示 "SDKError：Message：Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host"。

   問題原因及解決方案

   問題原因：您所調用的OpenAPI不支援在初始化請求用戶端時填寫的Endpoint。

   解決方案：請查看Endpoint配置，修改Endpoint後重新調用OpenAPI。

3. 調用OpenAPI時報錯，提示：“SDKError: StatusCode: 404 Code：InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found. ”。

   問題原因及解決方案

   問題原因：您的AccessKey未正確傳遞。

   解決方案：在初始化請求用戶端時，檢查是否正確傳遞AccessKey。請注意os.Getenv("XXX")表示從環境變數中擷取XXX的值。

更多SDK使用過程中的報錯問題解決方案，請參見常見問題。