Autenticazione

L’SDK autentica ogni richiesta con una chiave API bearer. Crea un YoukaClient una sola volta e riutilizzalo per tutta la durata del processo.

`new YoukaClient(options)`

import { YoukaClient } from "@youka/it/sdk";

const client = new YoukaClient({
  apiKey: process.env.YOUKA_API_KEY!,
});

Opzioni

string

required

La tua chiave API Youka. Creane una su online.youka.io/account nella sezione API keys.

typeof fetch

Implementazione fetch personalizzata. Per impostazione predefinita usa il fetch globale. Usala per iniettare logging, proxy o middleware di retry personalizzato.

Archiviare la chiave API

Le chiavi API consentono l’accesso alla fatturazione. Non inserirle mai nel controllo versione.

Pattern consigliati:

Variabile d'ambiente
Secret manager

const client = new YoukaClient({
  apiKey: process.env.YOUKA_API_KEY!,
});

import { getSecret } from "./my-secret-manager";

const client = new YoukaClient({
  apiKey: await getSecret("youka-api-key"),
});

Iniettare un fetch personalizzato

Ogni metodo dell’SDK usa il fetch che passi al costruttore. Questo rende facile aggiungere logging o middleware:

import { YoukaClient } from "@youka/it/sdk";

const instrumentedFetch: typeof fetch = async (input, init) => {
  const start = Date.now();
  const response = await fetch(input, init);
  console.log(
    `${init?.method ?? "GET"} ${input} ${response.status} in ${Date.now() - start}ms`,
  );
  return response;
};

const client = new YoukaClient({
  apiKey: process.env.YOUKA_API_KEY!,
  fetch: instrumentedFetch,
});

Opzioni per richiesta

Ogni metodo accetta un secondo o terzo argomento opzionale con opzioni a livello di richiesta:

await client.projects.create(body, {
  idempotencyKey: "import-2026-04-08-song-001",
  signal: abortController.signal,
});

string

Passata come header Idempotency-Key. Riutilizzare la stessa chiave con lo stesso payload restituisce il risultato originale invece di creare un duplicato. Vedi API idempotency.

AbortSignal

Segnale di annullamento standard. Annulla le richieste in corso e i poll di lunga durata client.tasks.wait(...), client.projects.wait(...) e client.exports.wait(...).

Cosa c’è dopo

Projects — crea il tuo primo progetto
Errors — gestisci i fallimenti di autenticazione
API authentication — dettagli grezzi degli header HTTP

Overview

How To

Customization

Audio

Settings

Exporting

Account

`new YoukaClient(options)`

Opzioni

Archiviare la chiave API

Iniettare un fetch personalizzato

Opzioni per richiesta

Cosa c’è dopo

​new YoukaClient(options)

​Opzioni

​Archiviare la chiave API

​Iniettare un fetch personalizzato

​Opzioni per richiesta

​Cosa c’è dopo

`new YoukaClient(options)`

Opzioni

Archiviare la chiave API

Iniettare un fetch personalizzato

Opzioni per richiesta

Cosa c’è dopo