POST/api/auth/reset-password
Définit un nouveau mot de passe à l'aide du jeton de réinitialisation provenant de l'e-mail de réinitialisation.
Envoyez `token` (issu du lien de l'e-mail de réinitialisation) et le nouveau `password` dans le corps JSON. Aucune connexion n'est nécessaire pour cela. Le mot de passe doit satisfaire aux exigences minimales de Zentor App. En cas de succès, le serveur répond avec `{"ok":true}` ; l'utilisateur se connecte ensuite avec le nouveau mot de passe. Un jeton invalide, expiré ou déjà utilisé, ainsi qu'un mot de passe ne satisfaisant pas aux exigences minimales, entraînent 400 `VALIDATION_ERROR`. Un jeton est consommé après une utilisation réussie ; pour un nouveau changement, démarrez un nouveau processus via `POST /api/auth/forgot-password`. L'endpoint est limité à 10 requêtes par 15 minutes par adresse IP. Transmettez le jeton et le mot de passe uniquement dans le corps de la requête via HTTPS, jamais comme paramètre d'URL.
Vue d'ensemble
Appel : POST /api/auth/reset-password. 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 : token (body), password (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
token(body, string, requis)— Jeton de réinitialisation issu de l'e-mailpassword(body, string, requis)— Nouveau mot de passeExemple de requête
{"token":"<Reset-Token reçu par e-mail>","password":"NouveauMotDePasseSecurise!"}Exemple de réponse
{"ok":true}Codes d'erreur
400 VALIDATION_ERROR — Le jeton est invalide, expiré ou déjà utilisé, ou le mot de passe ne satisfait pas aux exigences minimales.Comportement vérifié
Un jeton invalide renvoie 400 `VALIDATION_ERROR`. Le cas de succès (200 `{"ok":true}`) est décrit sur la base du déroulement documenté.
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/refreshÉchange un jeton de rafraîchissement valide contre une nouvelle paire de jeton d'accès et de jeton de rafraîchissement.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/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.