Skip to main content
CLI использует API key для команд с аутентификацией. Вы можете сохранить его один раз с помощью youka login или передать через YOUKA_API_KEY в CI и других неинтерактивных окружениях. youka login проверяет ключ через API перед сохранением, затем кэширует определённый email аккаунта в ~/.youka/config.json для диагностики.

login

Сохранить API key в ~/.youka/config.json.
youka login [token]
token
string
API key, скопированный из панели Youka. Если не указан, CLI запросит его в интерактивном терминале.

Примеры

youka login yk_live_abcd1234
В CI предпочтительнее использовать YOUKA_API_KEY вместо записи файла конфигурации.

logout

Удалить сохранённый API key из ~/.youka/config.json.
youka logout
youka logout --json

whoami

Проверить источник полученного ключа, URL API и идентификатор аккаунта.
youka whoami
youka whoami --json
Пример ответа:
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/ru/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"
  }
}

Порядок определения

ПолеПорядок
API keyYOUKA_API_KEY, затем ~/.youka/config.json
API URL--api, затем YOUKA_API_BASE_URL, затем ~/.youka/config.json, затем default
Когда активен ключ из сохранённой конфигурации, whoami проверяет идентичность через API и использует кэшированный email аккаунта только если онлайн-проверка недоступна. Он не использует кэшированную identity из конфигурации для токенов YOUKA_API_KEY.

Что дальше