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
POST /api/auth/loginConnecte un utilisateur avec une adresse e-mail ou un nom d'utilisateur et un mot de passe, et délivre un jeton d'accès (JWT) ainsi qu'un jeton de rafraîchissement (refresh token).POST /api/auth/forgot-passwordDémarre la réinitialisation d'un mot de passe : si un compte existe avec l'adresse e-mail indiquée, il reçoit un e-mail avec un lien de réinitialisation.POST /api/auth/reset-passwordDéfinit un nouveau mot de passe à l'aide du jeton de réinitialisation provenant de l'e-mail de réinitialisation.POST /api/auth/sso/exchangeDernière étape d'une connexion SSO (SAML/OIDC) : échange le code à usage unique issu de la redirection contre un jeton d'accès et un jeton de rafraîchissement.