Vai al contenuto principale
POST
curl

Autorizzazioni

x-api-key
string
header
obbligatorio

La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.

Parametri del percorso

transaction_id
string<uuid>
obbligatorio

UUID della transazione stabile di Didit a cui appartiene il trasferimento.

Corpo

Invia come JSON, o come multipart/form-data con gli allegati in files.

kind
enum<string>
predefinito:MESSAGE
Opzioni disponibili:
MESSAGE,
DOCUMENT_REQUEST
body
string

Obbligatorio per un MESSAGE a meno che non sia allegato un file.

Maximum string length: 5000
requested_documents
string[]

Obbligatorio (almeno uno) per un DOCUMENT_REQUEST, e consentito solo in tale contesto.

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

Un messaggio del medesimo trasferimento. Una risposta contenente un documento soddisfa la richiesta di documento a cui risponde.

files
file[]

Solo multipart. Fino a 5 file da 10 MB ciascuno.

Maximum array length: 5

Risposta

Il messaggio memorizzato.

id
string<uuid>
kind
enum<string>
Opzioni disponibili:
MESSAGE,
DOCUMENT_REQUEST
direction
enum<string>

OUTBOUND indica ciò che la tua parte ha inviato. Nel portale di ritiro la direzione è dal lato della controparte.

Opzioni disponibili:
INBOUND,
OUTBOUND
author
string

Chi lo ha scritto dalla propria parte: l'email di un utente della console o l'etichetta di una chiave API, oppure il nome dell'altro VASP.

body
string
requested_documents
string[]

Cosa richiede una DOCUMENT_REQUEST, secondo le parole del richiedente.

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

Impostato su un DOCUMENT_REQUEST quando una risposta ad esso contiene un documento.

attachment
object | null

Il documento allegato a un messaggio, archiviato come qualsiasi altro documento di transazione.

created_at
string<date-time>
Ultima modifica il 7 novembre 2026