Saltar al contingut principal
POST
curl

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

transaction_id
string<uuid>
requerit

UUID de transacció estable de Didit que posseeix la transferència.

Cos

Envia-ho com a JSON, o com a multipart/form-data amb els fitxers adjunts a files.

kind
enum<string>
predeterminat:MESSAGE
Opcions disponibles:
MESSAGE,
DOCUMENT_REQUEST
body
string

Obligatori per a un MESSAGE tret que s'adjunti un fitxer.

Maximum string length: 5000
requested_documents
string[]

Obligatori (almenys un) per a un DOCUMENT_REQUEST, i només permès aquí.

Maximum array length: 10
Maximum string length: 255
reply_to
string<uuid> | null

Un missatge de la mateixa transferència. Una resposta que conté un document satisfà la sol·licitud de document a la qual respon.

files
file[]

Només multipart. Fins a 5 fitxers de 10 MB cadascun.

Maximum array length: 5

Resposta

El missatge emmagatzemat.

id
string<uuid>
kind
enum<string>
Opcions disponibles:
MESSAGE,
DOCUMENT_REQUEST
direction
enum<string>

OUTBOUND és el que ha enviat la part del lector. Al portal de recollida, la direcció és des de la part de la contrapart.

Opcions disponibles:
INBOUND,
OUTBOUND
author
string

Qui ho ha escrit per la seva banda: el correu electrònic d'un usuari de la consola o l'etiqueta d'una clau d'API, o el nom de l'altre VASP.

body
string
requested_documents
string[]

El que sol·licita un DOCUMENT_REQUEST, en paraules del sol·licitant.

reply_to
string<uuid> | null
fulfilled_at
string<date-time> | null

S'estableix en una DOCUMENT_REQUEST un cop la resposta conté un document.

attachment
object | null

El document adjunt a un missatge, emmagatzemat com qualsevol altre document de transacció.

created_at
string<date-time>
Darrera modificació el 7 de novembre del 2026