Reanudar Poller de TED IN
Utilice este endpoint para limpiar el latch de recepción “at-most-once” fail-closed y re-armar un poller de TED IN latched o muerto sin reiniciar el pod. Este es un endpoint de operador con mayor privilegio que /ted-in/poll porque vuelve a abrir el consumo de lectura destructiva de JD. Recúrralo solo cuando la auto-recuperación no pueda revivir el poller — un hijo multi-tenant en panic o un poller de un solo tenant que superó el hard-cap de panic.
La reanudación nunca omite la barrera de brechas duraderas de la money-path. Cuando el latch live receive-state-unknown está activado, la fila de brecha de reconciliación del latch actual debe estar durable antes de que el poller se reanude; de lo contrario, la solicitud se rechaza con 409 y el poller permanece muerto. Verifique la brecha pendiente con Listar Brechas de Reconciliación de TED IN antes de llamar a resume.
El cuerpo opcional {acknowledge, note} adicionalmente marca la brecha de reconciliación del latch actual como resuelta y estampa una anotación de operador sobre ella. acknowledge por defecto es false, dejando la brecha OPEN para que permanezca visible para revisión. Un poller sano y not-latched devuelve 200 con resumed: false y reason: "not_latched" — la llamada es un no-op idempotente seguro. Los reintentos con la misma key reproducen la respuesta cacheada.
La ruta es independiente de la organización y no requiere el header X-Organization-Id — el tenant se resuelve desde el contexto autenticado. En despliegues multi-tenant, un tenant inactivo se rechaza con 503.
Autorizaciones
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
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.
255Cuerpo
Opciones opcionales de reanudación. Un cuerpo vacío re-arma el poller y deja la brecha de reconciliación abierta.
Cuerpo opcional para una reanudación del poller de TED IN. Todos los campos son opcionales; un cuerpo vacío re-arma el poller y deja la brecha de reconciliación abierta.
Cuando es true, marca la brecha de reconciliación del latch actual como resuelta después de que el poller sea re-armado. Por defecto es false para que la brecha permanezca OPEN y siga visible para revisión.
false
Anotación de operador estampada sobre la brecha resuelta cuando acknowledge es true. Ignorada en caso contrario.
500"verified against the JD cabine; no inbound message lost"
Respuesta
Indica que el intento de reanudación se completó. resumed es true cuando un poller latched o muerto fue re-armado y false para el no-op saludable. gapResolved es true solo cuando se solicitó acknowledge Y la fila de brecha fue marcada correctamente como resuelta. reason es el estado desde el que se reanudó (receive_state_unknown, panic, auth_failure) o not_latched para el no-op.
true cuando un poller latched o muerto fue re-armado; false para el no-op saludable.
true
true solo cuando se solicitó acknowledge Y la fila de brecha fue marcada correctamente como resuelta.
false
El estado del poller desde el que se reanudó. not_latched indica el no-op idempotente.
receive_state_unknown, panic, auth_failure, not_latched "receive_state_unknown"
Identificador del tenant resuelto. Omitido en despliegues de un solo tenant.
"11111111-1111-1111-1111-111111111111"