Vai al contenuto principale
PATCH
curl
Le chiavi dei campi sono quelle configurate per il documento nel workflow. Consulta Document AI per capire come impostare documenti e campi, e il report di Document AI per vedere dove compare il risultato nella decisione 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 (il session_id restituito da POST /v3/session/). Accetta sia ID di sessione di Verifica degli utenti (KYC) sia di Verifica aziendale (KYB): il server risolve l'ID per entrambi i tipi di sessione. Deve essere un UUID ben formato; un valore malformato non corrisponde alla route e restituisce una pagina HTML 404.

Esempio:

"11111111-2222-3333-4444-555555555555"

documentUuid
string<uuid>
obbligatorio

UUID del documento Document AI (document_ai_documents[].items[].uuid in GET /v3/session/{sessionId}/decision/). Deve appartenere alla sessione indicata nel percorso.

Esempio:

"44444444-5555-6666-7777-888888888888"

Corpo

application/json
extracted_data
object

Chiavi di campo (le chiavi configurate per il documento) e i relativi valori corretti. Deve essere un oggetto JSON; unito chiave per chiave nei dati memorizzati. Omettilo invece di inviare null, che restituisce 400.

Esempio:
status
enum<string>

Nuovo stato di revisione del documento.

Opzioni disponibili:
Approved,
Declined,
In Review,
Not Finished
Esempio:

"Approved"

Risposta

Documento aggiornato. Restituisce il documento dopo l'unione.

uuid
string<uuid>
obbligatorio

Identificativo del documento.

document_key
string
obbligatorio

Il documento configurato a cui corrisponde questo caricamento.

original_filename
string | null
obbligatorio

Nome del file con cui è stato caricato il documento.

file_url
string | null
obbligatorio

Percorso di archiviazione del file caricato. Non è un link di download: leggi la file_url pre-firmata dalla decisione della sessione per scaricare il file.

status
enum<string>
obbligatorio

Stato di revisione del documento.

Opzioni disponibili:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
obbligatorio

Tutti i campi estratti dopo l'unione, indicizzati per chiave di campo.

Ultima modifica il 7 novembre 2026