E-Mail-Adressen auflisten
GET /fapi/v1/me/emails · wird vom Anmelde-Host der Umgebung aufgerufen
Gibt die E-Mail-Adressen des authentifizierten Benutzers zurück, zuerst die primäre, danach sortiert nach dem Zeitpunkt, zu dem sie hinzugefügt wurden. Ein Benutzer kann höchstens 10 Adressen haben, einschließlich der primären. Erforderlich ist das Cookie __Host-idp_session des authentifizierten Benutzers. Fehlt das Cookie, ist es abgelaufen oder widerrufen, wird 401 unauthenticated zurückgegeben. Eine First-Party-Anwendung auf einem anderen Origin kann stattdessen ihr Front-API-Zugriffstoken senden (Authorization: DPoP <token> mit einem DPoP-Proof; siehe Front-API-Zugriffstoken).
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss genau https://<sign-in host> sein. |
Kein Body.
Antwort
200 OK:
| Feld | Typ | Beschreibung |
|---|---|---|
data[].id |
string | Kennung der E-Mail-Adresse (UUID in Kleinbuchstaben). |
data[].email |
string | Die Adresse. |
data[].verified |
boolean | Ob der Benutzer nachgewiesen hat, dass ihm die Adresse gehört. |
data[].primary |
boolean | Ob es sich um die primäre Adresse handelt. |
data[].created_at |
string | Zeitpunkt, zu dem die Adresse hinzugefügt wurde (RFC 3339, UTC). |
{
"data": [
{
"id": "0190a5c4-1b2c-7d3e-8f40-516273849abc",
"email": "ada@example.com",
"verified": true,
"primary": true,
"created_at": "2026-10-01T09:30:00Z"
}
]
}
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
Beispiel
curl https://example.keenauth.app/fapi/v1/me/emails \
-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: Profil des Endbenutzers. Personenbezogene Daten in den KeenAuth-APIs beschreibt, was gespeichert wird, wie lange es aufbewahrt wird und wie es gelöscht wird. Senden Sie in keinem Feld besondere Kategorien personenbezogener Daten (Gesundheit, biometrische Daten, Religion, politische Meinungen, sexuelle Orientierung).