Alibaba Cloud SDK:Intégrer le SDK

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

2. Sur la page Installation et All Languages sur TypeScript. Ensuite, dans l'onglet Quick Start, vous trouverez les instructions d'installation du SDK pour Short Message Service (SMS).

Téléchargement de fichiers avec les opérations Advance

Certaines API (telles que la recherche d'images et Visual Intelligence) n'acceptent pas directement les chemins de fichiers locaux. Utilisez l'opération Advance pour télécharger des fichiers via un flux. Le SDK stocke temporairement le fichier dans un bucket OSS dans la région cn-shanghai, et le service le lit à partir de cet emplacement. Cet exemple utilise l'opération DetectBodyCount de l'API Visual Intelligence.

1. Initialiser le client de requête

   Définissez regionId et endpoint sur la même région. La valeur regionId détermine l'emplacement de stockage du fichier OSS temporaire. Si vous omettez regionId, une incompatibilité de région entre le produit et le bucket OSS entraîne des délais d'expiration.

   Exemple TypeScript

   function createClient(): facebody20191230 {
       let config = new $OpenApi.Config({
           // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
           accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
           // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
           accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });
       // The endpoint and regionId must be for the same region.
       config.regionId = 'cn-shanghai';
       config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
       return new facebody20191230(config);
   }

   Exemple Node.js

   function createClient() {
     let config = new OpenApi.Config({
       // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
       accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
       // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
       accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
     });
     // The endpoint and regionId must be for the same region.
     config.regionId = 'cn-shanghai';
     config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
     return new facebody20191230.default(config);
   }

2. Créer l'objet de requête

   Créez un objet <NomOpenAPI>AdvanceRequest pour transmettre le flux de fichiers. Le nom du paramètre pour le flux de fichiers est ImageURLObject.

   Exemple TypeScript

       // Read the file as a file stream.
       const filePath = '<FILE_PATH>';  // Replace this with the actual file path.
       // Check if the file exists.
       if (!fs.existsSync(filePath)) {
           console.error('File does not exist:', filePath);
           return;
       }
       // Create a stream and listen for stream errors.
       const fileStream = fs.createReadStream(filePath).on('error', (err) => {
           console.error('Stream error:', err);
           process.exit(1);
       });
   
       let detectBodyCountAdvanceRequest = new $facebody20191230.DetectBodyCountAdvanceRequest({
         imageURLObject: fileStream,
       });

   Exemple Node.js

       // Read the file as a file stream.
       const filePath = '<FILE_PATH>';  // Replace this with the actual file path.
       // Check if the file exists.
       if (!fs.existsSync(filePath)) {
           console.error('File does not exist:', filePath);
           return;
       }
       // Create a stream and listen for stream errors.
       const fileStream = fs.createReadStream(filePath).on('error', (err) => {
           console.error('Stream error:', err);
           process.exit(1);
       });
   
       let detectBodyCountAdvanceRequest = new facebody20191230.DetectBodyCountAdvanceRequest({
           imageURLObject: fileStream,
       });

3. Envoyer la requête

   Appelez la fonction <nomOpération>Advance pour envoyer la requête.

   Exemple TypeScript

   // Configure runtime parameters.
   let runtime = new $Util.RuntimeOptions({ });
   let client = Client.createClient();
   // Send the request.
   await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);

   Exemple Node.js

    // Configure runtime parameters.
    let runtime = new Util.RuntimeOptions({ });
    let client = Client.createClient();
    // Send the request.
    await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);  

import { default as facebody20191230 } from '@alicloud/facebody20191230';
import * as $facebody20191230 from '@alicloud/facebody20191230';
import * as $OpenApi from '@alicloud/openapi-client';
import * as $Util from '@alicloud/tea-util';
import * as fs from "fs";

export default class Client {
    static createClient(): facebody20191230 {
        let config = new $OpenApi.Config({
            // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
            accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
            accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
        });
        config.regionId = 'cn-shanghai';
        config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
        return new facebody20191230(config);
    }

