Vai al contenuto principale
PATCH
curl
I link pre-firmati in extra_files scadono. Leggi quelli nuovi dalla decisione della sessione quando ti servono di nuovo i file. Per correggere i dati estratti da un documento, usa invece Aggiorna i dati della sessione.

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 degli utenti (KYC) a cui aggiungere il file (il session_id restituito da POST /v3/session/). L'ID di una sessione di Verifica aziendale (KYB) restituisce 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

Corpo

multipart/form-data
file
file
obbligatorio

L'immagine o il PDF. Estensioni consentite: jpg, jpeg, png, webp, tiff, pdf. Al massimo 15 MB al caricamento; il file viene poi compresso e rifiutato con 400 se supera ancora i 2 MB (2.097.152 byte). I file vuoti vengono rifiutati.

model_type
enum<string>
obbligatorio

kyc aggiunge il file al risultato della verifica dell'identità, poa al risultato della prova di residenza.

Opzioni disponibili:
kyc,
poa
Esempio:

"kyc"

file_password
string

Password di un PDF crittografato. Senza di essa, o con una password errata, un PDF crittografato restituisce 400.

Risposta

File aggiunto. Restituisce tutti i file aggiuntivi di quel risultato, compreso quello nuovo.

extra_files
(string<uri> | null)[]
obbligatorio

Link pre-firmati di breve durata a tutti i file extra del risultato indicato da model_type, dal più vecchio al più recente. Ciascun link è null per una chiave API con ambito limitato senza media: read. Leggi nuovi link in seguito dalla decisione della sessione.

Ultima modifica il 7 novembre 2026