POST/api/auth/refresh
Scambia un refresh token valido con una nuova coppia di token di accesso e refresh token.
Inviate nel corpo JSON il `refreshToken` ricevuto più di recente. La risposta contiene un nuovo `token` e un nuovo `refreshToken`. Ogni refresh token è utilizzabile una sola volta ed è valido per sette giorni per impostazione predefinita; salvate il nuovo token dopo ogni chiamata e scartate quello vecchio. Un refresh token mancante, non valido, scaduto o già utilizzato comporta 400 `VALIDATION_ERROR`. L'utente dovrà quindi accedere nuovamente tramite `POST /api/auth/login`. Poiché un refresh token viene consumato con l'uso, un client dovrebbe evitare rinnovi paralleli.
Panoramica
Chiamata: POST /api/auth/refresh. 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: refreshToken (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
refreshToken(body, string, obbligatorio)— Refresh token emesso più di recenteRichiesta di esempio
{"refreshToken":"<Refresh-Token da /login>"}Risposta di esempio
{"ok":true,"token":"<nuovo JWT>","refreshToken":"<nuovo Refresh-Token>"}Codici di errore
400 VALIDATION_ERROR — Il refresh token manca, non è valido, è scaduto o è già stato utilizzato.Comportamento verificato
Un refresh token valido restituisce una nuova coppia di token; un token non valido 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/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/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.