Construtor de Cabeçalho HTTP Cache-Control

O que é o HTTP Cache-Control Header Builder?

Cache-Control é o cabeçalho de resposta HTTP que diz aos navegadores, CDNs e proxies se uma resposta pode ser armazenada em cache, por quanto tempo e como deve ser revalidada após se tornar obsoleta. É também um dos cabeçalhos mais fáceis de errar: no-cache não significa "não cache," no-store silenciosamente substitui quase tudo o mais que você define junto com ele, e s-maxage só importa para caches compartilhados enquanto max-age importa para ambos. Esta ferramenta monta um cabeçalho correto a partir de diretivas individuais (ou uma predefinição curada) e explica, em linguagem clara, exatamente o que cada diretiva ativa faz — além de sinalizar combinações que contradizem ou parcialmente cancelam uma à outra.

Como usar

1. Escolha uma Context Preset para um cenário comum — resposta de API, ativo estático, página HTML ou dados privados — ou deixe em Custom para alternar as diretivas você mesmo.
2. No modo Custom, marque as diretivas Cacheability que se aplicam (public, private, no-cache, no-store), defina tempos de vida Freshness em segundos (max-age, s-maxage, stale-while-revalidate, stale-if-error), e ative quaisquer diretivas de Revalidation necessárias (must-revalidate, proxy-revalidate, immutable, no-transform, must-understand).
3. A caixa Cache-Control Header é atualizada automaticamente — copie direto para sua configuração de resposta do servidor, regra de CDN ou código de aplicação.
4. Leia What Each Directive Does para uma explicação em linguagem clara de cada diretiva que você habilitou, e verifique Warnings por qualquer coisa que contradiga ou silenciosamente cancele outra diretiva que você definiu.

Escolhendo uma predefinição

• API response — no-store. Dados dinâmicos por solicitação que nunca devem ser armazenados em cache por ninguém.
• Static asset — public, max-age=31536000, immutable. Para arquivos com nome de arquivo com hash ou versão (app.a1b2c3.js) — a própria URL muda quando o conteúdo muda, portanto é seguro fazer cache por um ano e pular a revalidação inteiramente.
• HTML page — no-cache. A URL permanece a mesma, mas o conteúdo pode mudar, então os caches podem armazená-la, mas devem verificar com a origem antes de servir novamente.
• Private data — private, max-age=0, must-revalidate. Páginas de conta, carrinhos ou qualquer coisa específica do usuário: armazenável apenas pelo navegador e sempre revalidada.

FAQ

Qual é a diferença entre no-cache e no-store?

no-cache permite que um cache armazene a resposta, mas força-o a revalidar com o servidor de origem antes de servir novamente — é uma diretiva "verifique primeiro," não uma "não cache." no-store é a versão rigorosa: nenhum cache pode armazenar a resposta. Misturar no-store com diretivas como max-age ou must-revalidate não é inválido, mas essas diretivas se tornam sem sentido — no-store já evita qualquer armazenamento para elas se aplicarem.

Qual é a diferença entre max-age e s-maxage?

max-age define o tempo de vida do freshness para cada cache — o navegador e qualquer cache compartilhado (CDN, proxy) no meio. s-maxage substitui esse tempo de vida apenas para caches compartilhados, permitindo que você armazene uma resposta mais longo (ou mais curto) no CDN do que no próprio navegador do visitante. s-maxage em uma resposta private não tem efeito, pois caches compartilhados não são autorizados a armazenar respostas privadas em primeiro lugar.

immutable significa que a resposta nunca é revalidada?

Apenas dentro de sua janela de freshness. immutable diz ao navegador que pode pular solicitações de revalidação condicional inteiramente — incluindo em um recarregamento acionado pelo usuário — enquanto max-age (ou s-maxage) diz que a resposta está fresca. Uma vez que essa janela termina, as regras normais de revalidação se aplicam novamente. Definir immutable sem max-age/s-maxage não lhe dá janela de freshness para se aplicar.

Cache-Control é o único cabeçalho de cache que preciso?

É o principal para controlar freshness e armazenamento, mas validadores como ETag e Last-Modified ainda importam para solicitações de revalidação — são o que um cache envia de volta para a origem para perguntar "isso mudou?" uma vez que max-age expira. Para converter uma duração em um valor max-age= pronto para usar sem aritmética de segundos, use o Cache TTL Calculator. Para o fluxo de trabalho equivalente de construção de cabeçalho em solicitações entre origens, veja o CORS Headers Builder.

Privacidade

Esta ferramenta funciona inteiramente em seu navegador. As diretivas e valores que você define nunca são enviados para ou armazenados em nossos servidores.