Esporta i miei dati
POST /fapi/v1/me/exports · chiamato dall'host di accesso dell'ambiente
Avvia un'esportazione dei dati propri dell'utente autenticato (GDPR, articoli 15 e 20). Il pacchetto viene preparato in background; quando è pronto, l'utente riceve un'email nella lingua della richiesta e il file può essere scaricato con Scarica un'esportazione per 7 giorni.
Il pacchetto è un file ZIP con un file JSON per ogni tipo di dato: profilo, indirizzi email e numeri di telefono, identità collegate, autenticatori (senza segreti), sessioni con i relativi indirizzi IP, appartenenze alle organizzazioni, concessioni OAuth, consensi ed eventi di accesso. Non contiene mai un hash della password, un seed TOTP, codici di recupero, token o app_metadata.
Richiede un accesso recente: se la sessione non è stata verificata negli ultimi 5 minuti, oppure l'utente ha un secondo fattore e la sessione non lo ha usato, la risposta è 401 step_up_required e non viene avviato nulla. Se un'esportazione dell'utente è ancora in preparazione, viene restituita quella e non ne parte una nuova. Un utente può richiedere al massimo 2 esportazioni in 24 ore.
Richiesta
Intestazioni:
| Intestazione | Obbligatoria | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Origin |
sì | Deve essere esattamente https://<host di accesso>. |
Corpo:
{}
Risposta
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}
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). |
| 403 | origin_not_allowed |
Origin manca o è errato. |
| 429 | export_rate_limited |
Due esportazioni sono già state richieste nelle ultime 24 ore; riprova dopo Retry-After. |
| 429 | rate_limited |
Troppe esportazioni sono in preparazione nell'ambiente; riprova dopo Retry-After. |
| 503 | service_unavailable |
La directory degli utenti è temporaneamente non disponibile; riprova dopo Retry-After. |
Esempio
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
Dati personali
Questo endpoint tratta dati personali: richieste di privacy (i record di esportazione propri dell'utente). 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.