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 compte

Exemple 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

Articles associés

← Authentification