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.