Saltar al contingut principal
PATCH
curl
Les claus de camp són les que has configurat per al document al flux de treball. Consulta Document AI per saber com es configuren els documents i els camps, i l’informe de Document AI per veure on apareix el resultat a la decisió 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ó (el session_id retornat per POST /v3/session/). Accepta tant IDs de sessió de Verificació d'usuaris (KYC) com de Verificació d'empreses (KYB): el servidor resol l'ID entre tots dos tipus de sessió. Ha de ser un UUID ben format; un valor mal format no coincideix amb la ruta i retorna un 404 en HTML.

Exemple:

"11111111-2222-3333-4444-555555555555"

documentUuid
string<uuid>
requerit

UUID del document de Document AI (document_ai_documents[].items[].uuid a GET /v3/session/{sessionId}/decision/). Ha de pertànyer a la sessió de la ruta.

Exemple:

"44444444-5555-6666-7777-888888888888"

Cos

application/json
extracted_data
object

Claus de camp (les claus que has configurat per al document) i els seus valors corregits. Ha de ser un objecte JSON; es fusiona clau per clau amb les dades emmagatzemades. Omet-lo en comptes d'enviar null, que retorna 400.

Exemple:
status
enum<string>

Nou estat de revisió del document.

Opcions disponibles:
Approved,
Declined,
In Review,
Not Finished
Exemple:

"Approved"

Resposta

Document actualitzat. Retorna el document després de la fusió.

uuid
string<uuid>
requerit

Identificador del document.

document_key
string
requerit

El document configurat al qual correspon aquesta càrrega.

original_filename
string | null
requerit

Nom de fitxer amb el qual s'ha penjat el document.

file_url
string | null
requerit

Ruta d'emmagatzematge del fitxer carregat. No és un enllaç de descàrrega: llegeix el camp presignat file_url de la decisió de la sessió per descarregar el fitxer.

status
enum<string>
requerit

Estat de revisió del document.

Opcions disponibles:
Not Finished,
Approved,
Declined,
In Review,
Resub Requested
extracted_data
object | null
requerit

Tots els camps extrets després de la fusió, indexats per clau de camp.

Darrera modificació el 7 de novembre del 2026