POST/api/auth/forgot-password
Dé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.
Envoyez l'adresse e-mail du compte dans le champ `email`. La réponse `{"ok":true}` est volontairement toujours identique – que le compte existe ou non – afin que cet endpoint ne permette pas de déterminer quelles adresses sont enregistrées. Le nouveau mot de passe est ensuite défini avec le jeton de l'e-mail via `POST /api/auth/reset-password`. Si le champ `email` est manquant ou vide, l'endpoint répond avec 400 `VALIDATION_ERROR`. Pour prévenir les abus, le nombre de requêtes par adresse IP est limité (429 `RATE_LIMIT_EXCEEDED`).
Vue d'ensemble
Appel : POST /api/auth/forgot-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 est idempotent : des appels répétés avec les mêmes données renvoient le même résultat. Paramètres obligatoires : email (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: Oui
Paramètres
email(body, string, requis)— Adresse e-mail du compteExemple de requête
{"email":"user@example.com"}Exemple de réponse
{"ok":true}Codes d'erreur
400 VALIDATION_ERROR — Le champ `email` est manquant ou vide.Comportement vérifié
La réponse est 200 `{"ok":true}`, que le compte existe ou non ; un champ e-mail manquant 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/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/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.