Limites, cache e retenção

Limites de requisição

• Por chave: padrão 60 requisições/minuto (ajustável por contrato). Cabeçalhos RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.
• Por IP: proteção adicional contra abuso.
• Excedido: 429 RATE_LIMITED com Retry-After (segundos).
• Cota mensal opcional por chave: 429 MONTHLY_QUOTA_EXCEEDED.

Ritmo das fontes

Cada fonte tem intervalo mínimo entre consultas, concorrência máxima, teto diário e circuit breaker. Quando a fonte pede pausa (Retry-After) ou falha seguidamente, a odjud reduz o ritmo — nunca tenta contornar bloqueios. Esses casos retornam FAILED com error.code (SOURCE_RATE_LIMITED, SOURCE_CIRCUIT_OPEN, SOURCE_BLOCKED…) e não são cobrados.

Tempo-limite

Uma busca tem até 180 s de execução. Consultas a tribunais podem levar dezenas de segundos.

Cache

• Por fonte e conjunto de campos (cover/full), apenas dados públicos e somente quando a política da fonte permite cache.
• TTL: 24 h (capa) e 6 h (detalhado). Resultado de cache é indicado em cacheHit.
• Processos que se tornam restritos deixam de ser entregues do cache.

Retenção

Resultados entregues ficam disponíveis para a sua conta na API e no portal. Regras de retenção e exclusão: Política de Privacidade.