Guardar as respostas do jeito certo
Cada resposta diz por quanto tempo pode ser guardada. Respeitar esse tempo deixa o seu sistema mais rápido e longe do limite.
Publicado em .
Fontes oficiais: o CNPJ na Receita Federal e os dados abertos do CNPJ.
A base da Receita não muda a cada minuto. Por isso a API diz no cabeçalho cache-control quanto tempo cada resposta vale. Guardar por esse tempo é o que mais reduz consultas.
O que a API manda
| Resposta | Cabeçalho | Guarde por |
|---|---|---|
| 200, a ficha | public, max-age=86400 | 24 horas |
404 nao_encontrado | public, max-age=3600 | 1 hora |
Com x-api-key | private, no-store | não guarde |
O código
export function criarCache() {
const guardado = new Map();
return async function fichaComCache(cnpj) {
const chave = limparCnpj(cnpj), agora = Date.now(), item = guardado.get(chave);
if (item && item.vence > agora) return { ...item.valor, do_cache: true };
const r = await fetch(`https://cnpj.wortic.com/cnpj/${chave}`);
const idade = Number((r.headers.get("cache-control") || "").match(/max-age=(\d+)/)?.[1] || 0);
const valor = { status: r.status, corpo: await r.json() };
if (r.status === 200 || r.status === 404) guardado.set(chave, { valor, vence: agora + idade * 1000 });
return { ...valor, do_cache: false };
};
}
const ficha = criarCache();
await ficha("37853407000171"); // vai à API
await ficha("37.853.407/0001-71"); // vem do cache: mesmo CNPJ, outra escrita
A chave do cache é o CNPJ limpo. Assim, o mesmo número escrito com ou sem pontuação vira uma consulta só. A função lê o tempo do próprio cabeçalho, então segue certa se a API mudar o prazo. Com no-store a idade é zero e nada fica guardado.
Para guardar muitas fichas e buscar nelas depois, sem subir um banco, veja o guia sobre jsonW.
Perguntas e respostas
Por quanto tempo posso guardar a ficha de uma empresa?
A resposta 200 vem com cache-control: public, max-age=86400, ou seja, 24 horas.
E a resposta de CNPJ não encontrado?
A resposta 404 vem com max-age=3600: guarde por 1 hora, porque a base pode receber o CNPJ na próxima carga.
Com chave de API as respostas também podem ser guardadas?
Não. Com x-api-key a resposta vem com cache-control: private, no-store, porque cada consulta é contada no seu plano.
Todos os guias · Documentação com exemplos em 10 linguagens · openapi.json · Versão para IA