Meine Daten exportieren
POST /fapi/v1/me/exports · wird vom Anmeldehost der Umgebung aufgerufen
Startet einen Export der eigenen Daten des angemeldeten Benutzers (GDPR Artikel 15 und 20). Das Paket wird im Hintergrund vorbereitet; sobald es bereit ist, erhält der Benutzer eine E-Mail in der Sprache der Anfrage, und die Datei kann 7 Tage lang mit Export herunterladen heruntergeladen werden.
Das Paket ist eine ZIP-Datei mit einer JSON-Datei pro Datenart: Profil, E-Mail-Adressen und Telefonnummern, verknüpfte Identitäten, Authentifikatoren (ohne Geheimnisse), Sitzungen mit ihren IP-Adressen, Organisationsmitgliedschaften, OAuth-Berechtigungen, Zustimmungen und Anmeldeereignisse. Es enthält niemals einen Passwort-Hash, einen TOTP-Seed, Wiederherstellungscodes, Token oder app_metadata.
Erforderlich ist eine aktuelle Anmeldung: Wurde die Sitzung nicht in den letzten 5 Minuten bestätigt oder ist ein zweiter Faktor erforderlich und die Sitzung hat ihn nicht verwendet, lautet die Antwort 401 step_up_required und nichts wird gestartet. Wird gerade ein Export des Benutzers vorbereitet, wird dieser zurückgegeben und kein neuer gestartet. Ein Benutzer kann höchstens 2 Exporte innerhalb von 24 Stunden anfordern.
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Origin |
ja | Muss genau https://<sign-in host> sein. |
Inhalt:
{}
Antwort
202 Accepted:
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
"created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
Fehler
| Status | Code | Wann |
|---|---|---|
| 401 | unauthenticated |
Kein gültiges Sitzungs-Cookie. |
| 401 | step_up_required |
Anmeldung älter als 5 Minuten oder ein zweiter Faktor ist erforderlich; der Header WWW-Authenticate enthält max_age=300 (und acr_values, wenn ein zweiter Faktor erforderlich ist). |
| 403 | origin_not_allowed |
Origin fehlt oder ist falsch. |
| 429 | export_rate_limited |
Zwei Exporte wurden in den letzten 24 Stunden bereits angefordert; erneut versuchen nach Retry-After. |
| 429 | rate_limited |
Zu viele Exporte werden in der Umgebung gerade vorbereitet; erneut versuchen nach Retry-After. |
| 503 | service_unavailable |
Das Benutzerverzeichnis ist vorübergehend nicht verfügbar; erneut versuchen nach Retry-After. |
Beispiel
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Datenschutzanfragen (die eigenen Exportdatensätze des Benutzers). 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).