Pular para o conteúdo principal
GET
Listar observações de dead-letter

Autorizações

Authorization
string
header
obrigatório

Um JWT bearer emitido pelo plugin-auth (lib-auth). A identidade do tenant é resolvida a partir das claims validadas do token; a superfície /v1 nunca lê um tenant do corpo, do path ou da query. Chamadores de máquina obtêm um token via o fluxo client-credentials do plugin-auth. A superfície /admin autoriza contra um escopo de operador e não carrega contexto de tenant.

Parâmetros de consulta

source_topic
string

Optional filter on the source topic the failed delivery originated from.

error_class
enum<string>

Optional filter on the transport error class. An unrecognized value returns 400 invalid_error_class. The transport error class a dead-letter observation may be filtered on.

Opções disponíveis:
serialization,
validation,
auth,
topic_not_found,
broker_unavailable,
network_timeout,
broker_overloaded,
context_canceled,
unknown
after
string<uuid>

Keyset cursor — the id (UUIDv7) of the last row from the previous page. A malformed value returns 400 invalid_cursor.

Resposta

Uma página de observações de dead-letter.

observations
object[]
obrigatório

A page of dead-letter observations, reverse-chronological.

nextCursor
string
obrigatório

Keyset cursor for the next (older) page — the id of the last row. Empty when there are no further pages.

Exemplo:

"0192f1a0-0000-7000-8000-00000000d017"