POST/api/auth/refresh

ایک درست ریفریش ٹوکن کو ایکسیس ٹوکن اور ریفریش ٹوکن کے نئے جوڑے سے بدلتا ہے۔

آخری موصول ہونے والا `refreshToken` JSON باڈی میں بھیجیں۔ جواب میں ایک نیا `token` اور ایک نیا `refreshToken` شامل ہے۔ ہر ریفریش ٹوکن صرف ایک بار استعمال ہو سکتا ہے اور طے شدہ طور پر سات دن کے لیے درست ہے؛ ہر کال کے بعد نیا ٹوکن محفوظ کریں اور پرانا ضائع کر دیں۔ گم شدہ، غلط، میعاد ختم یا پہلے سے استعمال شدہ ریفریش ٹوکن 400 `VALIDATION_ERROR` کا سبب بنتا ہے۔ صارف کو پھر `POST /api/auth/login` کے ذریعے دوبارہ لاگ ان کرنا ہوگا۔ چونکہ ریفریش ٹوکن استعمال کے ساتھ ختم ہو جاتا ہے، کلائنٹ کو متوازی تازہ کاری سے گریز کرنا چاہیے۔

جائزہ

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

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

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

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

پیرامیٹرز

refreshToken(body, string، ضروری)— آخری جاری شدہ ریفریش ٹوکن

مثالی Request

{"refreshToken":"</login سے حاصل کردہ ریفریش ٹوکن>"}

مثالی Response

{"ok":true,"token":"<نیا JWT>","refreshToken":"<نیا ریفریش ٹوکن>"}

خرابی کے کوڈز

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

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

← توثیق