Consultas en vivo

La mayoría de los endpoints consultan la fuente cuando llamas: estas son las consultas en vivo. La respuesta viene de la fuente en ese momento, en la misma forma JSON que cualquier otro endpoint. El resto son endpoints de dataset, y cualquier endpoint sin la insignia Dataset en su guía es en vivo. Una consulta en vivo:

• devuelve lo que la fuente dice ahora mismo, no al corte de un refresco,
• resuelve un sujeto por llamada (una cédula, una placa, un radicado),
• consume 10 créditos por solicitud (consulta Límites de tasa).

​

Latencia

La mayoría de las consultas en vivo responden en unos pocos segundos, al ritmo de su fuente. Las más lentas corren como trabajos asíncronos: espera en línea, haz polling o recibe un callback; esa página lista qué endpoints son. Una consulta idéntica repetida puede responder desde un resultado reciente en caché (X-Cache: HIT). Las respuestas en caché consumen los mismos créditos.

​

Disponibilidad

Una consulta en vivo está tan disponible como su fuente. Cuando la fuente falla o no responde, el endpoint devuelve un 5xx con type: "upstream_error" (consulta Errores). Las consultas son idempotentes, así que reintentar siempre es seguro.