Alibaba Cloud SDK:Integrar o SDK

1. Faça login no SDK Center e selecione o product correspondente à API que deseja chamar, como o Short Message Service (SMS).

2. Na página Installation e configure All Languages como TypeScript. Em seguida, na aba Quick Start, localize as instruções de instalação do SDK para o Short Message Service (SMS).

Upload de arquivos com operações Advance

Algumas APIs (como busca de imagens e Visual Intelligence) não aceitam caminhos de arquivos locais diretamente. Use a operação Advance para fazer upload de arquivos via stream. O SDK armazena o arquivo temporariamente em um bucket do OSS na região cn-shanghai, e o service o lê a partir desse local. Este exemplo usa a operação DetectBodyCount da API Visual Intelligence.

1. Inicializar o cliente de requisição

   Defina tanto regionId quanto endpoint para a mesma região. O regionId determina onde o arquivo temporário do OSS será armazenado. Se você omitir o regionId, uma incompatibilidade de região entre o product e o bucket do OSS causará timeouts.

   Exemplo em 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);
   }

   Exemplo em 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. Criar o objeto de requisição

   Crie um objeto <NomeDaOpenAPI>AdvanceRequest para passar o stream do arquivo. O nome do parâmetro para o stream do arquivo é ImageURLObject.

   Exemplo em 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,
       });

   Exemplo em 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. Enviar a requisição

   Chame a função <operationName>Advance para enviar a requisição.

   Exemplo em TypeScript

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

   Exemplo em 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();

Perguntas frequentes

1. Erro "You are not authorized to perform this operation" ao chamar uma API

   Causa e solução

   Causa: O usuário RAM associado ao seu AccessKey não tem as permissões necessárias para chamar a API.

   Solução: Conceda as permissões de API necessárias ao usuário RAM. Consulte Manage RAM user permissions.

   Por exemplo, se você receber esse erro ao chamar ou SendMessageToGlobe, crie a seguinte política de permissão personalizada e anexe-a ao usuário RAM.

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

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

   Causa e solução

   Causa: O endpoint especificado não é compatível com a operação da OpenAPI chamada.

   Solução: Corrija o endpoint usando Endpoint configuration e tente novamente.

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

   Causa e solução

   Causa: O AccessKey não foi passado corretamente.

   Solução: Verifique se o AccessKey está sendo passado corretamente durante a inicialização do cliente. process.env("XXX") lê o valor de XXX das variáveis de ambiente.

Para outros erros comuns, consulte FAQ.