Envoyer l'e-mail de vérification à une adresse e-mail
POST /v1/users/{user_id}/emails/{email_id}:send-verification · autorisation users:write
Envoie l'e-mail de vérification à une ligne d'adresse e-mail de l'utilisateur. email_id est l'UUID interne (en minuscules, avec tirets). La réponse contient l'expiration de la demande de vérification ; aucun code ni lien n'est renvoyé. Le corps facultatif sert uniquement à choisir la langue de l'e-mail.
Requête
| Paramètre | Dans | Obligatoire | Description |
|---|---|---|---|
user_id |
path | oui | Identifiant de l'utilisateur, préfixé usr_. |
email_id |
path | oui | Identifiant de la ligne d'adresse e-mail (UUID interne, en minuscules, avec tirets). |
Corps facultatif :
| Champ | Type | Obligatoire | Description |
|---|---|---|---|
locale |
string | non | Étiquette de langue BCP 47 de l'e-mail, par exemple tr ou pt-BR. Par défaut, la langue de l'utilisateur ou de l'environnement. |
Réponse
200 OK. expires_at indique la date d'expiration de la demande de vérification.
{
"expires_at": "2026-01-16T09:30:00Z"
}
Erreurs
Chaque erreur est un corps application/problem+json avec un code stable.
| HTTP | code |
Quand |
|---|---|---|
| 400 | malformed_request, unknown_field |
Le corps n'est pas un JSON valide ou contient un champ inconnu. |
| 409 | conflict |
L'adresse e-mail est déjà vérifiée. |
| 415 | unsupported_media_type |
Un corps a été envoyé sans Content-Type: application/json. |
| 422 | validation_failed |
locale n'est pas une étiquette de langue BCP 47 valide, ou un champ a un type incorrect. |
| 404 | not_found |
L'utilisateur ou la ligne d'adresse e-mail n'existe pas dans cet environnement, l'adresse n'appartient pas à cet utilisateur, ou un identifiant est mal formé. |
| 401 | unauthenticated |
La clé API est absente, invalide ou révoquée. |
| 403 | insufficient_permissions |
La clé ne dispose pas de l'autorisation users:write. |
| 429 | rate_limited |
La limite de débit de l'API ou la limite d'envoi d'e-mails par utilisateur a été dépassée ; respectez Retry-After. |
| 503 | service_unavailable |
Une dépendance est temporairement indisponible ; réessayez plus tard. |
Exemple
curl -X POST https://api.eu.keenauth.com/v1/users/usr_0a1b2c3d4e5f6g7h8j9k0m1n2p/emails/0191f0a0-3333-7444-8555-666666666666:send-verification \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"locale": "en"}'
Données personnelles
Cet endpoint traite des données personnelles : profil de l'utilisateur final. Données personnelles dans les API KeenAuth décrit ce qui est stocké, la durée de conservation et la manière dont elles sont supprimées. N'envoyez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.