POST/api/auth/refresh

Échange un jeton de rafraîchissement valide contre une nouvelle paire de jeton d'accès et de jeton de rafraîchissement.

Envoyez le `refreshToken` reçu le plus récemment dans le corps JSON. La réponse contient un nouveau `token` et un nouveau `refreshToken`. Chaque jeton de rafraîchissement n'est utilisable qu'une seule fois et est valable sept jours par défaut ; stockez le nouveau jeton après chaque appel et supprimez l'ancien. Un jeton de rafraîchissement manquant, invalide, expiré ou déjà utilisé entraîne 400 `VALIDATION_ERROR`. L'utilisateur doit alors se reconnecter via `POST /api/auth/login`. Comme un jeton de rafraîchissement est consommé lors de son utilisation, un client doit éviter les renouvellements parallèles.

Vue d'ensemble

Appel : POST /api/auth/refresh. Ce point de terminaison appartient au groupe « Authentification » de l'API de Zentor App. Il est accessible publiquement et ne nécessite aucune authentification. L'appel n'est pas idempotent : chaque appel réussi déclenche à nouveau l'action. Paramètres obligatoires : refreshToken (body). Cas d'erreur documentés : 400 VALIDATION_ERROR. L'exemple de réponse ci-dessous montre la structure d'une réponse réussie au format JSON.

Authentification et sécurité

Aucune authentification requise

Idempotent: Non

Paramètres

refreshToken(body, string, requis)— Dernier jeton de rafraîchissement délivré

Exemple de requête

{"refreshToken":"<Refresh-Token issu de /login>"}

Exemple de réponse

{"ok":true,"token":"<nouveau JWT>","refreshToken":"<nouveau Refresh-Token>"}

Codes d'erreur

400 VALIDATION_ERROR — Le jeton de rafraîchissement est manquant, invalide, expiré ou a déjà été utilisé.

Comportement vérifié

Un jeton de rafraîchissement valide renvoie une nouvelle paire de jetons ; un jeton invalide renvoie 400 `VALIDATION_ERROR`.

Authentification

Articles associés

← Authentification