Authentifizierung

Das SDK authentifiziert jede Anfrage mit einem Bearer-API-Schlüssel. Du erstellst einen YoukaClient einmal und verwendest ihn über die gesamte Laufzeit deines Prozesses hinweg erneut.

`new YoukaClient(options)`

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

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

Optionen

string

required

Dein Youka-API-Schlüssel. Erstelle einen unter online.youka.io/account unter API keys.

typeof fetch

Eigene fetch-Implementierung. Standardmäßig wird das globale fetch verwendet. Nutze dies, um Logging, Proxys oder eigene Retry-Middleware einzuschleusen.

Den API-Schlüssel speichern

API-Schlüssel gewähren Zugriff auf deine Abrechnung. Committe sie niemals in die Versionsverwaltung.

Empfohlene Muster:

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

Ein eigenes fetch injizieren

Jede SDK-Methode verwendet das fetch, das du an den Konstruktor übergibst. Dadurch lassen sich Logging oder Middleware einfach hinzufügen:

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

Optionen pro Anfrage

Jede Methode akzeptiert ein optionales zweites oder drittes Argument mit Optionen auf Anfrageebene:

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

string

Wird als Idempotency-Key-Header übergeben. Wenn derselbe Schlüssel mit derselben Payload wiederverwendet wird, wird das ursprüngliche Ergebnis zurückgegeben, statt ein Duplikat zu erstellen. Siehe API idempotency.

AbortSignal

Standardsignal zum Abbrechen. Bricht laufende Anfragen und langlaufende client.tasks.wait(...), client.projects.wait(...) und client.exports.wait(...)-Polls ab.

Wie geht es weiter

Projects — erstelle dein erstes Projekt
Errors — gehe mit Authentifizierungsfehlern um
API authentication — Details zum rohen HTTP-Header

Overview

How To

Customization

Audio

Settings

Exporting

Account

`new YoukaClient(options)`

Optionen

Den API-Schlüssel speichern

Ein eigenes fetch injizieren

Optionen pro Anfrage

Wie geht es weiter

​new YoukaClient(options)

​Optionen

​Den API-Schlüssel speichern

​Ein eigenes fetch injizieren

​Optionen pro Anfrage

​Wie geht es weiter

`new YoukaClient(options)`

Optionen

Den API-Schlüssel speichern

Ein eigenes fetch injizieren

Optionen pro Anfrage

Wie geht es weiter