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-pos
password(body, string, vereis)— Nuwe wagwoord

Voorbeeldversoek

{"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

Verwante artikels

← Verifikasie