Supprimer une adresse e-mail
DELETE /fapi/v1/me/emails/{email_id} · appelé depuis l'hôte de connexion de l'environnement
Supprime l'une des adresses e-mail de l'utilisateur authentifié. L'adresse principale ne peut pas être supprimée ; rendez d'abord une autre adresse vérifiée principale. Si l'environnement exige une adresse e-mail, la dernière adresse vérifiée de l'utilisateur ne peut pas non plus être supprimée. 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 renvoyé par GET /fapi/v1/me/emails (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_identifier_required |
L'adresse est l'adresse principale. |
| 409 | last_verified_channel |
L'adresse est la dernière adresse vérifiée de l'utilisateur et l'environnement exige une adresse e-mail. |
Exemple
curl -X DELETE https://example.keenauth.app/fapi/v1/me/emails/0190a5c4-1b2c-7d3e-8f40-516273849abc \
-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.