POST/api/auth/reset-password

מגדיר מחדש את הסיסמה באמצעות אסימון איפוס תקף.

`POST /api/auth/reset-password` משתמש באסימון איפוס תקף כדי להגדיר מחדש סיסמה. הנתיב אינו דורש הרשמה קיימת, שכן הוא מיועד למשתמשים שאינם יכולים עוד להשתמש בסיסמה הקודמת שלהם. בגוף הבקשה מועברים `token` ו-`password`. האסימון מגיע מהמייל לאיפוס שנשלח קודם לכן; הסיסמה החדשה חייבת לעמוד בדרישות המינימום החלות בצד השרת. ההתקשרות אינה אימפוטנטית (idempotent). לאחר איפוס מוצלח, האסימון ששימש נצרך ואינו מיועד עוד לשינוי סיסמה נוסף. לכן, לקוח אינו צריך לחזור ולשלוח בקשה זו בלולאה מהירה במקרה של בקשה שנפסקה באופן לא ברור. במקום זאת, עליו להציג את התוצאה ולאפשר למשתמש להתחיל תהליך איפוס חדש באמצעות פונקציית "שכחתי סיסמה" אם נדרש. אסימון לא תקף, פג תוקף או שכבר שימש, או סיסמה שאינה עומדת בדרישות המינימום, יובילו ל-`400 VALIDATION_ERROR`. ההודעה על שגיאה הציבורית לא צריכה לחשוף פרטים נוספים על החשבון. אסימון וסיסמה חדשה לא יופיעו לא בפרמטרי URL ולא בכלי ניתוח, ביומנים ציבוריים או בצילומי מסך של תמיכה. הבקשה מיועדת אך ורק לזרימת טופס המוגנת באמצעות HTTPS. תגובה מוצלחת תהיה `{"ok":true}`. היא מאשרת את שינוי הסיסמה שבוצע, אך אינה מאשרת באופן אוטומטי התחברות חדשה. לאחר האיפוס, על המשתמש להתחבר באופן רגיל עם הסיסמה החדשה. יש לטפל בהפעלות קיימות בהתאם ללוגיקה האמיתית של השרת; התיעוד לא צריך לטעון לפיטור גורף של כל המכשירים אם הדבר לא הוכח. מבחן החי ב-Live כולל את המקרה השלילי עם אסימון לא תקף וסטטוס 400 צפוי. איפוס מוצלח אמיתי לא בוצע בנפרד עם אסימון פרודקטיבי למטרת הוכחה זו. הטקסט חייב לשמור על ההבחנה הזו במפורש ולא להסיק הצלחה אנד-טו-אנד משוערת מהדמיון ל-Login או ל-Forgot Password.

{"token":"<Token aus Reset-Mail>","password":"NeuesSicheresPasswort!"}

{"ok":true}