Digite para filtrar os verbetes do Glossário.

    Desenvolvimento web · Vibe Coding: Do Zero ao MVP

    O que é Vary?

    O cabeçalho Vary indica quais campos da requisição distinguem as versões de uma resposta HTTP no cache, como o idioma ou a compressão aceita pelo cliente.

    Também chamado de: cabeçalho Vary

    StayCloudVPS Agêntica

    Uma VPS para os seus agentes trabalharem dia e noite

    Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

    Montar minha VPS Agêntica

    Link de parceiro da Promovaweb.

    Black Friday até 30/11

    30%off

    nos 2 primeiros meses do plano mensal da VPS

    • Backup diário grátis para sempre
    • Servidores em São Paulo no datacenter da Ascenty
    • Datacenter Tier III manutenção sem parada
    • Acesso root com disco SSD NVMe
    • Réplica do backup em Ashburn, nos EUA

    Como o cache distingue versões da mesma URL

    O Vary é um cabeçalho de resposta HTTP que informa quais campos da requisição influenciaram a escolha do conteúdo enviado. Um servidor pode usar a mesma URL para responder com idiomas ou codificações diferentes. O cache usa a indicação de Vary para conferir se uma versão armazenada corresponde à nova requisição.

    A comparação considera os cabeçalhos indicados e admite as normalizações permitidas para cada campo. Segundo a RFC 9111, uma resposta armazenada com Vary só pode ser reutilizada sem revalidação quando esses campos correspondem aos da requisição original. As demais condições de reutilização do cache também precisam ser atendidas.

    Uma página comprimida com gzip

    Neste exemplo, um cliente envia Accept-Encoding: gzip ao consultar uma página. O servidor escolhe a versão comprimida e inclui na resposta:

    Content-Encoding: gzip
    Vary: Accept-Encoding

    O primeiro cabeçalho descreve a codificação do conteúdo enviado. O segundo orienta o cache a considerar o campo Accept-Encoding ao selecionar essa resposta. Uma nova consulta com Accept-Encoding: identity solicita conteúdo sem compressão, portanto a versão gzip armazenada não pode ser reutilizada diretamente para atendê-la.

    Você pode comparar os cabeçalhos das requisições e das respostas para investigar uma variante incorreta. Incluir Vary na resposta não faz o servidor produzir as versões: a aplicação ou o servidor precisa selecionar e gerar o conteúdo adequado.

    Seleção da variante e validade

    O Vary não estabelece o tempo de armazenamento. Cabeçalhos como Cache-Control definem outras condições de uso, incluindo a validade da resposta. Liste em Vary os campos que realmente influenciam a seleção, pois campos desnecessários podem separar respostas equivalentes e reduzir a reutilização do cache.

    Dúvidas frequentes

    Perguntas frequentes sobre Vary

    Vary define o prazo de validade do cache?
    O prazo é determinado por outras informações, como a diretiva max-age de Cache-Control. Vary identifica os campos da requisição usados para selecionar uma variante armazenada.
    O que significa Vary com asterisco?
    Vary: * indica que a seleção depende de algo além dos campos nomeados da requisição. Uma resposta armazenada com essa indicação exige revalidação para ser reutilizada.
    É possível indicar vários cabeçalhos?
    Sim. Vary aceita uma lista separada por vírgulas, como Accept-Encoding, Accept-Language. Ela deve corresponder aos campos que influenciaram a seleção da resposta.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    Ao revisar uma aplicação web, você precisa conferir se o cache reutiliza a versão da resposta adequada aos cabeçalhos enviados pelo cliente.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano