Skip to main content
CLI sử dụng API key cho các lệnh cần xác thực. Bạn có thể lưu một lần với youka login, hoặc cung cấp thông qua YOUKA_API_KEY trong CI và các môi trường không tương tác khác. youka login xác minh key với API trước khi lưu, sau đó lưu đệm email tài khoản đã phân giải trong ~/.youka/config.json để phục vụ chẩn đoán.

login

Lưu một API key vào ~/.youka/config.json.
youka login [token]
token
string
API key được sao chép từ bảng điều khiển Youka. Nếu bỏ qua, CLI sẽ nhắc nhập trên một terminal tương tác.

Ví dụ

youka login yk_live_abcd1234
Trong CI, ưu tiên YOUKA_API_KEY thay vì ghi ra một tệp cấu hình.

logout

Xóa API key đã lưu khỏi ~/.youka/config.json.
youka logout
youka logout --json

whoami

Kiểm tra nguồn key đã phân giải, URL API và danh tính tài khoản.
youka whoami
youka whoami --json
Phản hồi ví dụ:
{
  "ok": true,
  "data": {
    "authenticated": true,
    "tokenPresent": true,
    "authStatus": "verified",
    "identitySource": "live",
    "keySource": "config",
    "apiUrl": "https://api.youka.io/vi/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"
  }
}

Thứ tự phân giải

TrườngThứ tự
API keyYOUKA_API_KEY, sau đó ~/.youka/config.json
API URL--api, sau đó YOUKA_API_BASE_URL, sau đó ~/.youka/config.json, rồi mặc định
Khi một key cấu hình đã lưu đang hoạt động, whoami sẽ xác minh danh tính với API và chỉ quay về email tài khoản được lưu đệm nếu không thể tra cứu trực tiếp. Lệnh này không sử dụng danh tính cấu hình đã lưu đệm cho các token YOUKA_API_KEY.

Tiếp theo