Vai al contenuto principale
POST
Python

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 aziendale (KYB). Deve appartenere all'applicazione della chiave API.

Esempio:

"33333333-4444-5555-6666-777777777777"

Parametri della query

node_id
string

Nodo del workflow del passaggio KYB. Necessario solo quando il workflow contiene più di un nodo KYB; per impostazione predefinita Didit utilizza il nodo della sessione stessa.

Corpo

multipart/form-data
documents
file[]
obbligatorio

File da caricare: JPG, JPEG, PNG, TIFF, WEBP, PDF o archivi ZIP contenenti questi formati. PDF fino a 50 MB, foto fino a 6 MB prima della compressione.

document_passwords
string[]

Una voce per ciascun file in documents, nello stesso ordine: la password di un PDF protetto, vuota per qualsiasi altro file.

document_group
enum<string>

Gruppo di documenti richiesto a cui risponde questo caricamento.

Opzioni disponibili:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Locale utilizzato per tradurre la risposta del passaggio successivo.

Maximum string length: 10

Risposta

Documenti elaborati. Quando ogni gruppo obbligatorio è soddisfatto, la sessione avanza e next_step indica il passaggio successivo; altrimenti rimane nel passaggio Documenti e document_groups e document_answer indicano cosa manca ancora.

valid
boolean
next_step
string | null

Passaggio in cui si trova la sessione dopo il caricamento.

kyb_status
string

Stato del controllo aziendale.

document_answer
object

Risultato per ciascun documento caricato e caricamenti rimanenti.

Ultima modifica il 7 novembre 2026