POST/api/auth/reset-password

يضع كلمة مرور جديدة باستخدام رمز إعادة الضبط الوارد في بريد إعادة ضبط كلمة المرور.

أرسلوا `token` (من وصلة بريد إعادة الضبط) و`password` الجديد في نص الطلب بصيغة JSON. وتسجيل الدخول غير مطلوب لذلك. ويجب أن تستوفي كلمة المرور الحد الأدنى من متطلبات Zentor App. وعند النجاح يستجيب الخادم برمز `{"ok":true}`؛ وبعدها يسجّل المستخدم الدخول بكلمة المرور الجديدة. يؤدي رمز غير صالح أو منتهي الصلاحية أو مُستخدَم مسبقًا، وكذلك كلمة مرور لا تستوفي الحد الأدنى من المتطلبات، إلى رمز 400 `VALIDATION_ERROR`. ويُستهلَك الرمز بعد استخدامه بنجاح؛ ولإعادة الضبط مرة أخرى، ابدأوا عملية جديدة عبر `POST /api/auth/forgot-password`. والنقطة النهائية محدودة بـ 10 طلبات لكل 15 دقيقة لكل عنوان IP. أرسلوا الرمز وكلمة المرور فقط في نص الطلب عبر HTTPS، وليس كمعاملات في عنوان URL أبدًا.

نظرة عامة

الاستدعاء: POST /api/auth/reset-password. تنتمي نقطة النهاية هذه إلى مجموعة «المصادقة» في واجهة برمجة تطبيقات Zentor App. يمكن الوصول إليها بشكل عام ولا تتطلب أي مصادقة. الاستدعاء غير متساوي القوة (idempotent): كل استدعاء ناجح يُطلق الإجراء من جديد. المعاملات الإلزامية: token (النص (Body)), password (النص (Body)). حالات الخطأ الموثقة: 400 VALIDATION_ERROR. يوضح مثال الاستجابة أدناه بنية الاستجابة الناجحة بتنسيق JSON.

المصادقة والأمان

لا يلزم أي مصادقة

متطابق القوة: لا

المعلمات

token(body, string، إلزامي)— رمز إعادة الضبط من البريد الإلكتروني
password(body, string، إلزامي)— كلمة المرور الجديدة

مثال طلب

{"token":"<رمز من بريد إعادة التعيين>","password":"كلمة مرورك الجديدة الآمنة!"}

مثال استجابة

{"ok":true}

رموز الأخطاء

400 VALIDATION_ERROR — الرمز غير صالح أو منتهي الصلاحية أو مُستخدَم مسبقًا، أو أن كلمة المرور لا تستوفي الحد الأدنى من المتطلبات.

السلوك المُتحقَّق منه

يُعيد رمز غير صالح رمز 400 `VALIDATION_ERROR`. وتُوصَف حالة النجاح (200 `{"ok":true}`) بناءً على سير العملية الموثَّق.

المصادقة

POST /api/auth/loginيسجّل دخول مستخدم باستخدام البريد الإلكتروني أو اسم المستخدم وكلمة المرور، ويصدر رمز وصول (JWT) ورمز تحديث.POST /api/auth/refreshيستبدل رمز تحديث صالحًا بزوج جديد من رمز الوصول ورمز التحديث.POST /api/auth/forgot-passwordيبدأ إعادة ضبط كلمة المرور: إذا كان هناك حساب بالبريد الإلكتروني المحدد، فإنه يتلقى بريدًا إلكترونيًا بوصلة لإعادة الضبط.POST /api/auth/sso/exchangeالخطوة الأخيرة في تسجيل دخول SSO (SAML/OIDC): تستبدل الرمز الأحادي الاستخدام من إعادة التوجيه برمز وصول ورمز تحديث.

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

← المصادقة