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