Skip to main content
Algunos endpoints no consultan la fuente cuando llamas. Responden desde una copia completa de ella que Croma mantiene al día y organizada para consultar: estos son los endpoints de dataset. El resto son consultas en vivo. Un endpoint de dataset:
  • responde en milisegundos y nunca se convierte en un trabajo asíncrono,
  • sigue respondiendo cuando la fuente está caída o en mantenimiento,
  • busca sobre todo lo que la fuente ha publicado, no un registro por llamada,
  • consume 1 crédito por solicitud en lugar de los 10 de una en vivo (consulta Créditos).

as_of

Cada respuesta servida desde un dataset incluye as_of: los datos están al día hasta ese momento.
Cada dataset se refresca con su propio calendario. Si necesitas la respuesta de la fuente en este segundo, usa un endpoint en vivo donde exista uno.

Lookups

Un tercer modo de respuesta está entre los dos. Un endpoint de lookup lee un registro por su llave. La primera vez que se pregunta por una llave, Croma lee la fuente y guarda la respuesta; cada llamada dentro de la ventana de frescura del endpoint responde desde esa copia en milisegundos y no gasta nada en la fuente; pasada la ventana, se vuelve a leer la fuente. Croma también relee las respuestas guardadas con un calendario, así que un valor que la fuente cambia por su cuenta se pone al día. Cada respuesta de lookup dice cuándo se consultó la fuente por última vez y de dónde salió la respuesta:
served_from es copy (respondido desde la copia de Croma), upstream (la fuente se leyó para esta llamada) o stale (la fuente no se pudo leer y la respuesta guardada la reemplazó, con una advertencia). Una llave bajo la cual la fuente no tiene nada devuelve found: false y se vuelve a preguntar a la fuente la próxima vez. Los endpoints de lookup llevan la insignia Lookup en su guía y served_from: "lookup" en el catálogo, y se miden como solicitudes en vivo.

¿Qué endpoints se sirven desde datasets?

La insignia Dataset en cada guía y served_from en el /catalog siempre están al día.

Consultas en vivo

El otro modo de respuesta: la fuente misma, consultada al momento de la solicitud.