POST/api/auth/reset-password

پاس ورڈ ری سیٹ ای میل سے ری سیٹ ٹوکن کے ساتھ ایک نیا پاس ورڈ سیٹ کرتا ہے۔

JSON باڈی میں `token` (ری سیٹ ای میل کے لنک سے) اور نیا `password` بھیجیں۔ اس کے لیے لاگ ان ضروری نہیں۔ پاس ورڈ کو Zentor App کے کم از کم تقاضے پورے کرنا ضروری ہے۔ کامیابی کی صورت میں سرور `{"ok":true}` کے ساتھ جواب دیتا ہے؛ اس کے بعد صارف نئے پاس ورڈ کے ساتھ لاگ ان کرتا ہے۔ غلط، میعاد ختم یا پہلے سے استعمال شدہ ٹوکن، اور کم از کم تقاضے پورے نہ کرنے والا پاس ورڈ، 400 `VALIDATION_ERROR` کا سبب بنتے ہیں۔ کامیاب استعمال کے بعد ٹوکن ختم ہو جاتا ہے؛ مزید تبدیلی کے لیے `POST /api/auth/forgot-password` کے ذریعے نیا عمل شروع کریں۔ یہ اینڈ پوائنٹ فی IP ایڈریس ہر 15 منٹ میں 10 درخواستوں تک محدود ہے۔ ٹوکن اور پاس ورڈ صرف درخواست باڈی میں HTTPS کے ذریعے بھیجیں، کبھی URL پیرامیٹرز کے طور پر نہیں۔

جائزہ

کال: POST /api/auth/reset-password۔ یہ اینڈپوائنٹ Zentor App کی API کے گروپ “توثیق” سے تعلق رکھتا ہے۔ یہ عوامی طور پر قابلِ رسائی ہے اور اس کے لیے کسی تصدیق (authentication) کی ضرورت نہیں۔ یہ کال idempotent نہیں ہے: ہر کامیاب کال عمل کو دوبارہ متحرک کرتی ہے۔ لازمی پیرامیٹرز: token (باڈی), password (باڈی)۔ دستاویزی ایرر کیسز: 400 VALIDATION_ERROR۔ نیچے دیا گیا نمونہ جواب JSON فارمیٹ میں کامیاب جواب کی ساخت دکھاتا ہے۔

تصدیقِ شناخت اور تحفظ

تصدیقِ شناخت ضروری نہیں

Idempotent (دہرانے پر یکساں اثر): نہیں

پیرامیٹرز

token(body, string، ضروری)— ای میل سے ری سیٹ ٹوکن
password(body, string، ضروری)— نیا پاس ورڈ

مثالی Request

{"token":"<ری سیٹ ای میل سے ٹوکن>","password":"NeuesSicheresPasswort!"}

مثالی Response

{"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/exchangeSSO لاگ ان (SAML/OIDC) کا آخری مرحلہ: ری ڈائریکٹ سے ایک بار استعمال ہونے والے کوڈ کو ایکسیس ٹوکن اور ریفریش ٹوکن سے بدلتا ہے۔

متعلقہ مضامین

← توثیق