O recurso existiu, mas foi removido para sempre.
Quando usar
Conteúdo excluído ou versões de API desativadas. Mais forte que 404.
Causas comuns e soluções
Use 410 quando uma página ou endpoint foi removido de propósito e não vai voltar. O Google trata 404 e 410 quase da mesma forma, embora o 410 possa fazer uma URL sair do índice um pouco mais rápido. Ele serve para anúncios expirados, conteúdo excluído por usuários e versões de API aposentadas, em que o corpo pode indicar a versão substituta e a data em que a antiga foi desativada.
Caches podem armazenar um 410 por padrão, já que ele é cacheável heuristicamente como o 404 e o 301, então não o envie para conteúdo que pode voltar; nesse caso, use 404 ou 503. Se existir uma página equivalente, um 301 atende melhor os usuários e mantém os sinais de ranqueamento. No nginx, escreva return 410 em um bloco location; no Apache, Redirect gone /old-path. Remova as URLs do seu sitemap.
Erro do cliente (4xx)
Os códigos 4xx são erros do cliente: a própria requisição está errada, não está autorizada ou aponta para algo que não existe. Repetir a mesma requisição não vai adiantar.
Como fica
HTTP/1.1 410 GoneComo enviar
| Node.js / Express | res.status(410).end() |
|---|---|
| Python / Flask | return '', 410 |
| nginx | return 410; |
Como verificar
curl -s -o /dev/null -w "%{http_code}\n" https://example.com/