Rendre une adresse e-mail principale
POST /fapi/v1/me/emails/{email_id}:set-primary · appelé depuis l'hôte de connexion de l'environnement
Rend principale l'une des adresses e-mail vérifiées de l'utilisateur authentifié. Une adresse non vérifiée ne peut pas devenir principale ; vérifiez-la d'abord. Après la modification, l'ancienne adresse principale et les autres adresses vérifiées de l'utilisateur reçoivent une notification de sécurité contenant un lien « ce n'est pas moi » qui ouvre la récupération du compte. Si l'adresse est déjà principale, la réponse reste 204 et rien n'est modifié ni envoyé. Nécessite le cookie __Host-idp_session de l'utilisateur authentifié ; si le cookie est absent, expiré ou révoqué, renvoie 401 unauthenticated. Une application de premier niveau sur une autre origine peut à la place envoyer son jeton d'accès à l'API front (Authorization: DPoP <token> avec une preuve DPoP ; voir Jeton d'accès à l'API front).
La session doit avoir été vérifiée au cours des 5 dernières minutes. Si l'utilisateur dispose d'un second facteur, la session doit aussi avoir été ouverte avec un second facteur (urn:idp:acr:mfa).
Requête
En-têtes :
| En-tête | Obligatoire | Description |
|---|---|---|
Idp-Client |
oui | Identifiant du SDK. |
Origin |
oui | Doit être exactement https://<hôte de connexion>. |
email_id : l'identifiant de l'adresse e-mail, la même valeur que celle utilisée par les endpoints /v1/users/{user_id}/emails de l'API de gestion (UUID en minuscules).
Pas de corps.
Réponse
204 No Content.
Erreurs
| Statut | Code | Quand |
|---|---|---|
| 401 | unauthenticated |
Aucun cookie de session valide. |
| 401 | step_up_required |
La session n'a pas été vérifiée au cours des 5 dernières minutes ou un second facteur est requis ; vérifiez à nouveau avec max_age=300 (et, le cas échéant, acr_values) dans l'en-tête WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin est absent ou incorrect. |
| 404 | not_found |
Cette adresse e-mail n'existe pas pour cet utilisateur. |
| 409 | primary_requires_verified |
L'adresse e-mail n'est pas vérifiée. |
Exemple
curl -X POST https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc:set-primary \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-b cookies.txt
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. Ne transmettez aucune catégorie particulière de données personnelles (santé, données biométriques, religion, opinions politiques, orientation sexuelle) dans aucun champ.