Alibaba Cloud SDK:Integrar el SDK

1. Inicie sesión en SDK Center y seleccione el producto de la API que desea llamar, como Short Message Service (SMS).

2. En la página Installation y configure All Languages en TypeScript. A continuación, en la pestaña Quick Start, encontrará las instrucciones de instalación del SDK para Short Message Service (SMS).

Carga de archivos con operaciones Advance

Algunas API (como las de búsqueda de imágenes y Visual Intelligence) no aceptan rutas de archivos locales directamente. Use la operación Advance para cargar archivos mediante un stream. El SDK almacena el archivo temporalmente en un bucket de OSS en la región cn-shanghai, y el servicio lo lee desde ahí. Este ejemplo usa la operación DetectBodyCount de Visual Intelligence API.

1. Inicialice el cliente de solicitud

   Establezca tanto regionId como endpoint en la misma región. El valor de regionId determina dónde se almacena el archivo temporal de OSS. Si omite regionId, la diferencia de región entre el producto y el bucket de OSS provocará tiempos de espera agotados.

   Ejemplo de 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);
   }

   Ejemplo de 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. Cree el objeto de solicitud

   Cree un objeto <OpenAPIName>AdvanceRequest para pasar el stream del archivo. El nombre del parámetro para el stream del archivo es ImageURLObject.

   Ejemplo de 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,
       });

   Ejemplo de 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. Envíe la solicitud

   Llame a la función <operationName>Advance para enviar la solicitud.

   Ejemplo de TypeScript

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

   Ejemplo de 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();

Preguntas frecuentes

1. Error "You are not authorized to perform this operation" al llamar a una API

   Causa y solución

   Causa: El usuario de RAM asociado a su AccessKey no tiene los permisos obligatorios para llamar a la API.

   Solución: Otorgue los permisos de API obligatorios al usuario de RAM. Consulte Manage RAM user permissions.

   Por ejemplo, si recibe este error al llamar a o SendMessageToGlobe, cree a continuación una política de permisos personalizada y vincúlela al usuario de RAM.

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

2. Error "triggerUncaughtException Error: getaddrinfo ENOTFOUND" (problema de endpoint)

   Causa y solución

   Causa: La operación de OpenAPI que está llamando no es compatible con el endpoint especificado.

   Solución: Corrija el endpoint con Endpoint configuration e inténtelo de nuevo.

3. Error "Cannot read properties of undefined (reading 'getCredential')" o "InvalidAccessKeyId.NotFound: code: 404"

   Causa y solución

   Causa: El AccessKey no se pasó correctamente.

   Solución: Compruebe que el AccessKey se pase de forma correcta durante la inicialización del cliente. process.env("XXX") lee el valor de XXX desde las variables de entorno.

Para otros errores comunes, consulte FAQ.