Saltar al contingut principal
POST
Python

Autoritzacions

x-api-key
string
header
requerit

La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys.

Paràmetres de ruta

sessionId
string<uuid>
requerit

UUID de la sessió de Verificació d'empreses (KYB). Ha de pertànyer a l'aplicació de la clau d'API.

Exemple:

"33333333-4444-5555-6666-777777777777"

Paràmetres de consulta

node_id
string

Node del flux de treball del pas de KYB. Només cal quan el flux de treball té més d'un node de KYB; per defecte, Didit utilitza el node propi de la sessió.

Cos

multipart/form-data
documents
file[]
requerit

Fitxers per penjar: JPG, JPEG, PNG, TIFF, WEBP, PDF o arxius ZIP que en continguin. PDF de fins a 50 MB, fotos de fins a 6 MB abans de la compressió.

document_passwords
string[]

Una entrada per fitxer a documents, en el mateix ordre: la contrasenya d'un PDF protegit, buit per a qualsevol altre fitxer.

document_group
enum<string>

Grup de documents obligatori al qual respon aquesta càrrega.

Opcions disponibles:
LEGAL_PRESENCE,
COMPANY_DETAILS,
OWNERSHIP_STRUCTURE,
REPRESENTATIVES_AUTHORIZATION
locale
string

Configuració regional utilitzada per traduir la resposta del pas següent.

Maximum string length: 10

Resposta

Documents processats. Quan es compleix cada grup requerit, la sessió avança i next_step indica el pas següent; en cas contrari, roman al pas de Documents i document_groups i document_answer indiquen què falta encara.

valid
boolean
next_step
string | null

Pas en què es troba la sessió després de la càrrega.

kyb_status
string

Estat de la comprovació de l'empresa.

document_answer
object

Resultat per document pujat i les càrregues restants.

Darrera modificació el 7 de novembre del 2026