OAuthابدأ تفويضًا
العودة إلى Sofia

OAuth

ابدأ تفويضًا

افتحه في متصفح الشخص. عميل غير معروف أو redirect_uri غير مسجّل يعطي خطأ 400، وإلا يُعاد التوجيه إلى شاشة موافقة Sofia.

GEThttps://api.sofia-post.com/api/v1/oauth/authorize

معاملات الاستعلام

  • response_typestringمطلوب

    يجب أن تكون code.

  • client_idstringمطلوب

    قيمة client_id الخاصة بالعميل.

  • redirect_uristringمطلوب

    عنوان إعادة توجيه مسجّل، يُطابَق تمامًا.

  • scopestringمطلوب

    الصلاحيات المطلوبة، مفصولة بمسافة (offline_access للحصول على رمز تحديث).

  • statestring

    يُعاد دون تغيير عند العودة، لحماية العميل من CSRF.

  • code_challengestringمطلوب

    تحدّي PKCE، base64url(SHA-256(code_verifier))، وهو مطلوب لكل عميل.

  • code_challenge_methodstringمطلوب

    يجب أن تكون S256.

الاستجابة

302

يعيد التوجيه إلى شاشة الموافقة، أو يرسل الخطأ إلى redirect_uri.

400

invalid_client: عميل غير معروف أو redirect_uri غير مسجّل.