POST/api/auth/forgot-password

Avvia 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.

Inviate l'indirizzo e-mail dell'account nel campo `email`. La risposta `{"ok":true}` è deliberatamente sempre identica – indipendentemente dall'esistenza di un account – così questo endpoint non permette di scoprire quali indirizzi sono registrati. La nuova password viene poi impostata con il token dell'e-mail tramite `POST /api/auth/reset-password`. Se il campo `email` manca o è vuoto, l'endpoint risponde con 400 `VALIDATION_ERROR`. Per prevenire abusi, il numero di richieste per indirizzo IP è limitato (429 `RATE_LIMIT_EXCEEDED`).

Panoramica

Chiamata: POST /api/auth/forgot-password. Questo endpoint appartiene al gruppo «Autenticazione» dell'API di Zentor App. È accessibile pubblicamente e non richiede autenticazione. La chiamata è idempotente: chiamate ripetute con gli stessi dati restituiscono lo stesso risultato. Parametri obbligatori: email (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: Sì

Parametri

email(body, string, obbligatorio)— Indirizzo e-mail dell'account

Richiesta di esempio

{"email":"user@example.com"}

Risposta di esempio

{"ok":true}

Codici di errore

400 VALIDATION_ERROR — Il campo `email` manca o è vuoto.

Comportamento verificato

La risposta è 200 `{"ok":true}`, indipendentemente dall'esistenza dell'account; un campo e-mail mancante restituisce 400 `VALIDATION_ERROR`.

Autenticazione

Articoli correlati

← Autenticazione