> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultas ao vivo

> Como respondem as consultas ao vivo da Croma: direto da fonte no momento da solicitação, com a atualidade da fonte, e entrega assíncrona quando demoram.

A maioria dos endpoints consulta a fonte quando você chama: essas são as
**consultas ao vivo**. A resposta vem da fonte naquele momento, na mesma
forma JSON de qualquer outro endpoint. O resto são
[endpoints de dataset](/pt/datasets), e qualquer endpoint sem o selo
**Dataset** no seu guia é ao vivo.

Uma consulta ao vivo:

* retorna o que a fonte diz agora mesmo, não no corte de uma atualização,
* resolve um sujeito por chamada (uma cédula, uma placa, um radicado),
* consome **10 créditos** por solicitação (consulte [Limites de taxa](/pt/rate-limits)).

## Latência

A maioria das consultas ao vivo responde em alguns segundos, no ritmo da sua
fonte. As mais lentas são executadas como
[trabalhos assíncronos](/pt/async-jobs): espere de forma síncrona, faça
polling ou receba um callback; essa página lista quais endpoints são.

Uma consulta idêntica repetida pode responder a partir de um resultado recente
em cache (`X-Cache: HIT`). Respostas em cache consomem os mesmos créditos.

## Disponibilidade

Uma consulta ao vivo está tão disponível quanto a sua fonte. Quando a fonte
falha ou não responde, o endpoint retorna um `5xx` com
`type: "upstream_error"` (consulte [Erros](/pt/errors)). As consultas são
idempotentes, então tentar de novo é sempre seguro.

<Card title="Datasets" icon="database" href="/pt/datasets">
  O outro modo de resposta: a fonte inteira, consultada em milissegundos.
</Card>
