Scaricare un'esportazione
GET /fapi/v1/me/exports/{export_id}/download · chiamato dall'host di accesso dell'ambiente
Restituisce il pacchetto ZIP di una delle esportazioni completate dell'utente con sessione attiva, come allegato (Content-Type: application/zip, Content-Disposition: attachment; filename="user-export-job_….zip"). Confronta il file con file.sha256 dell'esportazione per verificarlo. Ogni download viene registrato nel log di audit dell'ambiente prima dell'invio del primo byte. Se il trasferimento si interrompe, la connessione viene chiusa così che un file parziale non sembri completo; scaricalo di nuovo.
Richiede un accesso recente, come la richiesta: se la sessione non è stata verificata negli ultimi 5 minuti, oppure l'utente ha un secondo fattore e la sessione non l'ha usato, la risposta è 401 step_up_required. HEAD non è supportato (405).
Richiesta
Intestazioni:
| Intestazione | Obbligatoria | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Risposta
200 OK con il file ZIP come body.
Errori
| Stato | Codice | Quando |
|---|---|---|
| 401 | unauthenticated |
Nessun cookie di sessione valido. |
| 401 | step_up_required |
Accesso più vecchio di 5 minuti oppure è richiesto un secondo fattore; l'intestazione WWW-Authenticate contiene max_age=300 (e acr_values quando è richiesto un secondo fattore). |
| 404 | not_found |
Nessuna esportazione di questo utente con questo identificatore. |
| 409 | conflict |
L'esportazione non è ancora completata oppure il suo file è scaduto. |
| 503 | service_unavailable |
La directory utenti è temporaneamente non disponibile; riprova dopo Retry-After. |
Esempio
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
Dati personali
Questo endpoint contiene dati personali: profilo dell'utente finale, credenziali, identità collegate, sessioni, appartenenze e inviti alle organizzazioni, registri del consenso, log dell'ambiente e richieste sulla privacy (il pacchetto contiene i dati dell'utente stesso di ciascuno di questi tipi). Dati personali nelle API di KeenAuth descrive cosa viene memorizzato, per quanto tempo viene conservato e come viene cancellato. Non inviare categorie particolari di dati personali (salute, dati biometrici, religione, opinioni politiche, orientamento sessuale) in nessun campo.