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

application/json
locale
string

Configuració regional utilitzada per traduir la resposta del pas al qual avança la sessió.

Maximum string length: 10

Resposta

Parts declarades (o ja declarades).

valid
boolean
next_step
string | null

Pas en què es troba la sessió.

status
string

Estat de la sessió d'empresa.

advanced
boolean

true quan aquesta crida ha declarat les parts i ha fet avançar la sessió.

already_submitted
boolean

true quan les parts ja s'havien declarat en una crida anterior.

kyb_key_people_status
string
parties
object[]
Darrera modificació el 7 de novembre del 2026