Skip to main content
تستخدم واجهة سطر الأوامر (CLI) مفتاح API للأوامر التي تتطلب المصادقة. يمكنك حفظه مرة واحدة عبر youka login، أو توفيره من خلال YOUKA_API_KEY في CI وغيرها من البيئات غير التفاعلية. يتحقق youka login من المفتاح عبر API قبل حفظه، ثم يخزّن مؤقتًا بريد الحساب الإلكتروني الناتج في ~/.youka/config.json لأغراض التشخيص.

login

احفظ مفتاح API في ~/.youka/config.json.
youka login [token]
token
string
مفتاح API الذي تم نسخه من لوحة تحكم Youka. إذا تم حذفه، تطلب واجهة CLI إدخاله في طرفية تفاعلية.

أمثلة

youka login yk_live_abcd1234
في CI، يُفضّل استخدام YOUKA_API_KEY بدلًا من كتابة ملف إعدادات.

logout

أزل مفتاح API المحفوظ من ~/.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/ar/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"
  }
}

ترتيب الاستنتاج

الحقلالترتيب
مفتاح APIYOUKA_API_KEY, ثم ~/.youka/config.json
عنوان URL الخاص بـ API--api, ثم YOUKA_API_BASE_URL, ثم ~/.youka/config.json, ثم الافتراضي
عند تفعيل مفتاح إعدادات محفوظ، يتحقق whoami من الهوية عبر API ويعود إلى بريد الحساب الإلكتروني المخزّن مؤقتًا فقط إذا كانت عملية البحث المباشر غير متاحة. ولا يستخدم الهوية المخزّنة في الإعدادات لمفاتيح YOUKA_API_KEY.

ما التالي