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-postmeddelandetpassword(body, string, obligatorisk)— Nytt lösenordExempel 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
POST /api/auth/loginLoggar in en användare med e-postadress eller användarnamn och lösenord och utfärdar en åtkomsttoken (JWT) samt en refresh-token.POST /api/auth/refreshByter en giltig refresh-token mot ett nytt par av åtkomsttoken och refresh-token.POST /api/auth/forgot-passwordStartar en återställning av lösenord: om det finns ett konto med den angivna e-postadressen får det ett e-postmeddelande med en länk för återställning.POST /api/auth/sso/exchangeSista steget i en SSO-inloggning (SAML/OIDC): byter engångskoden från omdirigeringen mot en åtkomsttoken och en refresh-token.