4104xx · Erro do cliente
HTTP 410 Gone
O 410 Gone afirma que o recurso existia e foi removido de propósito, sem previsão de retorno.
O que significa
Existia e foi removido de propósito, sem previsão de voltar. A requisição tem algum problema — quem chamou precisa corrigir.
Quando usar
Melhor que 404 quando você quer que buscadores removam a página.
Especificação: RFC 9110
Causas comuns
- Conteúdo descontinuado e retirado do ar deliberadamente
- Endpoint de API removido após período de descontinuação
- Página de campanha encerrada
Como resolver
- Use 410 no lugar de 404 quando quiser que buscadores removam a URL mais rápido
- Se existe um substituto, prefira um 301 apontando para ele
- Documente a remoção para quem consome a API
Exemplo de resposta
HTTP/1.1 410 Gone
Content-Type: application/json
{"erro": "endpoint_removido", "substituto": "/api/v2/pedidos"}