Skip to main content
O CLI usa uma chave de API para comandos autenticados. Você pode salvá-la uma vez com youka login ou fornecê-la via YOUKA_API_KEY em CI e outros ambientes não interativos. youka login verifica a chave na API antes de salvá-la e, em seguida, armazena em cache o e-mail da conta resolvida em ~/.youka/config.json para diagnóstico.

login

Salve uma chave de API em ~/.youka/config.json.
youka login [token]
token
string
A chave de API copiada do painel do Youka. Se omitida, o CLI solicita em um terminal interativo.

Exemplos

youka login yk_live_abcd1234
Em CI, prefira YOUKA_API_KEY em vez de gravar um arquivo de configuração.

logout

Remova a chave de API salva de ~/.youka/config.json.
youka logout
youka logout --json

whoami

Inspecione a origem da chave resolvida, a URL da API e a identidade da conta.
youka whoami
youka whoami --json
Resposta de exemplo:
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/pt/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"
  }
}

Ordem de resolução

CampoOrdem
Chave de APIYOUKA_API_KEY, depois ~/.youka/config.json
URL da API--api, depois YOUKA_API_BASE_URL, depois ~/.youka/config.json, depois padrão
Quando uma chave de configuração salva está ativa, whoami verifica a identidade na API e recorre ao e-mail da conta em cache somente se a consulta ao vivo não estiver disponível. Ele não usa a identidade em cache da configuração para tokens YOUKA_API_KEY.

Próximos passos