- responde em milissegundos e nunca vira um trabalho assíncrono,
- continua respondendo quando a fonte está fora do ar ou em manutenção,
- busca sobre tudo o que a fonte publicou, não um registro por chamada,
- consome 1 crédito por solicitação em vez dos 10 de uma ao vivo (consulte Créditos).
as_of
Cada resposta servida a partir de um dataset traz as_of: os dados estão em
dia até esse momento.
Lookups
Um terceiro modo de resposta fica entre os dois. Um endpoint de lookup lê um registro pela sua chave. Na primeira vez que uma chave é pedida, a Croma lê a fonte e guarda a resposta; cada chamada dentro da janela de frescor do endpoint responde a partir dessa cópia em milissegundos e não gasta nada na fonte; passada a janela, a fonte é lida de novo. A Croma também relê as respostas guardadas num calendário, para que um valor que a fonte muda por conta própria seja atualizado. Cada resposta de lookup diz quando a fonte foi consultada pela última vez e de onde veio a resposta:served_from é copy (respondido a partir da cópia da Croma), upstream (a
fonte foi lida para esta chamada) ou stale (a fonte não pôde ser lida e a
resposta guardada ficou no lugar, com um aviso). Uma chave sob a qual a fonte
não tem nada retorna found: false e é pedida à fonte de novo na próxima vez.
Os endpoints de lookup levam o selo Lookup no seu guia e served_from: "lookup" no catálogo, e são medidos como solicitações ao vivo.
Quais endpoints são servidos por datasets?
O selo Dataset em cada guia e
served_from no
/catalog estão sempre em dia.
Consultas ao vivo
O outro modo de resposta: a própria fonte, consultada no momento da solicitação.