Reintentar Mensaje DLQ

Utilice este endpoint para republicar un mensaje DLQ específico de vuelta a la cola principal de procesamiento de webhooks. Solo los mensajes que pertenecen al tenant del llamador son elegibles. El tenant se deriva del JWT bearer (claim tenantId).

Esta ruta solo se monta cuando la autenticación está habilitada y un inspector de DLQ está configurado. De lo contrario, no se expone y cualquier solicitud es rechazada con 503.

POST /v1/transfers/webhooks/dlq/{messageId}/retry

Reintentar Mensaje DLQ

cURL

curl --request POST \
  --url https://plugin-br-bank-transfer.sandbox.lerian.net/v1/transfers/webhooks/dlq/{messageId}/retry \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Idempotency: <x-idempotency>'

200

retried

{
  "status": "retried",
  "messageId": "019c96a0-d1d2-7e3f-4a5b-6c7d8e9f0a1b"
}

Autorizaciones

Authorization · string · header · requerido

Autenticación mediante token JWT Bearer. El tenantId se deriva del token bearer o del contexto autenticado de la solicitud y no se proporciona a través de X-Organization-Id.

Encabezados

X-Organization-Id · string<uuid>

Alcance de organización Midaz para la solicitud. En despliegues multi-tenant este header es obligatorio. Este no es el identificador del tenant; el tenantId se deriva del JWT bearer o del contexto autenticado. En despliegues single-tenant los valores de X-Organization-Id proporcionados por el llamador son rechazados y la organización es proporcionada por SINGLE_TENANT_ORGANIZATION_ID.

X-Idempotency · string · requerido

Clave de idempotencia requerida para reintentos seguros. Utilice un UUID v4 o un identificador de negocio único. Si se envía la misma clave nuevamente y la solicitud original ya fue procesada, se devuelve la respuesta almacenada en caché.

Consulte Reintentos e idempotencia para más detalles.

Maximum string length: 255

Parámetros de ruta

messageId · string · requerido

El identificador del mensaje DLQ a reintentar.

Respuesta

200

application/json

Indica que el mensaje DLQ fue republicado en la cola principal.

status · enum<string> · requerido

Etiqueta del resultado del reintento.

Opciones disponibles: retried

Ejemplo:

"retried"

messageId · string · requerido

Repite el identificador del mensaje DLQ que fue republicado.

Ejemplo:

"019c96a0-d1d2-7e3f-4a5b-6c7d8e9f0a1b"