    static async main(): Promise<void> {
        let client = Client.createClient();

        // Read the file as a file stream.
        const filePath = '<FILE_PATH>';  // Replace this with the actual file path.
        // Check if the file exists.
        if (!fs.existsSync(filePath)) {
            console.error('File does not exist:', filePath);
            return;
        }
        // Create a stream and listen for stream errors.
        const fileStream = fs.createReadStream(filePath).on('error', (err) => {
            console.error('Stream error:', err);
            process.exit(1);
        });

        let detectBodyCountAdvanceRequest = new $facebody20191230.DetectBodyCountAdvanceRequest({
            imageURLObject: fileStream,
        });
        let runtime = new $Util.RuntimeOptions({});
        try {
            // Send the request.
            const res = await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
            console.log(res);
        } catch (error) {
            if (error instanceof Error) {
                console.error('Error message:', error.message);
                const data = (error as any)?.data?.Recommend;
                if (typeof data === 'string') {
                    console.log('Diagnostic suggestion:', data);
                }
            }
        }
    }
}

Client.main();

'use strict';
const facebody20191230 = require('@alicloud/facebody20191230');
const OpenApi = require('@alicloud/openapi-client');
const Util = require('@alicloud/tea-util');
const fs = require('fs');

class Client {
  static createClient() {
    let config = new OpenApi.Config({
      // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is set.
      accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
      // Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is set.
      accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
    });
    config.regionId = 'cn-shanghai';
    config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
    return new facebody20191230.default(config);
  }

  static async main() {
    let client = Client.createClient();
    // Read the file as a file stream.
    const filePath = '<FILE_PATH>';  // Replace this with the actual file path.
    // Check if the file exists.
    if (!fs.existsSync(filePath)) {
      console.error('File does not exist:', filePath);
      return;
    }
    // Create a stream and listen for stream errors.
    const fileStream = fs.createReadStream(filePath).on('error', (err) => {
      console.error('Stream error:', err);
      process.exit(1);
    });
    // Configure request parameters.
    let detectBodyCountAdvanceRequest = new facebody20191230.DetectBodyCountAdvanceRequest({
      imageURLObject: fileStream,
    });
    let runtime = new Util.RuntimeOptions({});
    try {
      // Send the request.
      const res = await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
      console.log(res);
    } catch (error) {
      // This is for demonstration purposes only. Handle exceptions with care. Do not ignore exceptions in your project.
      console.log(error);
    }
  }
}

exports.Client = Client;
Client.main();

FAQ

1. Erreur « You are not authorized to perform this operation » lors de l'appel d'une API

   Cause et solution

   Cause : l'utilisateur RAM associé à votre AccessKey ne dispose pas des autorisations requises pour appeler l'API.

   Solution : accordez les autorisations API requises à l'utilisateur RAM. Consultez la rubrique Gérer les autorisations des utilisateurs RAM.

   Par exemple, si vous recevez cette erreur lors de l'appel de ou SendMessageToGlobe, vous pouvez créer la stratégie d'autorisation personnalisée suivante et l'attacher à l'utilisateur RAM.

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

2. Erreur « triggerUncaughtException Error: getaddrinfo ENOTFOUND » (problème d'endpoint)

   Cause et solution

   Cause : l'endpoint spécifié n'est pas pris en charge par l'opération OpenAPI que vous appelez.

   Solution : corrigez l'endpoint en utilisant la rubrique Configuration de l'endpoint et réessayez.

3. Erreur « Cannot read properties of undefined (reading 'getCredential') » ou « InvalidAccessKeyId.NotFound: code: 404 »

   Cause et solution

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

   Solution : vérifiez que l'AccessKey est transmis correctement lors de l'initialisation du client. process.env("XXX") lit la valeur de XXX à partir des variables d'environnement.

Pour d'autres erreurs courantes, consultez la rubrique FAQ.