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`.

المصادقة

مقالات ذات صلة

← المصادقة