Alibaba Cloud SDK:Intégrer le SDK

1. Connectez-vous au SDK Center et sélectionnez le produit dont vous souhaitez appeler l'API, par exemple Short Message Service (SMS).

2. Sur la page Installation, puis pour All Languages, sélectionnez Go. Dans l'onglet Quick Start, vous pouvez obtenir la méthode d'installation du SDK pour Short Message Service (SMS).

   Commande pour installer la bibliothèque principale du SDK : go get github.com/alibabacloud-go/darabonba-openapi/v2/client. Commande pour installer le SDK Short Message Service (SMS) : go get github.com/alibabacloud-go/dysmsapi-20170525/v4. Dépôt des versions et du code source : 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
}

Scénario spécial : Configurer l'API Advance pour les téléchargements de fichiers

Lorsque vous utilisez des produits cloud tels que Image Search et Visual Intelligence API pour traiter des images locales ou télécharger des images, les opérations OpenAPI fournies dans la documentation officielle ne prennent pas en charge le téléchargement direct de fichiers. Pour télécharger un fichier, vous pouvez utiliser l'API Advance fournie par le produit cloud, qui prend en charge le passage d'un objet de flux de fichier. Le mécanisme sous-jacent est le suivant : le produit cloud stocke temporairement le fichier téléchargé dans Alibaba Cloud OSS, la région de stockage par défaut étant cn-shanghai, et implémente la fonctionnalité associée en lisant le fichier temporaire depuis cet OSS. Cet exemple utilise l'API DetectBodyCount de Visual Intelligence API, et la procédure est la suivante.

1. Initialiser le client de requête

   Notez que vous devez définir à la fois RegionId et l'Endpoint du produit cloud. RegionId spécifie la région où le fichier temporaire est stocké dans OSS. Si RegionId n'est pas défini, des délais d'attente peuvent se produire lors de l'appel à l'opération OpenAPI, car le produit cloud et OSS peuvent se trouver dans des régions différentes.

   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. Créer une instance de structure AdvanceRequest

   Lorsque vous téléchargez un fichier local, vous devez utiliser la structure AdvanceRequest fournie par le SDK pour transmettre le flux de fichier. Le format de nommage de la structure AdvanceRequest est <OpenAPI name>AdvanceRequest. Pour le nom du paramètre qui transmet le flux de fichier, recherchez le paramètre dont le type est io.Reader dans la structure AdvanceRequest correspondante.

   // 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. Envoyer la requête

   Appelez la fonction <API name>Advance pour envoyer la requête. Le paramètre d'entrée est un pointeur vers la structure 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. Le message d'erreur « You are not authorized to perform this operation » est renvoyé lors de l'appel à une opération OpenAPI.

   Cause et solution

   Cause : l'utilisateur Resource Access Management (RAM) correspondant à votre AccessKey ne dispose pas des autorisations requises pour appeler l'API.

   Solution : accordez les autorisations OpenAPI requises à l'utilisateur RAM. Pour savoir comment accorder des autorisations à un utilisateur RAM, consultez la section Gérer les autorisations des utilisateurs RAM.

   Par exemple, si l'erreur « You are not authorized to perform this operation » se produit lors de l'appel à l'API SendMessageToGlobe, vous pouvez créer une politique d'accès personnalisée et l'accorder à l'utilisateur RAM.

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

2. Le message d'erreur « SDKError: Message: Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host » est renvoyé lors de l'appel à une opération OpenAPI.

   Cause et solution

   Cause : l'Endpoint que vous avez spécifié lors de l'initialisation du client n'est pas pris en charge par l'opération OpenAPI que vous appelez.

   Solution : consultez la section Configurer les endpoints. Modifiez l'Endpoint et appelez à nouveau l'opération OpenAPI.

3. Le message d'erreur « SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found. » est renvoyé lors de l'appel à une opération OpenAPI.

   Cause et solution

   Cause : votre AccessKey n'a pas été transmis correctement.

   Solution : vérifiez si l'AccessKey est transmis correctement lors de l'initialisation du client de requête. Notez que os.Getenv("XXX") récupère la valeur de XXX à partir des variables d'environnement.

Pour des solutions à davantage d'erreurs survenant lors de l'utilisation du SDK, consultez la section FAQ.