POST/api/auth/reset-password

Ställer in ett nytt lösenord med reset-token från återställningsmeddelandet.

Skicka `token` (från länken i återställningsmeddelandet) och det nya `password` i JSON-kroppen. Inloggning krävs inte för detta. Lösenordet måste uppfylla Zentor Apps minimikrav. Vid framgång svarar servern med `{"ok":true}`; därefter loggar användaren in med det nya lösenordet. En ogiltig, utgången eller redan använd token samt ett lösenord som inte uppfyller minimikraven resulterar i 400 `VALIDATION_ERROR`. En token förbrukas efter lyckad användning; för en ny ändring startar du en ny process via `POST /api/auth/forgot-password`. Slutpunkten är begränsad till 10 förfrågningar per 15 minuter per IP-adress. Överför endast token och lösenord i förfrågans kropp via HTTPS, aldrig som URL-parametrar.

Översikt

Anrop: POST /api/auth/reset-password. Endpointen tillhör gruppen ”Autentisering” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: token (body), password (body). Dokumenterade felfall: 400 VALIDATION_ERROR. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.

Autentisering & säkerhet

Ingen autentisering krävs

Idempotent: Nej

Parametrar

token(body, string, obligatorisk)— Reset-token från e-postmeddelandet
password(body, string, obligatorisk)— Nytt lösenord

Exempel på request

{"token":"<Token från återställningsmejlet>","password":"NyttSakertLosenord!"}

Exempel på response

{"ok":true}

Felkoder

400 VALIDATION_ERROR — Token är ogiltig, utgången eller redan använd, eller lösenordet uppfyller inte minimikraven.

Verifierat beteende

En ogiltig token returnerar 400 `VALIDATION_ERROR`. Framgångsfallet (200 `{"ok":true}`) beskrivs utifrån det dokumenterade förloppet.

Autentisering

Relaterade artiklar

← Autentisering