Autenticación

El SDK autentica cada solicitud con una clave de API bearer. Construyes un YoukaClient una sola vez y lo reutilizas durante toda la vida útil de tu proceso.

`new YoukaClient(options)`

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

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

Options

string

required

Tu clave de API de Youka. Crea una en online.youka.io/account en API keys.

typeof fetch

Implementación personalizada de fetch. Por defecto usa el fetch global. Úsalo para inyectar logging, proxies o middleware de reintentos personalizado.

Almacenamiento de la clave de API

Las claves de API dan acceso a tu facturación. Nunca las subas al control de versiones.

Patrones recomendados:

Environment variable
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"),
});

Inyección de un fetch personalizado

Cada método del SDK usa el fetch que pasas al constructor. Esto facilita añadir logging o middleware:

import { YoukaClient } from "@youka/es/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,
});

Opciones por solicitud

Cada método acepta un segundo o tercer argumento opcional con opciones a nivel de solicitud:

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

string

Se pasa como el encabezado Idempotency-Key. Reutilizar la misma clave con el mismo payload devuelve el resultado original en lugar de crear un duplicado. Consulta API idempotency.

AbortSignal

Señal de cancelación estándar. Cancela solicitudes en curso y sondeos de larga duración de client.tasks.wait(...), client.projects.wait(...) y client.exports.wait(...).

Qué sigue

Projects — crea tu primer proyecto
Errors — gestiona fallos de autenticación
API authentication — detalles en bruto de encabezados HTTP

Overview

How To

Customization

Audio

Settings

Exporting

Account

`new YoukaClient(options)`

Options

Almacenamiento de la clave de API

Inyección de un fetch personalizado

Opciones por solicitud

Qué sigue

​new YoukaClient(options)

​Options

​Almacenamiento de la clave de API

​Inyección de un fetch personalizado

​Opciones por solicitud

​Qué sigue

`new YoukaClient(options)`

Options

Almacenamiento de la clave de API

Inyección de un fetch personalizado

Opciones por solicitud

Qué sigue