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-mail
password(body, string, requis)— Nouveau mot de passe

Exemple 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

Articles associés

← Authentification