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 recente

Richiesta 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

Articoli correlati

← Autenticazione