Alibaba Cloud SDK:SDK Entegrasyonu

1. SDK Merkezi adresine gidin ve çağırmak istediğiniz API'nin ürününü seçin; örneğin Short Message Service (SMS).

2. Installation sayfasında ve All Languages seçeneğini TypeScript olarak belirleyin. Ardından, Quick Start sekmesinde Short Message Service (SMS) için SDK kurulum talimatlarını bulabilirsiniz.

Advance işlemleriyle dosya yükleme

Bazı API'ler (görüntü arama ve Visual Intelligence gibi) yerel dosya yollarını doğrudan kabul etmez. Dosyaları bir akış üzerinden yüklemek için Advance işlemini kullanın. SDK, dosyayı cn-shanghai bölgesindeki bir OSS paketinde geçici olarak depolar ve hizmet buradan okur. Bu örnekte Visual Intelligence API'sinin DetectBodyCount işlemi kullanılmaktadır.

1. İstek istemcisini başlatma

   Hem regionId hem de endpoint değerlerini aynı bölgeye ayarlayın. regionId değeri geçici OSS dosyasının depolandığı yeri belirler. regionId değerini atlarsanız ürün ile OSS paketi arasında bir bölge uyumsuzluğu meydana gelir ve bu da zaman aşımlarına neden olur.

   TypeScript örneği

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

   Node.js örneği

   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. İstek nesnesini oluşturma

   Dosya akışını iletmek için bir <OpenAPIAdı>AdvanceRequest nesnesi oluşturun. Dosya akışı için parametre adı ImageURLObject şeklindedir.

   TypeScript örneği

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

   Node.js örneği

       // 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. İsteği gönderme

   İsteği göndermek için <operationName>Advance işlevini çağırın.

   TypeScript örneği

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

   Node.js örneği

    // 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();

SSS

1. Bir API çağrılırken "You are not authorized to perform this operation" hatası

   Neden ve çözüm

   Neden: AccessKey'inizle ilişkili RAM kullanıcısının API'yi çağırmak için gerekli izinleri yoktur.

   Çözüm: RAM kullanıcısına gerekli API izinlerini verin. Bkz. RAM kullanıcısı izinlerini yönetme.

   Örneğin, veya SendMessageToGlobe işlemini çağırırken bu hatayı alıyorsanız aşağıdaki özel izin ilkesini oluşturup RAM kullanıcısına ekleyebilirsiniz.

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

2. "triggerUncaughtException Error: getaddrinfo ENOTFOUND" hatası (uç nokta sorunu)

   Neden ve çözüm

   Neden: Belirtilen uç nokta, çağırdığınız OpenAPI işlemi tarafından desteklenmiyor.

   Çözüm: Uç nokta yapılandırması bölümündeki talimatları izleyerek uç noktayı düzeltin ve tekrar deneyin.

3. "Cannot read properties of undefined (reading 'getCredential')" veya "InvalidAccessKeyId.NotFound: code: 404" hatası

   Neden ve çözüm

   Neden: AccessKey doğru şekilde iletilmedi.

   Çözüm: İstemci başlatma sırasında AccessKey'in doğru iletildiğini doğrulayın. process.env("XXX") ifadesi XXX değerini ortam değişkenlerinden okur.

Diğer yaygın hatalar için bkz. SSS.