Grupo
As rotas funcionam em conjunto e devem ser usadas nesta ordem:
Se sua integração pular a etapa de solicitação, a rota de resumo pode retornar ausência de conteúdo, porque o resumo ainda não existe no momento da leitura.
Links diretos dos 3 endpoints na documentação:
POSTGETGETA geração de resumo depende de processamento interno e pode levar tempo variável conforme disponibilidade de dados e fila de processamento. Por isso:
POST de solicitação não significa resumo pronto imediato.GET de status é a forma canônica de saber quando concluir.GET do resumo deve ser feito somente após status final de conclusão.Se você também quiser garantir dados mais recentes do processo antes do resumo, consulte a etapa de atualização em: Solicitar atualização de um processo.
Dispare a rota de solicitação e registre, no seu sistema, o processo/solicitação iniciada para acompanhamento.
Boas práticas:
Depois de solicitar, consulte periodicamente o status da solicitação.
Estratégia recomendada:
Estados esperados (conceitualmente):
Quando o status indicar conclusão, consuma a rota de resumo inteligente.
Se ainda não houver conteúdo, trate como condição transitória e faça nova leitura curta com limite de tentativas, pois pode existir pequeno atraso de consistência entre finalização e disponibilização.
async function obterResumoInteligente(numeroCnj, token) {
await solicitarResumo(numeroCnj, token); // POST
const maxTentativas = 12;
let esperaMs = 5000;
for (let tentativa = 1; tentativa <= maxTentativas; tentativa++) {
const status = await consultarStatusResumo(numeroCnj, token); // GET status
if (status === "CONCLUIDO") {
return await buscarResumo(numeroCnj, token); // GET resumo
}
if (status === "FALHA") {
throw new Error("Falha na geração do resumo inteligente");
}
await new Promise((r) => setTimeout(r, esperaMs));
esperaMs = Math.min(esperaMs + 3000, 30000);
}
throw new Error("Timeout ao aguardar conclusão do resumo inteligente");
}
Para evitar percepção de falha, mostre estados claros na interface:
Também é recomendado exibir a hora da última atualização do resumo quando disponível.
POST de solicitação como etapa obrigatória.GET de status com backoff.GET de resumo somente após conclusão.