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'accountRichiesta 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
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/reset-passwordImposta una nuova password con il token di ripristino dall'e-mail di 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.