POST/api/auth/reset-password
Imposta una nuova password con il token di ripristino dall'e-mail di ripristino.
Inviate `token` (dal link dell'e-mail di ripristino) e la nuova `password` nel corpo JSON. Per questo non è necessario alcun accesso. La password deve soddisfare i requisiti minimi di Zentor App. In caso di successo, il server risponde con `{"ok":true}`; successivamente l'utente accede con la nuova password. Un token non valido, scaduto o già utilizzato, così come una password che non soddisfa i requisiti minimi, comportano 400 `VALIDATION_ERROR`. Un token viene consumato dopo un utilizzo riuscito; per un'ulteriore modifica avviate un nuovo processo tramite `POST /api/auth/forgot-password`. L'endpoint è limitato a 10 richieste ogni 15 minuti per indirizzo IP. Trasmettete token e password solo nel corpo della richiesta tramite HTTPS, mai come parametro URL.
Panoramica
Chiamata: POST /api/auth/reset-password. Questo endpoint appartiene al gruppo «Autenticazione» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata non è idempotente: ogni chiamata riuscita attiva nuovamente l'azione. Parametri obbligatori: token (body), password (body). Casi di errore documentati: 400 VALIDATION_ERROR. La risposta di esempio riportata di seguito mostra la struttura di una risposta riuscita in formato JSON.
Autenticazione e sicurezza
Nessuna autenticazione richiesta
Idempotente: No
Parametri
token(body, string, obbligatorio)— Token di ripristino dall'e-mailpassword(body, string, obbligatorio)— Nuova passwordRichiesta di esempio
{"token":"<Token dalla e-mail di reset>","password":"NuovaPasswordSicura!"}Risposta di esempio
{"ok":true}Codici di errore
400 VALIDATION_ERROR — Il token non è valido, è scaduto o è già stato utilizzato, oppure la password non soddisfa i requisiti minimi.Comportamento verificato
Un token non valido restituisce 400 `VALIDATION_ERROR`. Il caso di successo (200 `{"ok":true}`) è descritto sulla base del flusso documentato.
Autenticazione
POST /api/auth/loginAutentica un utente con indirizzo e-mail o nome utente e password, ed emette un token di accesso (JWT) e un refresh token.POST /api/auth/refreshScambia un refresh token valido con una nuova coppia di token di accesso e refresh token.POST /api/auth/forgot-passwordAvvia il ripristino di una password: se esiste un account con l'indirizzo e-mail indicato, riceve un'e-mail con un link per il ripristino.POST /api/auth/sso/exchangeUltimo passaggio di un accesso SSO (SAML/OIDC): scambia il codice a uso unico del reindirizzamento con un token di accesso e un refresh token.