Consultas ao vivo

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, 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).

​

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: 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). As consultas são idempotentes, então tentar de novo é sempre seguro.