Saltar al contingut principal
PATCH
curl
Els enllaços presignats de extra_files caducen. Quan necessitis els fitxers més endavant, llegeix-ne de nous des de la decisió de la sessió. En canvi, per corregir les dades extretes d’un document, utilitza Actualitza les dades de la sessió.

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'usuaris (KYC) a la qual s'ha d'afegir el fitxer (el session_id retornat per POST /v3/session/). Un ID de sessió de Verificació d'empreses (KYB) retorna 404.

Exemple:

"11111111-2222-3333-4444-555555555555"

Cos

multipart/form-data
file
file
requerit

La imatge o PDF. Extensions permeses: jpg, jpeg, png, webp, tiff, pdf. Com a màxim 15 MB en pujar-la; posteriorment el fitxer es comprimeix i es rebutja amb un error 400 si encara supera els 2 MB (2.097.152 bytes). Els fitxers buits es rebutgen.

model_type
enum<string>
requerit

kyc afegeix el fitxer al resultat de Verificació d'identitat, poa al resultat de Comprovant de domicili.

Opcions disponibles:
kyc,
poa
Exemple:

"kyc"

file_password
string

Contrasenya d'un PDF xifrat. Sense ella, o amb una d'incorrecta, un PDF xifrat retorna 400.

Resposta

Fitxer afegit. Retorna tots els fitxers addicionals d'aquest resultat, inclòs el nou.

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

Enllaços presignats de curta durada a tots els fitxers addicionals del resultat anomenat per model_type, del més antic al més recent. Cada enllaç és null per a una clau d'API d'abast limitat sense media: read. Llegeix enllaços actualitzats des de la decisió de la sessió més endavant.

Darrera modificació el 7 de novembre del 2026