Alibaba Cloud SDK：Integrasi Alibaba Cloud SDK V2.0 untuk Node.js

1. Masuk ke SDK Center dan pilih layanan yang ingin Anda gunakan SDK-nya. Dalam contoh ini, Short Message Service (SMS) dipilih.

2. Pada halaman Short Message Service, pilih TypeScript di bagian All languages. Pada tab Quick Start, dapatkan metode instalasi Short Message Service (SMS) SDK.

Skenario khusus: Unggah file melalui operasi Advance

Saat menggunakan Image Search atau Visual Intelligence API (VIAPI) untuk memproses gambar pada mesin lokal atau mengunggah gambar, API dari Image Search atau VIAPI yang dijelaskan dalam dokumentasi tidak mendukung pengunggahan langsung. Untuk mengunggah gambar, Anda perlu menggunakan operasi Advance, yang mendukung transmisi aliran file. Layanan cloud menyimpan sementara file yang diunggah di Object Storage Service (OSS), dan membaca file sementara dari OSS jika diperlukan. Wilayah OSS default adalah cn-shanghai. Contoh berikut menunjukkan cara memanggil operasi DetectBodyCount dari VIAPI:

1. Inisialisasi Klien Permintaan

   Pastikan bahwa parameter regionId dan endpoint layanan cloud ditentukan. regionId menunjukkan wilayah OSS tempat file sementara disimpan. Jika Anda tidak mengonfigurasi parameter regionId, layanan cloud mungkin menggunakan wilayah yang berbeda dari OSS, yang mengakibatkan timeout API.

   TypeScript

   function createClient(): facebody20191230 {
       let config = new $OpenApi.Config({
           // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_ID. 
           accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
           // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
           accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });
       // Tentukan wilayah yang sama untuk parameter endpoint dan regionId.
       config.regionId = 'cn-shanghai';
       config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
       return new facebody20191230(config);
   }

   Node.js

   function createClient() {
     let config = new OpenApi.Config({
       // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_ID. 
       accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
       // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
       accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
     });
     // Tentukan wilayah yang sama untuk parameter endpoint dan regionId.
     config.regionId = 'cn-shanghai';
     config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
     return new facebody20191230.default(config);
   }

2. Buat Objek Permintaan

   Buat objek permintaan <Operasi API>AdvanceRequest untuk melewati aliran file. Di objek permintaan, atur nama parameter menjadi ImageURLObject.

   TypeScript

       // Baca file sebagai aliran fileStream.
       const filePath = '<FILE_PATH>';  // Ganti nilai dengan jalur file aktual.
       // Periksa file.
       if (!fs.existsSync(filePath)) {
           console.error('File tidak ada:', filePath);
           return;
       }
       // Buat aliran dan dengarkan kesalahan aliran.
       const fileStream = fs.createReadStream(filePath).on('error', (err) => {
           console.error('Kesalahan aliran file:', err);
           process.exit(1);
       });
   
       let detectBodyCountAdvanceRequest = new $facebody20191230.DetectBodyCountAdvanceRequest({
         imageURLObject: fileStream,
       });

   Node.js

       // Baca file sebagai aliran fileStream.
       const filePath = '<FILE_PATH>';  // Ganti nilai dengan jalur file aktual.
       // Periksa file.
       if (!fs.existsSync(filePath)) {
           console.error('File tidak ada:', filePath);
           return;
       }
       // Buat aliran dan dengarkan kesalahan aliran.
       const fileStream = fs.createReadStream(filePath).on('error', (err) => {
           console.error('Kesalahan aliran file:', err);
           process.exit(1);
       });
   
       let detectBodyCountAdvanceRequest = new facebody20191230.DetectBodyCountAdvanceRequest({
           imageURLObject: fileStream,
       });

