Pular para o conteúdo principal
GET
curl
A API de histórico de entregas do Travel Rule da Didit retorna todas as entradas de entrega de uma transação, paginadas da mais antiga para a mais recente. Use sua x-api-key com a permissão de leitura de transações. transaction_id é o UUID da transação na Didit. Uma transação ou transferência inexistente retorna 404; permissão insuficiente retorna 403.

Paginação e ordenação

A resposta contém count, next, previous e results. limit tem como padrão 100 e é limitado a 100; offset tem como padrão zero e não pode exceder 1,000,000, caso contrário retorna 400. count normalmente é limitado a 100 e não é um total confiável para históricos maiores. Siga next até que ele seja null, independentemente de count. As entradas são ordenadas pela data de criação e, em caso de empate, pelo identificador. Cada entrada tem uuid, kind, status, rail, created_at, delivered_at e detail_lines. rail é EMAIL, TRP, INTERNAL, NETWORK ou null antes da seleção. detail_lines descreve o tipo de mensagem e o status, sem erros brutos ou payloads de transporte.

Histórico incorporado

Detalhe da transação inclui apenas as 100 entradas mais recentes em travel_rule.deliveries, apresentadas da mais antiga para a mais recente. deliveries_truncated indica se entradas mais antigas foram omitidas. Listas de transações omitem esses dois campos de histórico. O campo existente delivery continua descrevendo a entrega mais recente. Consulte entrega e novas tentativas para o significado dos status. Mensagens da contraparte são um endpoint de conversa separado.

Autorizações

x-api-key
string
header
obrigatório

Chave de API da sua aplicação, em Developers -> API keys no Business Console. A chave principal tem acesso total. Uma chave nomeada pode ter escopo restrito: nenhum acesso, leitura ou escrita por recurso, limitada a alguns fluxos ou a sessões aprovadas, a uma lista de endereços IP e a uma data de validade. 401 significa que a chave está errada, revogada ou expirada; 403 significa que nenhuma chave foi enviada, que a chave não tem acesso a este recurso ou ação, ou que a requisição veio de um endereço fora da sua lista de IPs; 404 em uma rota de sessão significa que a sessão está fora dos fluxos ou status da chave. Uma chave sem acesso a mídia recebe URLs de imagem, vídeo e PDF como null, e uma chave sem permissão de escrita em sessões recebe links e tokens de sessão como null. Consulte https://docs.didit.me/console/api-keys.

Parâmetros de caminho

transaction_id
string<uuid>
obrigatório

UUID estável da transação na Didit à qual a transferência pertence.

Parâmetros de consulta

limit
integer
padrão:100

Entradas por página. O padrão é 100, e valores maiores são limitados a 100; um valor acima de 1.000.000 retorna 400.

Intervalo obrigatório: 1 <= x <= 1000000
offset
integer
padrão:0

Número de entradas a pular, até 1.000.000. Um valor maior retorna 400.

Intervalo obrigatório: 0 <= x <= 1000000

Resposta

Histórico de entregas paginado, do mais antigo para o mais recente.

count
integer
obrigatório

Contagem normalmente limitada a 100; não é um total confiável para históricos maiores. Siga next até null, independentemente de count.

Intervalo obrigatório: x >= 0
next
string<uri> | null
obrigatório

URL da próxima página, ou null.

previous
string<uri> | null
obrigatório

URL da página anterior, ou null.

results
object[]
obrigatório

Entradas ordenadas da mais antiga para a mais recente pela data de criação e, em seguida, pelo identificador.

Última modificação em 12 de novembro de 2026