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-mail
password(body, string, obbligatorio)— Nuova password

Richiesta 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

Articoli correlati

← Autenticazione