POST/api/auth/refresh
يستبدل رمز تحديث صالحًا بزوج جديد من رمز الوصول ورمز التحديث.
أرسلوا آخر `refreshToken` تم استلامه في نص الطلب بصيغة JSON. وتحتوي الاستجابة على `token` جديد و`refreshToken` جديد. كل رمز تحديث قابل للاستخدام مرة واحدة فقط، وصالح لمدة سبعة أيام افتراضيًا؛ احفظوا الرمز الجديد بعد كل استدعاء وتجاهلوا القديم. يؤدي رمز تحديث مفقود أو غير صالح أو منتهي الصلاحية أو مُستخدَم مسبقًا إلى رمز 400 `VALIDATION_ERROR`. وعلى المستخدم في هذه الحالة تسجيل الدخول مجددًا عبر `POST /api/auth/login`. ولأن رمز التحديث يُستهلَك عند استخدامه، ينبغي للعميل تجنب عمليات التجديد المتوازية.
نظرة عامة
الاستدعاء: POST /api/auth/refresh. تنتمي نقطة النهاية هذه إلى مجموعة «المصادقة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: refreshToken (النص (Body)). حالات الخطأ الموثقة: 400 VALIDATION_ERROR. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.
المصادقة والأمان
لا يلزم أي مصادقة
متطابق القوة: لا
المعلمات
refreshToken(body, string، إلزامي)— آخر رمز تحديث صادرمثال طلب
{"refreshToken":"<Refresh-Token من /login>"}مثال استجابة
{"ok":true,"token":"<JWT جديد>","refreshToken":"<Refresh-Token جديد>"}رموز الأخطاء
400 VALIDATION_ERROR — رمز التحديث مفقود أو غير صالح أو منتهي الصلاحية أو تم استخدامه مسبقًا.السلوك المُتحقَّق منه
يُعيد رمز تحديث صالح زوجًا جديدًا من الرموز؛ ويُعيد رمز غير صالح رمز 400 `VALIDATION_ERROR`.
المصادقة
POST /api/auth/loginيسجّل دخول مستخدم باستخدام البريد الإلكتروني أو اسم المستخدم وكلمة المرور، ويصدر رمز وصول (JWT) ورمز تحديث.POST /api/auth/forgot-passwordيبدأ إعادة ضبط كلمة المرور: إذا كان هناك حساب بالبريد الإلكتروني المحدد، فإنه يتلقى بريدًا إلكترونيًا بوصلة لإعادة الضبط.POST /api/auth/reset-passwordيضع كلمة مرور جديدة باستخدام رمز إعادة الضبط الوارد في بريد إعادة ضبط كلمة المرور.POST /api/auth/sso/exchangeالخطوة الأخيرة في تسجيل دخول SSO (SAML/OIDC): تستبدل الرمز الأحادي الاستخدام من إعادة التوجيه برمز وصول ورمز تحديث.