Alibaba Cloud SDK:Integre o SDK

1. Acesse o SDK Center e selecione o product cuja API deseja chamar, como o Short Message Service (SMS).

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

   Para o SDK, instale a biblioteca principal com o comando: go get github.com/alibabacloud-go/darabonba-openapi/v2/client. Para o Short Message Service (SMS), instale o SDK com o comando: go get github.com/alibabacloud-go/dysmsapi-20170525/v4. Repositório de releases e código-fonte: https://github.com/alibabacloud-go/dysmsapi-20170525/.

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

Ao usar cloud products como Image Search e Visual Intelligence API para processar imagens locais ou fazer upload de imagens, as operações da openapi fornecidas na documentação oficial não oferecem suporte ao upload direto de arquivos. Para fazer o upload de um arquivo, use a API Advance fornecida pelo cloud product, que aceita um objeto de fluxo de arquivo. O mecanismo subjacente é o seguinte: o cloud product armazena temporariamente o arquivo enviado no Alibaba Cloud OSS (a região de armazenamento padrão é cn-shanghai) e implementa o recurso relacionado lendo o arquivo temporário desse OSS. Este exemplo usa a API DetectBodyCount do Visual Intelligence API. O procedimento é descrito a seguir.

1. Inicialize o client de requisição

   Defina tanto o RegionId quanto o Endpoint do cloud product. O RegionId especifica a região onde o arquivo temporário é armazenado no OSS. Se o RegionId não for definido, podem ocorrer tempos limite ao chamar a operação da openapi, pois o cloud product e o OSS podem estar 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. Crie uma instância da struct AdvanceRequest

   Ao fazer o upload de um arquivo local, use a struct AdvanceRequest fornecida pelo SDK para passar o fluxo do arquivo. O formato de nomenclatura da struct AdvanceRequest é <OpenAPI name>AdvanceRequest. Para identificar o parâmetro que recebe o fluxo do arquivo, busque o parâmetro do tipo io.Reader na struct AdvanceRequest correspondente.

   // 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. Envie a requisição

   Chame a função <API name>Advance para enviar a requisição. O parâmetro de entrada é 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)
}

FAQ

1. A mensagem de erro "You are not authorized to perform this operation" é exibida ao chamar uma operação da openapi.

   Causa e solução

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

   Solução: Conceda as permissões necessárias da openapi ao usuário do RAM. Para obter informações sobre como conceder permissões a um usuário do RAM, consulte Manage RAM user permissions.

   Por exemplo, se o erro "You are not authorized to perform this operation" ocorrer ao chamar a API SendMessageToGlobe, crie uma política de acesso personalizada e conceda-a ao usuário do 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" é exibida ao chamar uma operação da openapi.

   Causa e solução

   Causa: O Endpoint especificado durante a inicialização do client não é compatível com a operação da openapi chamada.

   Solução: Consulte Configure endpoints. Modifique o Endpoint e chame a operação da openapi novamente.

3. A mensagem de erro "SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found." é exibida ao chamar uma operação da openapi.

   Causa e solução

   Causa: O AccessKey não foi passado corretamente.

   Solução: Verifique se o AccessKey foi passado corretamente ao inicializar o client de requisição. Note que os.Getenv("XXX") recupera o valor de XXX das variáveis de ambiente.

Para obter soluções para outros erros ao usar o SDK, consulte FAQ.