Elencare le mie esportazioni
GET /fapi/v1/me/exports · chiamato dall'host di accesso dell'ambiente
Restituisce le esportazioni dei dati dell'utente con sessione attiva degli ultimi 30 giorni, dalla più recente, al massimo 10. Compaiono solo le esportazioni richieste dall'utente; quelle avviate da un amministratore tramite l'API di gestione o la dashboard non sono elencate. Richiede il cookie __Host-idp_session dell'utente autenticato. Un'app di prima parte su un'altra origine può invece inviare il proprio token di accesso della Front API (Authorization: DPoP <token> con una prova DPoP; vedi Token di accesso della Front API). La lettura non richiede un accesso recente.
Ogni esportazione ha uno status: queued e running mentre viene preparata, completed quando il file può essere scaricato, failed con un failure_reason (too_large, user_deleted, source_unavailable, attempts_exhausted), ed expired una volta eliminato il file (7 giorni dopo il completamento). file riporta dimensione e SHA-256 del pacchetto quando è completata o scaduta.
Richiesta
Intestazioni:
| Intestazione | Obbligatoria | Descrizione |
|---|---|---|
Idp-Client |
sì | Identificatore dell'SDK. |
Risposta
200 OK:
{"data": [{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "completed",
"file": {"size": 48213, "sha256": "9f2c5e0d4b1a7c3e8f6d2b0a9c4e1f7d3b5a8c2e6f0d4b9a1c7e3f5d2b8a0c6e"},
"failure_reason": null, "created_at": "2026-11-03T09:30:00Z", "started_at": "2026-11-03T09:30:02Z",
"completed_at": "2026-11-03T09:30:09Z", "expires_at": "2026-11-10T09:30:09Z"}]}
Errori
| Stato | Codice | Quando |
|---|---|---|
| 401 | unauthenticated |
Nessun cookie di sessione valido. |
| 503 | service_unavailable |
La directory utenti è temporaneamente non disponibile; riprova dopo Retry-After. |
Esempio
curl https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
Dati personali
Questo endpoint contiene dati personali: richieste sulla privacy (i registri di esportazione dell'utente stesso). 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.