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 consulta | Pode 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âmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
queryId | path | ✅ | ID da consulta a ser reprocessada |
Headers
| Header | Obrigatório | Descriçã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
| Status | Descrição |
|---|---|
reprocessando | Reprocessamento em andamento |
sucesso | Todos os dados foram obtidos |
parcial | Alguns 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');
}
}