Skip to main content
La CLI usa una chiave API per i comandi autenticati. Puoi salvarla una volta con youka login, oppure fornirla tramite YOUKA_API_KEY in CI e in altri ambienti non interattivi. youka login verifica la chiave tramite l’API prima di salvarla, poi memorizza nella cache l’email dell’account risolta in ~/.youka/config.json per la diagnostica.

login

Salva una chiave API in ~/.youka/config.json.
youka login [token]
token
string
La chiave API copiata dalla dashboard Youka. Se omessa, la CLI la richiede in un terminale interattivo.

Esempi

youka login yk_live_abcd1234
In CI, preferisci YOUKA_API_KEY invece di scrivere un file di configurazione.

logout

Rimuovi la chiave API salvata da ~/.youka/config.json.
youka logout
youka logout --json

whoami

Ispeziona l’origine risolta della chiave, l’URL dell’API e l’identità dell’account.
youka whoami
youka whoami --json
Risposta di esempio:
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/it/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"
  }
}

Ordine di risoluzione

CampoOrdine
API keyYOUKA_API_KEY, poi ~/.youka/config.json
API URL--api, poi YOUKA_API_BASE_URL, poi ~/.youka/config.json, poi default
Quando è attiva una chiave di configurazione salvata, whoami verifica l’identità con l’API e ripiega sull’email dell’account in cache solo se la ricerca live non è disponibile. Non usa l’identità in cache della configurazione per i token YOUKA_API_KEY.

Cosa fare dopo