Skip to main content
Die CLI verwendet für authentifizierte Befehle einen API-Schlüssel. Du kannst ihn einmalig mit youka login speichern oder ihn in CI und anderen nicht-interaktiven Umgebungen über YOUKA_API_KEY bereitstellen. youka login prüft den Schlüssel vor dem Speichern über die API und cached dann zur Diagnose die aufgelöste Konto-E-Mail in ~/.youka/config.json.

​
login

Einen API-Schlüssel in ~/.youka/config.json speichern. 
youka login [token]
​
token
string
Der aus dem Youka-Dashboard kopierte API-Schlüssel. Wenn weggelassen, fordert die CLI ihn in einem interaktiven Terminal an.

​
Beispiele

youka login yk_live_abcd1234
In CI ist YOUKA_API_KEY gegenüber dem Schreiben einer Konfigurationsdatei vorzuziehen.

​
logout

Den gespeicherten API-Schlüssel aus ~/.youka/config.json entfernen. 
youka logout
youka logout --json

​
whoami

Die ermittelte Schlüsselquelle, die API-URL und die Kontoidentität prüfen. 
youka whoami
youka whoami --json
Beispielantwort: 
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/de/api/v1",
    "apiUrlSource": "default",
    "email": "user@example.com",
    "userId": "user_123",
    "apiKeyId": "key_123",
    "org": null,
    "configPath": "/Users/you/.youka/config.json",
    "apiKeyPreview": "yk_l...1234"
  }
}

​
Auflösungsreihenfolge

FeldReihenfolge
API keyYOUKA_API_KEY, dann ~/.youka/config.json
API URL--api, dann YOUKA_API_BASE_URL, dann ~/.youka/config.json, dann default
Wenn ein gespeicherter Konfigurationsschlüssel aktiv ist, verifiziert whoami die Identität über die API und greift nur dann auf die gecachte Konto-E-Mail zurück, wenn die Live-Abfrage nicht verfügbar ist. Es verwendet für YOUKA_API_KEY-Tokens keine gecachte Konfigurationsidentität.

​
Was als Nächstes

  • Globale Optionen – Flags, die von jedem Befehl geteilt werden
  • Projekte – Karaoke-Projekte erstellen und verarbeiten