Vai al contenuto principale
POST
curl
Prepara un unico ZIP con tutti i file di una sessione di Verifica degli utenti (KYC) o Verifica aziendale (KYB): lati del documento, selfie, video di rilevamento della vitalità e documenti caricati, in qualità originale. Lo ZIP viene preparato in background. La chiamata restituisce 202 con l’esportazione: leggila con Recupera l’esportazione dei file finché status è READY, quindi scarica download_url.
  • Finché un’esportazione della stessa sessione è ancora in preparazione, la chiamata restituisce quella esportazione invece di avviarne una nuova.
  • Lo ZIP viene eliminato 24 ore dopo essere diventato pronto, e subito quando la sessione viene eliminata.
  • Una sessione eliminata non può essere esportata: la chiamata restituisce 404.
  • Ogni esportazione viene registrata nel registro di audit della sessione.
  • Una chiave API con ambito limitato richiede media: read e decisions: read.

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

sessionId
string<uuid>
obbligatorio

UUID della sessione di verifica (il session_id restituito da POST /v3/session/). Accetta sia ID di sessione di Verifica degli utenti (KYC) sia di Verifica aziendale (KYB). Una sessione eliminata restituisce 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

Risposta

L'esportazione, in fase di preparazione.

Uno ZIP con tutti i file di una sessione, in qualità originale.

export_id
string<uuid>
obbligatorio

ID dell'esportazione. Passalo a GET /v3/session/{sessionId}/files-export/{exportId}/.

session_id
string<uuid>
obbligatorio

La sessione da cui provengono i file.

status
enum<string>
obbligatorio

PENDING e PROCESSING durante la preparazione dello ZIP, READY non appena può essere scaricato, FAILED quando non è stato possibile prepararlo (richiedi una nuova esportazione), EXPIRED una volta che lo ZIP è stato eliminato.

Opzioni disponibili:
PENDING,
PROCESSING,
READY,
FAILED,
EXPIRED
file_count
integer | null
obbligatorio

File presenti nel file ZIP. Impostato solo quando status è READY.

size_bytes
integer<int64> | null
obbligatorio

Dimensione dello ZIP in byte. Impostata solo mentre status è READY.

download_url
string<uri> | null
obbligatorio

URL firmato dello ZIP, valido per un breve periodo di tempo. Impostato solo mentre status è READY; leggi nuovamente l'esportazione per ottenerne uno nuovo.

expires_at
string<date-time> | null
obbligatorio

Data e ora di eliminazione del file ZIP, 24 ore dopo essere stato pronto. Impostato solo mentre status è READY.

error
string | null
obbligatorio

Il motivo per cui l'esportazione è fallita, quando status è FAILED.

created_at
string<date-time>
obbligatorio

Data e ora della richiesta di esportazione.

completed_at
string<date-time> | null
obbligatorio

Data e ora in cui il file ZIP era pronto o in cui l'esportazione non è riuscita.

Ultima modifica il 7 novembre 2026