Saltar al contenido principal
GET
Lista las observaciones de dead-letter

Autorizaciones

Authorization
string
header
requerido

Un JWT bearer emitido por plugin-auth (lib-auth). La identidad del tenant se resuelve a partir de los claims validados del token; la superficie /v1 nunca lee un tenant del cuerpo, del path ni de la query. Los llamadores de máquina obtienen un token vía el flujo client-credentials de plugin-auth. La superficie /admin autoriza contra un scope de operador y no lleva 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.

Opciones disponibles:
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.

Respuesta

Una página de observaciones de dead-letter.

observations
object[]
requerido

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

nextCursor
string
requerido

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

Ejemplo:

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