Alibaba Cloud SDK:Integración del SDK

1. Inicie sesión en SDK Center y seleccione el producto cuya API desea llamar, por ejemplo, Short Message Service (SMS).

2. En la página Installation. Luego, en All Languages, seleccione Go. En la pestaña Quick Start encontrará el método de instalación del SDK para Short Message Service (SMS).

   Comando para instalar la biblioteca principal del SDK: go get github.com/alibabacloud-go/darabonba-openapi/v2/client. Comando para instalar el SDK de Short Message Service (SMS): go get github.com/alibabacloud-go/dysmsapi-20170525/v4. Repositorio de código fuente y de la versión: https://github.com/alibabacloud-go/dysmsapi-20170525/.

import (
  "os"

  openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  dysmsapi20180501 "github.com/alibabacloud-go/dysmsapi-20180501/v2/client"
  "github.com/alibabacloud-go/tea/tea"
)

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
}

Escenario especial: configuración de la API Advance para cargar archivos

Cuando utiliza productos en la nube como Image Search y Visual Intelligence API para procesar imágenes locales o cargar imágenes, las operaciones de OpenAPI descritas en la documentación oficial no permiten cargar archivos directamente. Para cargar un archivo, utilice la API Advance del producto en la nube, la cual admite el paso de un objeto de flujo de archivo. El mecanismo subyacente funciona así: el producto almacena temporalmente el archivo cargado en Alibaba Cloud OSS, en la región de almacenamiento predeterminada cn-shanghai, e implementa la función correspondiente leyendo dicho archivo temporal desde ese servicio de OSS. Este ejemplo utiliza la API DetectBodyCount de Visual Intelligence API. A continuación se detalla el procedimiento.

1. Inicializar el cliente de solicitud

   Tenga en cuenta que debe configurar tanto RegionId como el Endpoint del producto en la nube. El parámetro RegionId especifica la región donde se almacenará el archivo temporal en OSS. Si no establece RegionId, podrían producirse tiempos de espera agotados al llamar a la operación de OpenAPI, dado que el producto en la nube y OSS podrían encontrarse en regiones distintas.

   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. Crear una instancia de la estructura AdvanceRequest

   Al cargar un archivo local, debe utilizar la estructura AdvanceRequest proporcionada por el SDK para pasar el flujo del archivo. El formato de nombre de esta estructura es <OpenAPI name>AdvanceRequest. Para identificar el nombre del parámetro que recibe el flujo, busque aquel cuyo tipo sea io.Reader dentro de la estructura AdvanceRequest correspondiente.

   // 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 la solicitud

   Llame a la función <API name>Advance para enviar la solicitud. El parámetro de entrada es un puntero a la estructura 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)
}

Preguntas frecuentes

1. Al llamar a una operación de OpenAPI, se devuelve el mensaje de error "You are not authorized to perform this operation".

   Causa y solución

   Causa: el usuario de Resource Access Management (RAM) asociado a su AccessKey no cuenta con los permisos necesarios para llamar a la API.

   Solución: otorgue al usuario de RAM los permisos de OpenAPI requeridos. Para saber cómo conceder permisos a un usuario de RAM, consulte Manage RAM user permissions.

   Por ejemplo, si aparece el error "You are not authorized to perform this operation" al llamar a la API SendMessageToGlobe, cree una política de acceso personalizada y asígnela al usuario de RAM.

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

2. Al llamar a una operación de OpenAPI, se devuelve el mensaje de error "SDKError: Message: Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host".

   Causa y solución

   Causa: el endpoint especificado durante la inicialización del cliente no es compatible con la operación de OpenAPI que intenta llamar.

   Solución: consulte Configure endpoints. Modifique el endpoint y vuelva a llamar a la operación de OpenAPI.

3. Al llamar a una operación de OpenAPI, se devuelve el mensaje de error "SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found.".

   Causa y solución

   Causa: su AccessKey no se pasó correctamente.

   Solución: compruebe si la AccessKey se transmite de forma adecuada al inicializar el cliente de solicitud. Tenga en cuenta que os.Getenv("XXX") recupera el valor de XXX desde las variables de entorno.

Para conocer las soluciones a otros errores que pueden presentarse al usar el SDK, consulte FAQ.