Pular para o conteúdo principal
GET
/
v1
/
webhooks
/
dlq
Listar Mensagens da DLQ
curl --request GET \
  --url https://plugin-br-bank-transfer.sandbox.lerian.net/v1/webhooks/dlq \
  --header 'Authorization: Bearer <token>'
{ "messages": [ { "messageId": "019c96a0-d1d2-7e3f-4a5b-6c7d8e9f0a1b", "routingKey": "webhook.transfer.completed", "deathReason": "rejected", "failureReason": "HTTP 500 from subscriber", "tenantId": "11111111-1111-1111-1111-111111111111", "transferId": "019c96a0-ab10-7cde-f1a2-0e1f2a3b4c5d", "eventType": "transfer.completed", "correlationId": "019c96a0-cc10-7abc-d1e2-3f4a5b6c7d8e", "retryCount": 5, "manualRetryCount": 1, "timestamp": "2026-02-01T15:35:00-03:00" } ], "totalCount": 1, "returnedCount": 1, "returned": 1, "hasNextPage": false, "hasMore": false }

Autorizações

​
Authorization
string
header
obrigatório

Autenticação por token JWT Bearer. O tenantId é derivado do token bearer ou do contexto de requisição autenticado e não é fornecido por meio do X-Organization-Id.

Parâmetros de consulta

​
limit
integer
padrão:50

Número máximo de mensagens a retornar.

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

Número de mensagens a pular para paginação.

Intervalo obrigatório: x >= 0

Resposta

Indica que a página de mensagens da DLQ foi retornada com sucesso.

​
messages
object[]
obrigatório
​
totalCount
integer
obrigatório

Quantidade de mensagens filtradas por tenant visitadas durante este scan. Quando hasMore é true, este é um limite inferior best-effort sobre a profundidade real da DLQ para este tenant, não o total real.

Intervalo obrigatório: x >= 0
Exemplo:

1

​
returnedCount
integer
obrigatório

Número de mensagens nesta página após aplicar offset e limit.

Intervalo obrigatório: x >= 0
Exemplo:

1

​
returned
integer

Número de mensagens retornadas nesta página.

Intervalo obrigatório: x >= 0
Exemplo:

1

​
hasNextPage
boolean

Se há mais mensagens visíveis ao tenant além desta página.

Exemplo:

false

​
hasMore
boolean

True quando o inspector parou o scan cedo após preencher a página atual.

Exemplo:

false

​
warning
string

Definido quando a paginação pode ser não-determinística (por exemplo, acesso concorrente desloca a ordenação).

Exemplo:

"pagination may be non-deterministic under concurrent access"