Saltar al contingut principal
GET
curl
L’API d’historial de lliuraments de Travel Rule de Didit retorna totes les entrades de lliurament d’una transacció, paginades de la més antiga a la més recent. Utilitza la teva x-api-key amb permís de lectura de transaccions. transaction_id és l’UUID de la transacció de Didit. Si no es troba la transacció o la transferència, es retorna 404; si el permís és insuficient, es retorna 403.

Paginació i ordenació

La resposta conté count, next, previous i results. limit té per defecte 100 i està limitat a 100; offset té per defecte zero i no pot superar 1.000.000, cosa que retorna 400. Normalment count està limitat a 100 i no és un total fiable per a historials més llargs. Segueix next fins que sigui null, independentment de count. Les entrades s’ordenen per data de creació i, en cas d’empat, per identificador. Cada entrada té uuid, kind, status, rail, created_at, delivered_at i detail_lines. rail és EMAIL, TRP, INTERNAL, NETWORK o null abans de la selecció. detail_lines descriu el tipus de missatge i l’estat sense errors bruts ni payloads de transport.

Historial incrustat

Detall de la transacció inclou només les 100 entrades més recents de travel_rule.deliveries, presentades de més antiga a més recent. deliveries_truncated indica si s’han omès entrades més antigues. Les llistes de transaccions no inclouen aquests dos camps d’historial. El camp existent delivery continua descrivint el lliurament més recent. Consulta lliurament i reintents per veure el significat dels estats. Els missatges de la contrapart són un endpoint de conversa independent.

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.

Paràmetres de consulta

limit
integer
predeterminat:100

Entrades per pàgina. El valor per defecte és 100, i els valors més grans es limiten a 100; un valor superior a 1,000,000 retorna 400.

Rang requerit: 1 <= x <= 1000000
offset
integer
predeterminat:0

Nombre d'entrades que s'han d'ometre, fins a 1.000.000. Un valor més gran retorna 400.

Rang requerit: 0 <= x <= 1000000

Resposta

Historial de lliuraments paginat, de més antic a més recent.

count
integer
requerit

El recompte normalment està limitat a 100; no és un total fiable per a històrics més grans. Segueix next fins que sigui null, independentment de count.

Rang requerit: x >= 0
next
string<uri> | null
requerit

URL de la pàgina següent, o null.

previous
string<uri> | null
requerit

URL de la pàgina anterior, o null.

results
object[]
requerit

Entrades ordenades de la més antiga a la més recent segons l'hora de creació i, després, l'identificador.

Darrera modificació el 12 de novembre del 2026