Alibaba Cloud SDK:Integrar o SDK

1. Faça logon no SDK Center e selecione o product correspondente à API que deseja chamar, como o Short Message Service (SMS).

2. Na página Installation e, em All Languages, escolha Go. Em seguida, na aba Quick Start, localize o método de instalação do SDK para o Short Message Service (SMS).

import (
  openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  dysmsapi20180501 "github.com/alibabacloud-go/dysmsapi-20180501/v2/client"
  util "github.com/alibabacloud-go/tea-utils/v2/service"
  "os"
)

func CreateClient () (_result *dysmsapi20180501.Client, _err error) {
  config := &openapi.Config{
    // Required, please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID is set.
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // Required, please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_SECRET is set.
    AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
  }
  config.Endpoint = tea.String("dysmsapi.aliyuncs.com")
  _result = &dysmsapi20180501.Client{}
  _result, _err = dysmsapi20180501.NewClient(config)
  return _result, _err
}

// Create request object and set required input parameters
sendMessageToGlobeRequest := &dysmsapi20180501.SendMessageToGlobeRequest{
  // Please replace with the actual recipient number.
  To: tea.String("<YOUR_VALUE>"),
  // Please replace with the actual SMS content.
  Message: tea.String("<YOUR_VALUE>"),
}

//  You need to add util "github.com/alibabacloud-go/tea-utils/v2/service" to the import. 

func _main() (_result *dysmsapi20180501.SendMessageToGlobeResponse, _err error) {
  client, _err := CreateClient()
  if _err != nil {
    return nil, _err
  }
  // Create request object and set required input parameters
  sendMessageToGlobeRequest := &dysmsapi20180501.SendMessageToGlobeRequest{
    // Please replace with the actual recipient number.
    To: tea.String("<YOUR_VALUE>"),
    // Please replace with the actual SMS content.
    Message: tea.String("<YOUR_VALUE>"),
  }
  runtime := &util.RuntimeOptions{}
  // To run the code, copy it and print the API return value.
  response, _err := client.SendMessageToGlobeWithOptions(sendMessageToGlobeRequest, runtime)
  if _err != nil {
    return nil, _err
  }
  return response, _err
}

Cenário especial: Configurar a API Advance para upload de arquivos

Alguns produtos cloud (como Image Search e Visual Intelligence API) exigem a API Advance para uploads de arquivos locais. Essa API aceita um stream de arquivo, armazena-o temporariamente no Alibaba Cloud OSS (região padrão: cn-shanghai) e o processa. Este exemplo utiliza a API DetectBodyCount do Visual Intelligence API.

1. 1. Inicializar o cliente de requisição

   Defina tanto RegionId quanto Endpoint. O RegionId especifica a região do OSS para armazenamento temporário de arquivos. A omissão do RegionId pode causar timeouts se o product e o OSS estiverem em regiões diferentes.

   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{
       // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
       AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
       // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
       AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
     }
     // The endpoint and regionId must be set to the same region.
     config.RegionId = tea.String("cn-shanghai")
     config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
     _result, _err = facebody20191230.NewClient(config)
     return _result, _err
   }

2. Criar uma instância da struct AdvanceRequest

   Utilize a struct AdvanceRequest (denominada <NomeDaAPI>AdvanceRequest) para passar o stream do arquivo. O parâmetro de stream de arquivo possui o tipo io.Reader.

   // Replace with the file path.
   filePath := `<FILE_PATH>`
   // Open the file and create a stream.
   file, err := os.Open(filePath)
   if err != nil {
     return fmt.Errorf("Failed to open file: %v", err)
   }
   defer file.Close() // Close the file.
   // Create an AdvanceRequest struct instance.
   detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
     ImageURLObject: file,
   }

3. Enviar uma requisição

   Chame <NomeDaAPI>Advance com um ponteiro para a struct AdvanceRequest.

   // You need to add util "github.com/alibabacloud-go/tea-utils/v2/service" to the import.
   
   func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
     client, _err := CreateClient()
     if _err != nil {
       return nil, _err
     }
   
     // Replace with the file path.
     filePath := `<FILE_PATH>`
     // Open the file and create a stream.
     file, err := os.Open(filePath)
     if err != nil {
       return nil, fmt.Errorf("Failed to open file: %v", err)
     }
     defer file.Close() // Close the file.
     // Create a request object.
     detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
       ImageURLObject: file,
     }
     runtime := &util.RuntimeOptions{}
     // Send the request.
     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{
    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
    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
  }

  // Replace with the file path.
  filePath := `<FILE_PATH>`
  // Open the file and create a stream.
  file, err := os.Open(filePath)
  if err != nil {
    return nil, fmt.Errorf("Failed to open file: %v", err)
  }
  defer file.Close() // Close the file.
  // Create a request object.
  detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
    ImageURLObject: file,
  }
  runtime := &util.RuntimeOptions{}
  // Send the request.
  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)
}

Perguntas frequentes

1. A mensagem de erro "You are not authorized to perform this operation" é retornada ao chamar uma OpenAPI.

   Causa e solução

   Causa: O usuário do Resource Access Management (ram) associado ao seu AccessKey não possui as permissões necessárias para chamar a API.

   Solução: Conceda as permissões necessárias da OpenAPI ao usuário ram. Manage RAM user permissions.

   Por exemplo, se esse erro ocorrer ao chamar a API SendMessageToGlobe, crie uma política personalizada e atribua-a ao usuário ram:

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

2. A mensagem de erro "SDKError: Message: Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host" é retornada ao chamar uma OpenAPI.

   Causa e solução

   Causa: O Endpoint especificado durante a inicialização do cliente não é compatível com a OpenAPI chamada.

   Solução: Modifique o Endpoint e tente novamente. Configure endpoints.

3. A mensagem de erro "SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found." é retornada ao chamar uma OpenAPI.

   Causa e solução

   Causa: O AccessKey não foi passado corretamente.

   Solução: Verifique se o AccessKey foi transmitido corretamente durante a inicialização do cliente. os.Getenv("XXX") recupera o valor de XXX das variáveis de ambiente.

Outros erros comuns do SDK e suas soluções: FAQ.