Vai al contenuto principale
GET
curl
L’API della cronologia delle consegne Travel Rule di Didit restituisce tutte le voci di consegna relative a una transazione, suddivise in pagine, dalla più vecchia alla più recente. Usa la tua x-api-key con l’autorizzazione di lettura delle transazioni. transaction_id è l’UUID della transazione Didit. Una transazione o un trasferimento mancante restituisce 404; un’autorizzazione insufficiente restituisce 403.

Paginazione e ordinamento

La risposta contiene count, next, previous e results. limit ha come valore predefinito 100 ed è limitato a 100; offset ha come valore predefinito zero e non deve superare 1.000.000, altrimenti restituisce 400. count è di norma limitato a 100 e non è un totale affidabile per cronologie più estese. Segui next finché non è null, indipendentemente da count. Le voci sono ordinate per ora di creazione e, in caso di parità, per identificatore. Ogni voce contiene uuid, kind, status, rail, created_at, delivered_at e detail_lines. rail è EMAIL, TRP, INTERNAL, NETWORK oppure null prima della selezione. detail_lines descrive il tipo di messaggio e lo stato senza errori non elaborati né payload di trasporto.

Cronologia incorporata

Dettaglio transazione include solo le ultime 100 voci in travel_rule.deliveries, presentate dalla più vecchia alla più recente. deliveries_truncated indica se sono state omesse voci più vecchie. Le liste delle transazioni omettono questi due campi della cronologia. Il campo esistente delivery continua a descrivere l’ultima consegna. Per il significato degli stati, consulta consegna e nuovi tentativi. Messaggi della controparte sono un endpoint separato dedicato alla conversazione.

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.

Parametri della query

limit
integer
predefinito:100

Voci per pagina. Il valore predefinito è 100 e i valori più grandi sono limitati a 100; un valore superiore a 1.000.000 restituisce 400.

Intervallo richiesto: 1 <= x <= 1000000
offset
integer
predefinito:0

Numero di voci da saltare, fino a 1.000.000. Un valore più alto restituisce 400.

Intervallo richiesto: 0 <= x <= 1000000

Risposta

Cronologia paginata delle consegne, dalla più vecchia alla più recente.

count
integer
obbligatorio

Conteggio normalmente limitato a 100; non è un totale affidabile per cronologie più lunghe. Segui next finché non è null, indipendentemente da count.

Intervallo richiesto: x >= 0
next
string<uri> | null
obbligatorio

URL della pagina successiva, oppure null.

previous
string<uri> | null
obbligatorio

URL della pagina precedente, o null.

results
object[]
obbligatorio

Voci ordinate dalla più vecchia alla più recente per data di creazione, quindi per identificativo.

Ultima modifica il 12 novembre 2026