3. Mulai Permintaan

   Panggil operasi <Operasi API>AdvanceRequest.

   TypeScript

   // Konfigurasikan parameter runtime.
   let runtime = new $Util.RuntimeOptions({ });
   let client = Client.createClient();
   // Kirim permintaan.   
   await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);

   Node.js

    // Konfigurasikan parameter runtime.
    let runtime = new Util.RuntimeOptions({ });
    let client = Client.createClient();
    // Kirim permintaan.   
    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({
            // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_ID. 
            accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
            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();

        // Baca file sebagai aliran fileStream.
        const filePath = '<FILE_PATH>';  // Ganti nilai dengan jalur file aktual.
        // Periksa file.
        if (!fs.existsSync(filePath)) {
            console.error('File tidak ada:', filePath);
            return;
        }
        // Buat aliran dan dengarkan kesalahan aliran.
        const fileStream = fs.createReadStream(filePath).on('error', (err) => {
            console.error('Kesalahan aliran file:', err);
            process.exit(1);
        });

        let detectBodyCountAdvanceRequest = new $facebody20191230.DetectBodyCountAdvanceRequest({
            imageURLObject: fileStream,
        });
        let runtime = new $Util.RuntimeOptions({});
        try {
            // Kirim permintaan.
            const res = await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
            console.log(res);
        } catch (error) {
            if (error instanceof Error) {
                console.error('Pesan kesalahan:', error.message);
                const data = (error as any)?.data?.Recommend;
                if (typeof data === 'string') {
                    console.log('Saran:', 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({
      // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_ID. 
      accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
      // Diperlukan. Pastikan variabel lingkungan berikut disetel di lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
      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();
    // Baca file sebagai aliran fileStream.
    const filePath = '<FILE_PATH>';  // Ganti nilai dengan jalur file aktual.
    // Periksa file.
    if (!fs.existsSync(filePath)) {
      console.error('File tidak ada:', filePath);
      return;
    }
    // Buat aliran dan dengarkan kesalahan aliran.
    const fileStream = fs.createReadStream(filePath).on('error', (err) => {
      console.error('Kesalahan aliran file:', err);
      process.exit(1);
    });
    // Konfigurasikan parameter permintaan.
    let detectBodyCountAdvanceRequest = new facebody20191230.DetectBodyCountAdvanceRequest({
      imageURLObject: fileStream,
    });
    let runtime = new Util.RuntimeOptions({});
    try {
      // Kirim permintaan.
      const res = await client.detectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime);
      console.log(res);
    } catch (error) {
      // Tangani pengecualian dengan hati-hati berdasarkan skenario bisnis nyata Anda dan jangan abaikan pengecualian dalam proyek Anda. Pesan kesalahan yang ditampilkan dalam contoh ini hanya untuk referensi. 
      console.log(error);
    }
  }
}

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

FAQ

1. Bagaimana cara menangani kesalahan "Anda tidak memiliki otorisasi untuk melakukan operasi ini" yang dilemparkan oleh operasi API?

   Penyebab dan Solusi yang Mungkin

   Penyebab yang Mungkin: Pasangan AccessKey dari pengguna Resource Access Management (RAM) tidak memiliki izin untuk memanggil operasi API.

   Solusi: Berikan izin yang diperlukan kepada pengguna RAM. Informasi lebih lanjut dapat ditemukan di Berikan Izin kepada Pengguna RAM.

   Sebagai contoh, jika kesalahan "Anda tidak memiliki otorisasi untuk melakukan operasi ini" dilemparkan oleh operasi API SendMessageToGlobe, buat kebijakan kustom berikut untuk memberikan izin yang diperlukan kepada pengguna RAM:

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

2. Bagaimana cara menangani kesalahan titik akhir "triggerUncaughtException Error: getaddrinfo ENOTFOUND" yang dilemparkan oleh operasi API?

   Penyebab dan Solusi yang Mungkin

   Penyebab yang Mungkin: Operasi API tidak mendukung titik akhir yang Anda tentukan saat menginisialisasi klien permintaan.

   Solusi: Tentukan titik akhir yang didukung dan coba lagi. Informasi lebih lanjut dapat ditemukan di Konfigurasikan Titik Akhir.

3. Bagaimana cara menangani kesalahan AccessKey "Cannot read properties of undefined (reading 'getCredential')" atau "InvalidAccessKeyId.NotFound: code: 404" yang dilemparkan oleh operasi API?

   Penyebab dan Solusi yang Mungkin

   Penyebab yang Mungkin: Pasangan AccessKey tidak benar dilewatkan ke permintaan.

   Solusi: Pastikan pasangan AccessKey benar dilewatkan saat Anda menginisialisasi klien permintaan. Nilai XXX dari process.env("XXX") diperoleh dari variabel lingkungan.

Informasi lebih lanjut tentang cara menangani pengecualian SDK dapat ditemukan di FAQ.