Reprocessamento de Consultas
Caso uma consulta tenha falhado parcialmente, você pode solicitar o reprocessamento. Este recurso é útil quando alguma fonte de dados estava temporariamente indisponível durante a consulta original.
Quando Usar
O reprocessamento é recomendado quando:
- A consulta retornou status
parcial - A consulta retornou status
falha - O campo
servicesBrokencontém serviços que falharam
informação
O reprocessamento não gera cobrança adicional se realizado dentro de 24 horas da consulta original.
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://pwe6qnayhg.execute-api.sa-east-1.amazonaws.com/queries/integration/550e8400-e29b-41d4-a716-446655440000/reprocess" \
-H "x-api-key: sua_api_key"
Resposta
HTTP/1.1 204 No Content
Verificando o Resultado
Após solicitar o reprocessamento, consulte novamente o resultado para verificar se os dados foram atualizados:
curl -X GET "https://pwe6qnayhg.execute-api.sa-east-1.amazonaws.com/queries/integration/550e8400-e29b-41d4-a716-446655440000" \
-H "x-api-key: sua_api_key"
O status da consulta mudará para reprocessando enquanto estiver em andamento e depois para sucesso ou parcial dependendo do resultado.
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 |
falha | Reprocessamento falhou completamente |
Exemplo de Integração
async function reprocessarSeNecessario(queryId: string): Promise<void> {
const resultado = await client.getQueryResult(queryId);
if (resultado.status === 'parcial' || resultado.status === 'falha') {
console.log('Serviços com falha:', resultado.servicesBroken);
await client.reprocessQuery(queryId);
console.log('Reprocessamento solicitado');
}
}