Export herunterladen
GET /fapi/v1/me/exports/{export_id}/download · wird vom Anmeldehost der Umgebung aufgerufen
Gibt das ZIP-Paket eines abgeschlossenen Exports des angemeldeten Benutzers als Anhang zurück (Content-Type: application/zip, Content-Disposition: attachment; filename="user-export-job_….zip"). Vergleichen Sie die Datei mit file.sha256 des Exports, um sie zu prüfen. Jeder Download wird im Audit-Log der Umgebung protokolliert, bevor das erste Byte gesendet wird. Bricht die Übertragung ab, wird die Verbindung geschlossen, damit eine unvollständige Datei nicht vollständig wirkt; laden Sie die Datei erneut herunter.
Wie bei der Anfrage ist eine aktuelle Anmeldung erforderlich: Wurde die Sitzung nicht in den letzten 5 Minuten verifiziert oder hat der Benutzer einen zweiten Faktor und die Sitzung hat ihn nicht verwendet, lautet die Antwort 401 step_up_required. HEAD wird nicht unterstützt (405).
Anfrage
Header:
| Header | Erforderlich | Beschreibung |
|---|---|---|
Idp-Client |
ja | SDK-Kennung. |
Antwort
200 OK mit der ZIP-Datei als Body.
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). |
| 404 | not_found |
Für diesen Benutzer gibt es keinen solchen Export. |
| 409 | conflict |
Der Export ist noch nicht abgeschlossen oder seine Datei ist abgelaufen. |
| 503 | service_unavailable |
Das Benutzerverzeichnis ist vorübergehend nicht verfügbar; wiederholen Sie die Anfrage nach Retry-After. |
Beispiel
curl -OJ https://example.keenauth.app/fapi/v1/me/exports/job_01jbx4k6v8m2c9w5s7r3t1q0zy/download \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Personenbezogene Daten
Dieser Endpunkt verarbeitet personenbezogene Daten: Benutzerprofil, Zugangsdaten, verknüpfte Identitäten, Sitzungen, Organisationsmitgliedschaften und Einladungen, Zustimmungsdatensätze, Umgebungsprotokolle und Datenschutzanfragen (das Paket enthält die eigenen Daten des Benutzers aus jeder dieser Kategorien). 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).