Pular para o conteúdo principal

Reprocessamento de Consultas

Quando uma consulta termina como parcial, alguma fonte de dados estava indisponível. Nesse caso, você pode pedir o reprocessamento das fontes que falharam.

Quando Usar​

O reprocessamento vale para consultas com status parcial. O campo servicesBroken mostra quais fontes falharam.

Status da consultaPode reprocessar?
parcial✅
sucesso❌ (409)
reprocessando❌ (409)
falha❌ (409). O valor já foi estornado; crie uma nova consulta com "duplicity": true
Regras
  • Sem cobrança adicional.
  • Até 2 reprocessamentos por consulta. A partir daí, a API responde 400 Máximo de tentativas excedido!.

Endpoint​

POST /queries/integration/:queryId/reprocess

Parâmetros​

ParâmetroTipoObrigatórioDescrição
queryIdpath✅ID da consulta a ser reprocessada

Headers​

HeaderObrigatórioDescrição
x-api-key✅Sua chave de API

Exemplo​

curl -X POST "https://hwfxu4zs36.execute-api.sa-east-1.amazonaws.com/queries/integration/550e8400-e29b-41d4-a716-446655440000/reprocess" \
-H "x-api-key: sua_api_key"

Resposta​

{
"statusCode": 201
}

Verificando o Resultado​

O status passa para reprocessando. Ao terminar, a Checktudo envia ao seu webhook o evento QUERY_REPROCESSED, com o resultado atualizado. Se a notificação não chegar, consulte:

curl -X GET "https://hwfxu4zs36.execute-api.sa-east-1.amazonaws.com/queries/integration/550e8400-e29b-41d4-a716-446655440000" \
-H "x-api-key: sua_api_key"

Status Possíveis Após Reprocessamento​

StatusDescrição
reprocessandoReprocessamento em andamento
sucessoTodos os dados foram obtidos
parcialAlguns dados ainda não puderam ser obtidos

Exemplo de Integração​

async function reprocessarSeNecessario(queryId: string): Promise<void> {
const { data: resultado } = await client.getQueryResult(queryId);

if (resultado.status === 'parcial') {
console.log('Fontes com falha:', resultado.servicesBroken);
await client.reprocessQuery(queryId);
console.log('Reprocessamento solicitado');
}
}

Próximos Passos​