Alibaba Cloud SDK:Integrasikan SDK

1. Login ke SDK Center dan pilih produk untuk API yang ingin Anda panggil, seperti Short Message Service (SMS).

2. Pada halaman Installation , dan atur All Languages ke TypeScript. Kemudian, pada tab Quick Start, Anda dapat menemukan instruksi instalasi SDK untuk Short Message Service (SMS).

Unggah file dengan operasi Advance

Beberapa API (seperti image search dan Visual Intelligence) tidak menerima path file lokal secara langsung. Gunakan operasi Advance untuk mengunggah file melalui aliran. SDK menyimpan file tersebut sementara di bucket OSS di wilayah cn-shanghai, dan layanan membacanya dari sana. Contoh ini menggunakan operasi DetectBodyCount dari Visual Intelligence API.

1. Inisialisasi klien permintaan

   Atur baik regionId maupun endpoint ke wilayah yang sama. regionId menentukan tempat penyimpanan file OSS sementara. Jika Anda menghilangkan regionId, ketidaksesuaian wilayah antara produk dan bucket OSS akan menyebabkan timeout.

   Contoh TypeScript

   function createClient(): facebody20191230 {
       let config = new $OpenApi.Config({
           // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur.
           accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
           // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
           accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });
       // Endpoint dan regionId harus untuk wilayah yang sama.
       config.regionId = 'cn-shanghai';
       config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
       return new facebody20191230(config);
   }

   Contoh Node.js

   function createClient() {
     let config = new OpenApi.Config({
       // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur.
       accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
       // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
       accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
     });
     // Endpoint dan regionId harus untuk wilayah yang sama.
     config.regionId = 'cn-shanghai';
     config.endpoint = 'facebody.cn-shanghai.aliyuncs.com';
     return new facebody20191230.default(config);
   }

2. Buat objek permintaan

   Buat objek <NamaOpenAPI>AdvanceRequest untuk meneruskan aliran file. Nama parameter untuk aliran file adalah ImageURLObject.

   Contoh TypeScript

       // Baca file sebagai aliran file.
       const filePath = '<FILE_PATH>';  // Ganti ini dengan path file sebenarnya.
       // Periksa apakah file ada.
       if (!fs.existsSync(filePath)) {
           console.error('File does not exist:', filePath);
           return;
       }
       // Buat aliran dan dengarkan error aliran.
       const fileStream = fs.createReadStream(filePath).on('error', (err) => {
           console.error('Stream error:', err);
           process.exit(1);
       });
   
       let detectBodyCountAdvanceRequest = new $facebody20191230.DetectBodyCountAdvanceRequest({
         imageURLObject: fileStream,
       });

   Contoh Node.js

       // Baca file sebagai aliran file.
       const filePath = '<FILE_PATH>';  // Ganti ini dengan path file sebenarnya.
       // Periksa apakah file ada.
       if (!fs.existsSync(filePath)) {
           console.error('File does not exist:', filePath);
           return;
       }
       // Buat aliran dan dengarkan error aliran.
       const fileStream = fs.createReadStream(filePath).on('error', (err) => {
           console.error('Stream error:', err);
           process.exit(1);
       });
   
       let detectBodyCountAdvanceRequest = new facebody20191230.DetectBodyCountAdvanceRequest({
           imageURLObject: fileStream,
       });

3. Kirim permintaan

   Panggil fungsi <operationName>Advance untuk mengirim permintaan.

   Contoh TypeScript

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

   Contoh 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({
            // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur.
            accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
            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 file.
        const filePath = '<FILE_PATH>';  // Ganti ini dengan path file sebenarnya.
        // Periksa apakah file ada.
        if (!fs.existsSync(filePath)) {
            console.error('File does not exist:', filePath);
            return;
        }
        // Buat aliran dan dengarkan error aliran.
        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 {
            // Kirim permintaan.
            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({
      // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID telah diatur.
      accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
      // Wajib. Pastikan variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_SECRET telah diatur.
      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 file.
    const filePath = '<FILE_PATH>';  // Ganti ini dengan path file sebenarnya.
    // Periksa apakah file ada.
    if (!fs.existsSync(filePath)) {
      console.error('File does not exist:', filePath);
      return;
    }
    // Buat aliran dan dengarkan error aliran.
    const fileStream = fs.createReadStream(filePath).on('error', (err) => {
      console.error('Stream error:', 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) {
      // Ini hanya untuk tujuan demonstrasi. Tangani exception dengan hati-hati. Jangan abaikan exception dalam proyek Anda.
      console.log(error);
    }
  }
}

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

FAQ

1. Error "You are not authorized to perform this operation" saat memanggil API

   Penyebab dan solusi

   Penyebab: Pengguna RAM yang terkait dengan AccessKey Anda tidak memiliki izin yang diperlukan untuk memanggil API.

   Solusi: Berikan izin API yang diperlukan kepada pengguna RAM. Lihat Kelola izin pengguna RAM.

   Misalnya, jika Anda menerima error ini saat memanggil atau SendMessageToGlobe, Anda dapat membuat kebijakan izin kustom berikut dan menyambungkannya ke pengguna RAM.

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

2. Error "triggerUncaughtException Error: getaddrinfo ENOTFOUND" (masalah endpoint)

   Penyebab dan solusi

   Penyebab: Endpoint yang ditentukan tidak didukung oleh operasi OpenAPI yang Anda panggil.

   Solusi: Perbaiki endpoint menggunakan Konfigurasi endpoint dan coba lagi.

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

   Penyebab dan solusi

   Penyebab: AccessKey tidak diteruskan dengan benar.

   Solusi: Verifikasi bahwa AccessKey diteruskan dengan benar selama inisialisasi klien. process.env("XXX") membaca nilai XXX dari variabel lingkungan.

Untuk error umum lainnya, lihat FAQ.