E-Mail-Adresse entfernen
DELETE /fapi/v1/me/emails/{email_id} · wird vom Anmeldehost der Umgebung aufgerufen
Entfernt eine der E-Mail-Adressen des authentifizierten Benutzers. Die Hauptadresse kann nicht entfernt werden; machen Sie zuerst eine andere bestätigte Adresse zur Hauptadresse. Wenn die Umgebung eine E-Mail-Adresse verlangt, kann auch die letzte bestätigte Adresse des Benutzers nicht entfernt werden. Erfordert das Cookie __Host-idp_session des authentifizierten Benutzers; fehlt das Cookie, ist es abgelaufen oder widerrufen, wird 401 unauthenticated zurückgegeben. Eine Erstanbieter-Anwendung auf einem anderen Ursprung kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Nachweis; siehe Front-API-Zugriffstoken).
Die Sitzung muss in den letzten 5 Minuten verifiziert worden sein. Hat der Benutzer einen zweiten Faktor, muss die Sitzung außerdem mit einem zweiten Faktor (urn:idp:acr:mfa) geöffnet worden sein.
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss exakt https://<sign-in host> sein. |
email_id: der Bezeichner der E-Mail-Adresse, den GET /fapi/v1/me/emails zurückgibt (UUID in Kleinbuchstaben).
Kein Body.
Antwort
204 No Content.
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 401 | step_up_required |
Die Sitzung wurde nicht in den letzten 5 Minuten verifiziert oder ein zweiter Faktor ist erforderlich; verifizieren Sie erneut mit max_age=300 (und gegebenenfalls acr_values) im Header WWW-Authenticate. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 404 | not_found |
Für diesen Benutzer gibt es keine solche E-Mail-Adresse. |
| 409 | primary_identifier_required |
Die Adresse ist die Hauptadresse. |
| 409 | last_verified_channel |
Die Adresse ist die letzte bestätigte des Benutzers, und die Umgebung verlangt eine E-Mail-Adresse. |
Beispiel
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
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Benutzerprofil. Personenbezogene Daten in den KeenAuth APIs beschreibt, welche Daten gespeichert werden, wie lange sie aufbewahrt werden und wie sie gelöscht werden. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).