O que é o cache?
O cache é uma camada de armazenamento temporário utilizada pela GoCache para armazenar cópias otimizadas dos conteúdos do seu site, como imagens, páginas HTML, arquivos CSS e JavaScript.
O objetivo é reduzir o tempo de carregamento para os visitantes e diminuir a carga no servidor de origem, servindo os arquivos diretamente da rede da GoCache.
O que é a limpeza de cache via API?
A GoCache permite que você remova objetos armazenados em cache de seu domínio utilizando a API. É possível remover arquivos específicos, por tipo de conteúdo ou por tags, bem como limpar o cache completo de um domínio. Isso é útil para garantir que alterações recentes no site sejam refletidas imediatamente para os visitantes.
Quando é recomendado usar a limpeza de cache via API?
Atualizou imagens, arquivos estáticos ou scripts no seu site e deseja que os visitantes recebam a versão mais recente.
Criou ou atualizou conteúdo dinâmico, como posts de blog, produtos em e-commerce ou páginas que mudam com frequência.
Deseja automatizar a limpeza de cache para determinados endpoints, evitando processos manuais.
Precisa remover objetos específicos do cache sem limpar todo o domínio, evitando impacto sobre outros conteúdos.
Como limpar arquivos específicos do cache de um domínio (limpeza avançada)
A limpeza seletiva via API permite remover apenas os arquivos desejados do cache, sem impactar todo o conteúdo do domínio. Isso é útil quando você atualiza apenas partes do site, como imagens, arquivos CSS, páginas específicas ou determinados endpoints.
Para realizar a limpeza avançada, é necessário informar um ou mais parâmetros que identifiquem os objetos a serem removidos.
A autenticação é feita por meio do cabeçalho GoCache-Token, que deve conter o token da sua conta. Caso queira saber como encontrar o seu token de API, acesse: Como achar a minha API Token?
Atenção: o token da API é pessoal e confidencial. Nunca compartilhe seu token publicamente ou o inclua em scripts que possam ser acessados por terceiros.
Parâmetros disponíveis para limpeza seletiva:
• urls[ ]
Permite informar uma ou mais URLs específicas que devem ser removidas do cache.
É possível usar wildcards (como *) para atingir múltiplos arquivos dentro de um diretório.
Limite: até 50 URLs por chamada, e no total, a limpeza não pode ultrapassar 5.000 objetos em cache por requisição.
Exemplo:
urls[1]=https://meusite.com.br/img/* → limpa todas as imagens dentro da pasta /img/
urls[2]=https://meusite.com.br/*?ver=123 → limpa todas as URLs que contenham ?ver=123
• content-type
Permite limpar objetos de acordo com o tipo de conteúdo armazenado. Essa opção é útil quando você quer, por exemplo, limpar apenas imagens, scripts ou arquivos de estilo.
Exemplo:
content-type=image/* → limpa apenas imagens
• tag[ ]
As tags são rótulos associáveis aos objetos em cache, definidas pelo cabeçalho Cache-Tags no servidor de origem. Elas permitem uma limpeza mais inteligente e direcionada, ideal para projetos com organização por seções ou categorias.
Exemplo:
tag[1]=blog → limpa apenas páginas ou objetos marcados com “blog”
tag[2]=produtos → limpa apenas conteúdo de produtos
Observação: para limpeza avançada, pelo menos um parâmetro (urls, content-type ou tag) precisa ser informado.
Exemplos de uso prático:
Limpar uma URL específica após atualização de conteúdo. Se você alterou a imagem do banner principal do seu site, pode limpar apenas essa URL:
curl -i https://api.gocache.com.br/v1/cache/minhaloja.com.br \
-X DELETE \
-H 'GoCache-Token:seu_token' \
-d 'urls[1]=https://minhaloja.com.br/img/banner-principal.jpg'
Limpar um grupo de arquivos (por tag). Se seus arquivos possuem tags de cache, como blog ou produtos, é possível limpar apenas esses conteúdos:
curl -i https://api.gocache.com.br/v1/cache/minhaloja.com.br \
-X DELETE \
-H 'GoCache-Token:seu_token' \
-d 'tag[1]=produtos'
Limpar apenas um tipo de conteúdo (por content-type). Para remover do cache apenas arquivos de imagens:
curl -i https://api.gocache.com.br/v1/cache/minhaloja.com.br \
-X DELETE \
-H 'GoCache-Token:seu_token' \
-d ‘content-type=image/*'
Como limpar todo o cache de um domínio (Limpeza Total)
A limpeza total remove todos os objetos em cache de um domínio de uma só vez. É recomendada em casos de grandes atualizações, como troca de layout, mudanças de scripts ou deploy completo do site.
Exemplo de requisição (Curl):
curl -i https://api.gocache.com.br/v1/cache/seudominio.com.br/all \
-X DELETE \
-H 'GoCache-Token:seu_token'
Diferente da limpeza avançada, nenhum parâmetro adicional é necessário. Todos os objetos em cache do domínio serão removidos automaticamente.
De forma geral, a API retorna:
Em caso de sucesso: HTTP 200 OK (limpeza total) ou HTTP 202 Accepted (limpeza avançada).
Em caso de erro: HTTP 400 Bad Request ou outros códigos de erro, com detalhes sobre URLs inválidas, não permitidas ou problemas de autenticação.
Boas práticas:
Sempre utilize URLs completas (com http ou https) e do mesmo domínio configurado na GoCache.
Use tags e content-type sempre que possível, para evitar limpezas desnecessárias.
Respeite os limites da API: até 50 URLs por chamada e 5.000 objetos em cache.
Monitore as respostas da API, elas indicam quais URLs foram aceitas, recusadas ou estavam em formato incorreto.
Caso fique com dúvidas ou tenha algum problema, entre em contato com o nosso suporte. Teremos prazer em ajudá-lo.
E-mail: suporte@gocache.com.br