POST/api/auth/reset-password
Stel 'n nuwe wagwoord in met die reset-token uit die terugstel-e-pos.
Stuur `token` (uit die skakel van die reset-e-pos) en die nuwe `password` in die JSON-liggaam. 'n Aanmelding is daarvoor nie nodig nie. Die wagwoord moet aan die minimumvereistes van Zentor App voldoen. By sukses antwoord die bediener met `{"ok":true}`; daarna meld die gebruiker met die nuwe wagwoord aan. 'n Ongeldige, verlopde of reeds gebruikte token asook 'n wagwoord wat nie die minimumvereistes bevredig nie, lei tot 400 `VALIDATION_ERROR`. 'n Token word na suksesvolle gebruik verbruik; vir 'n verdere wisseling begin 'n nuwe proses via `POST /api/auth/forgot-password`. Die eindpunt is beperk tot 10 versoeke per 15 minute per IP-adres. Stuur token en wagwoord slegs in die versoekliggaam via HTTPS, nooit as URL-parameter nie.
Oorsig
Oproep: POST /api/auth/reset-password. Hierdie eindpunt behoort tot die groep “Verifikasie” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: token (body), password (body). Gedokumenteerde foutgevalle: 400 VALIDATION_ERROR. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.
Verifikasie en sekuriteit
Geen verifikasie vereis nie
Idempotent: Nee
Parameters
token(body, string, vereis)— Reset-token uit die e-pospassword(body, string, vereis)— Nuwe wagwoordVoorbeeldversoek
{"token":"<Token uit die reset-e-pos>","password":"JouNuweVeiligeWagwoord!"}Voorbeeldrespons
{"ok":true}Foutkodes
400 VALIDATION_ERROR — Die token is ongeldig, verlope of reeds gebruik, of die wagwoord voldoen nie aan die minimumvereistes nie.Gekontroleerde gedrag
'n Ongeldige token lewer 400 `VALIDATION_ERROR`. Die suksesgeval (200 `{"ok":true}`) word volgens die gedokumenteerde proses beskryf.
Verifikasie
POST /api/auth/loginMeld 'n gebruiker aan met e-posadres of gebruikersnaam en wagwoord en gee 'n toegangstoken (JWT) asook 'n refresh-token uit.POST /api/auth/refreshRuil 'n geldige refresh-token vir 'n nuwe paar toegangstoken en refresh-token.POST /api/auth/forgot-passwordBegin die terugstel van 'n wagwoord: as 'n rekening met die opgegewe e-posadres bestaan, ontvang dit 'n e-pos met 'n skakel om terug te stel.POST /api/auth/sso/exchangeLaaste stap van 'n SSO-aanmelding (SAML/OIDC): ruil die eenmalige kode uit die herleiding vir 'n toegangstoken en 'n refresh-token.