Skip to main content
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

​
apiKey
string
required
Tu clave de API de Youka. Crea una en online.youka.io/account en API keys.
​
fetch
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: 
const client = new YoukaClient({
  apiKey: process.env.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,
});
​
idempotencyKey
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.
​
signal
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