POST/api/auth/reset-password
पासवर्ड को एक वैध रीसेट टोकन के आधार पर पुनः सेट करता है।
`POST /api/auth/reset-password` एक वैध रीसेट टोकन की मदद से पासवर्ड को नए सिरे से सेट करता है। इस रूट के लिए पहले से मौजूद लॉगिन की आवश्यकता नहीं है, क्योंकि यह ठीक उन्हीं उपयोगकर्ताओं के लिए है जो अपना पिछला पासवर्ड अब उपयोग नहीं कर सकते। रिक्वेस्ट बॉडी में `token` और `password` भेजे जाते हैं। टोकन पहले भेजे गए रीसेट ईमेल से आता है; नए पासवर्ड को सर्वर-साइड लागू न्यूनतम आवश्यकताओं को पूरा करना होगा। यह कॉल idempotent नहीं है। सफल रीसेट के बाद उपयोग किया गया टोकन खर्च हो जाता है, यानी वह किसी और पासवर्ड परिवर्तन के लिए अभिप्रेत नहीं है। इसलिए कोई क्लाइंट अस्पष्ट रूप से बाधित रिक्वेस्ट को तेज़ लूप में नहीं दोहरा सकता। इसके बजाय उसे परिणाम दिखाना चाहिए और आवश्यकता होने पर उपयोगकर्ता को Forgot-Password फ़ंक्शन के माध्यम से नई रीसेट प्रक्रिया शुरू करने देनी चाहिए। अमान्य, समाप्त या पहले से उपयोग किया गया टोकन, तथा न्यूनतम आवश्यकताओं को पूरा न करने वाला पासवर्ड `400 VALIDATION_ERROR` की ओर ले जाता है। सार्वजनिक त्रुटि संदेश को खाते का कोई अतिरिक्त विवरण प्रकट नहीं करना चाहिए। टोकन और नया पासवर्ड न तो URL पैरामीटर में, न एनालिटिक्स टूल, सार्वजनिक लॉग या सपोर्ट स्क्रीनशॉट में दिखाई देने चाहिए। यह रिक्वेस्ट केवल HTTPS से सुरक्षित फ़ॉर्म प्रक्रिया में ही भेजी जानी चाहिए। सफल रिस्पॉन्स `{"ok":true}` होता है। यह किए गए पासवर्ड परिवर्तन की पुष्टि करता है, स्वतः किसी नए लॉगिन की नहीं। रीसेट के बाद उपयोगकर्ता को नए पासवर्ड से सामान्य रूप से लॉग इन करना चाहिए। मौजूदा सत्रों को वास्तविक बैकएंड लॉजिक के अनुसार संभाला जाना चाहिए; यदि यह सिद्ध नहीं है, तो दस्तावेज़ीकरण सभी डिवाइसों से सामूहिक लॉगआउट का दावा नहीं कर सकता। प्रमाणित लाइव टेस्ट में अमान्य टोकन वाला नकारात्मक मामला और अपेक्षित स्टेटस 400 शामिल है। इस प्रमाण के लिए किसी प्रोडक्टिव टोकन के साथ वास्तविक सफल रीसेट अलग से नहीं किया गया। पाठ को इस सीमा को स्पष्ट रूप से बनाए रखना होगा और Login या Forgot Password से समानता के आधार पर किसी कथित End-to-End सफलता का निष्कर्ष नहीं निकालना चाहिए।
Auth & Absicherung
कोई प्रमाणीकरण आवश्यक नहीं
Idempotent: Nein
Parameter
token(body, string, erforderlich)— ईमेल से रीसेट टोकनpassword(body, string, erforderlich)— नया पासवर्डBeispiel-Request
{"token":"<Reset-ईमेल से टोकन>","password":"नयासुरक्षितपासवर्ड!"}Beispiel-Response
{"ok":true}Fehlercodes
400 VALIDATION_ERROR — टोकन अमान्य है, समाप्त हो चुका है, या पासवर्ड न्यूनतम आवश्यकताओं को पूरा नहीं करता है।Live-Test-Nachweis
नकारात्मक मामला (400, अमान्य टोकन) लाइव सत्यापित किया गया; सफल मामला मेकानिकली रूप से forgot-password/login के समान है, वास्तविक रीसेट टोकन के साथ अलग से नहीं चलाया गया।