المصادقة

تسجّل الأداة الدخول بطريقتين: عبر المتصفح أو بمفتاح API شخصي. المتصفح هو الأبسط على جهازك، والمفتاح مناسب لـ CI والخوادم.

تسجيل الدخول عبر المتصفح

يفتح auth:login سوفيا في متصفحك. توافق على الوصول فتستلمه الأداة على عنوان محلي (http://127.0.0.1:<port>/callback). إنه تدفق رمز التفويض في OAuth2 مع PKCE، ولا يوجد مفتاح لنسخه.

sofia auth:login

• --scopes "<s1 s2>": النطاقات المطلوبة. افتراضيًا كل نطاقات الموارد بالإضافة إلى offline_access.
• --no-browser: يطبع العنوان بدل فتحه، لجهاز بلا متصفح.

sofia auth:login --scopes "posts:read posts:write offline_access"
sofia auth:login --no-browser

أين تُحفظ بيانات الاعتماد

بعد auth:login تحفظ الأداة جلستك في ~/.sofia/credentials.json (المجلد 0700 والملف 0600). يُجدَّد الرمز المنتهي تلقائيًا ويُعاد كتابة الملف.

{
  "apiUrl": "https://api.sofia-post.com",
  "clientId": "…",
  "accessToken": "…",
  "refreshToken": "…",
  "expiresAt": "…",
  "scope": "…"
}

التحقق وتسجيل الخروج

يعرض auth:status الحساب الذي تعمل الأداة باسمه. ويحذف auth:logout ملف بيانات الاعتماد.

sofia auth:status
sofia auth:logout

يكتفي auth:logout بحذف بيانات الاعتماد على هذا الجهاز: لا تملك Sofia API نقطة نهاية للإلغاء، لذا يبقى الوصول صالحًا إلى أن تلغيه في Sofia ضمن الإعدادات › التطبيقات المرتبطة.

استخدام مفتاح API شخصي

أنشئ مفتاحًا في سوفيا من الإعدادات › API › الوصول الشخصي ثم صدّره باسم SOFIA_API_KEY. لا حاجة إلى auth:login: هذه هي الطريقة لـ CI والخوادم. المزيد عن المفاتيح في المصادقة.

export SOFIA_API_KEY="sk_live_…"
sofia establishments:list

أيهما يُعتمد

تسبق بيانات اعتماد المتصفح المتغيّر SOFIA_API_KEY. لاستخدام المفتاح على جهاز سجّلت دخولك فيه، نفّذ sofia auth:logout أولًا.

متغيرات البيئة

جاهز للنشر؟ انتقل إلى المنشورات.