Skip to main content
CLI는 인증이 필요한 명령에 API 키를 사용합니다. youka login으로 한 번 저장해두거나, CI 및 기타 비대화형 환경에서는 YOUKA_API_KEY로 제공할 수 있습니다. youka login은 저장하기 전에 API를 통해 키를 검증한 다음, 진단을 위해 확인된 계정 이메일을 ~/.youka/config.json에 캐시합니다.

​
login

API 키를 ~/.youka/config.json에 저장합니다. 
youka login [token]
​
token
string
Youka 대시보드에서 복사한 API 키입니다. 생략하면, CLI가 대화형 터미널에서 입력을 요청합니다.

​
예시

youka login yk_live_abcd1234
CI에서는 설정 파일을 작성하는 것보다 YOUKA_API_KEY를 사용하는 것을 권장합니다.

​
logout

저장된 API 키를 ~/.youka/config.json에서 제거합니다. 
youka logout
youka logout --json

​
whoami

확인된 키 소스, API URL, 그리고 계정 식별 정보를 확인합니다. 
youka whoami
youka whoami --json
응답 예시: 
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/ko/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"
  }
}

​
확인 순서

FieldOrder
API keyYOUKA_API_KEY, then ~/.youka/config.json
API URL--api, then YOUKA_API_BASE_URL, then ~/.youka/config.json, then default
저장된 config 키가 활성화되어 있을 때, whoami는 API로 신원을 검증하고 라이브 조회를 사용할 수 없는 경우에만 캐시된 계정 이메일로 폴백합니다. YOUKA_API_KEY 토큰에는 캐시된 config 신원을 사용하지 않습니다.

​
다음 단계

  • Global options - 모든 명령에서 공통으로 사용하는 플래그
  • Projects - 노래방 프로젝트 생성 및 처리