Retomar o Poller de TED IN
Use este endpoint para liberar a trava de recebimento fail-closed at-most-once e rearmar um poller de TED IN travado ou morto sem reiniciar o pod. Este é um endpoint de operador de privilégio mais elevado que /ted-in/poll, pois ele reabre o consumo destrutivo de leitura do JD. Recorra a ele somente quando a auto-recuperação não conseguir reviver o poller — um filho multi-tenant em pânico ou um poller single-tenant além do limite rígido de pânico.
A retomada nunca ignora o portão durável de lacunas do caminho do dinheiro. Quando a trava live receive-state-unknown está ativa, a linha da lacuna de reconciliação da trava atual precisa estar durável antes de o poller retomar; caso contrário, a requisição é recusada com 409 e o poller permanece morto. Verifique a lacuna pendente com Listar Lacunas de Reconciliação de TED IN antes de chamar a retomada.
O corpo opcional {acknowledge, note} adicionalmente marca a lacuna de reconciliação da trava atual como resolvida e carimba uma anotação de operador nela. acknowledge tem valor padrão false, deixando a lacuna ABERTA para permanecer visível para revisão. Um poller saudável e não travado retorna 200 com resumed: false e reason: "not_latched" — a chamada é um no-op idempotente e seguro. Retentativas com a mesma chave replicam a resposta em cache.
A rota é independente de organização e não requer o cabeçalho X-Organization-Id — o tenant é resolvido a partir do contexto autenticado. Em implantações multi-tenant, um tenant inativo é rejeitado com 503.
Autorizações
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.
Cabeçalhos
Chave de idempotência obrigatória para tentativas seguras. Use um UUID v4 ou identificador de negócio único. Se a mesma chave for enviada novamente e a solicitação original já tiver sido processada, a resposta em cache será retornada.
Consulte Tentativas e idempotência para detalhes.
255Corpo
Opções opcionais de retomada. Um corpo vazio rearma o poller e mantém a lacuna de reconciliação aberta.
Corpo opcional para uma retomada do poller de TED IN. Todos os campos são opcionais; um corpo vazio rearma o poller e mantém a lacuna de reconciliação aberta.
Quando true, marca a lacuna de reconciliação da trava atual como resolvida após o poller ser rearmado. O valor padrão é false para que a lacuna permaneça ABERTA e continue visível para revisão.
false
Anotação de operador carimbada na lacuna resolvida quando acknowledge é true. Ignorada caso contrário.
500"verified against the JD cabine; no inbound message lost"
Resposta
Indica que a tentativa de retomada foi concluída. resumed é true quando um poller travado ou morto foi rearmado e false para o no-op saudável. gapResolved é true somente quando acknowledge foi solicitado E a linha da lacuna foi marcada com sucesso como resolvida. reason é o estado do qual foi retomado (receive_state_unknown, panic, auth_failure) ou not_latched para o no-op.
true quando um poller travado ou morto foi rearmado; false para o no-op saudável.
true
true somente quando acknowledge foi solicitado E a linha da lacuna foi marcada com sucesso como resolvida.
false
O estado do poller do qual foi retomado. not_latched indica o no-op idempotente.
receive_state_unknown, panic, auth_failure, not_latched "receive_state_unknown"
Identificador do tenant resolvido. Omitido em implantações single-tenant.
"11111111-1111-1111-1111-111111111111"