Compreendendo os códigos de estado HTTP: Guia completa

Cada vez que tua navegador se comunica com um servidor web, o servidor devolve um código de estado HTTP. Estes números de três dígitos le dizem a tua navegador se a requisição fue bem-sucedida, fue redirigida o encontró um error. Compreender estes códigos de estado é crucial para desenvolvedores web, profissionais de SEO e qualquer pessoa que gestione um site web.

Como se organizan os códigos de estado HTTP

Os códigos de estado HTTP se agrupan em cinco categorías segundo o primer dígito. Cada categoria representa uma clase de respuesta que te ajuda a identificar rápidamente a naturaleza da resposta do servidor.

Categoria	Clasificação	Significado
1xx	Informativo	Requisição recebida, continuando processamento
2xx	Sucesso	Requisição recebida e processada com sucesso
3xx	Redirecção	Se necessita acção adicional para completar a requisição
4xx	Error do cliente	A requisição contém sintaxe incorrecta o no pode ser satisfecha
5xx	Error do servidor	O servidor no pudo completar uma requisição válida

1xx Respuestas informativas

Estes códigos de estado indican que o servidor ha recebido a requisição e está continuando com o processamento. Raramente se veem na navegação diaria mas são importantes para a negociação de protocolos.

100 Continue: O servidor ha recebido as cabeceras da requisição e o cliente deve continuar enviando o corpo da requisição.
101 Switching Protocols: O servidor está mudando de protocolo segundo lo solicitado por o cliente através de a cabecera Upgrade.
103 Early Hints: Se usa para precargar recursos antes de que a respuesta final esté lista, mejorando o performance de carga da página.

2xx Respuestas bem-sucedidas

Estes códigos de estado confirman que a requisição fue recebida, compreendida e processada com sucesso.

200 OK: A respuesta de sucesso estándar. O recurso solicitado fue encontrado e devolvido.
201 Created: Um novo recurso fue criado com sucesso, típicamente em respuesta a uma requisição POST.
204 No Content: A requisição tuvo sucesso mas no há conteúdo que devolver. Comum em requisições DELETE.
206 Partial Content: O servidor entrega solo uma parte do recurso, usado para descargas de arquivos grandes e streaming de video.

3xx Respuestas de redirecção

Os códigos de estado de redirecção indican ao cliente que o recurso solicitado está disponivel em uma ubicação diferente. São cruciales para o SEO porque afectan como os motores de búsqueda indexan tuas páginas.

301 Moved Permanently: O recurso se ha movido permanentemente a uma nova URL. Os motores de búsqueda transfieren a autoridade de links a a nova URL. Esta é a redirecção mais importante para o SEO.
302 Found: O recurso se encontra temporalmente em uma URL diferente. Os motores de búsqueda generalmente conservan a indexação da URL original. Úsalo solo para migraciones temporales.
304 Not Modified: Indica que a versão em caché do recurso segue sendo válida. Isto ahorra largo de banda evitando transferencias de datos desnecessárias.
307 Temporary Redirect: Similar a 302 mas garantiza que o método HTTP no cambiará. Mais confiável que 302 para implementações técnicas.
308 Permanent Redirect: Similar a 301 mas garantiza que o método HTTP no cambiará. Uma alternativa moderna a 301 para redirecciones permanentes.

Requisição bem-sucedida (GET, HEAD)

4xx Erros do cliente

Estes códigos de estado indican que o cliente cometió um error na requisição. São os erros mais comumente encontrados por os visitantes do site web.

400 Bad Request: O servidor no pode processar a requisição devido a um error de formato de sintaxe. Verifica os parámetros de tua requisição e as cabeceras.
401 Unauthorized: Se requer autenticação e no se proporcionó o falló a verificação. O usuario necessita iniciar sesão.
403 Forbidden: O servidor entende a requisição mas se niega a autorizarla. A diferença de 401, a autenticação no ayudaria.
404 Not Found: O recurso solicitado no existe no servidor. É o código de error mais comum e pode ter um impacto significativo no SEO se no se maneja correctamente.
405 Method Not Allowed: O método de requisição (GET, POST, PUT, etc.) no está soportado por o recurso solicitado.
429 Too Many Requests: O usuario ha enviado demasiadas requisições em um período de tiempo determinado. É limitação de velocidade, comum em APIs.

5xx Erros do servidor

Estes códigos de estado indican que o servidor no pudo completar uma requisição válida. Representam problemas do lado do servidor que requerem atenção imediata.

500 Internal Server Error: Mensaje de error genérico quando o servidor encontra uma condição inesperada. Revisa os registros do servidor para encontrar a causa raíz.
502 Bad Gateway: O servidor, actuando como puerta de link, recibió uma respuesta inválida de um servidor ascendente. Comum em proxies inversos e CDN.
503 Service Unavailavel: O servidor no pode manejar temporalmente a requisição, generalmente devido a manutenção o sobrecarga. Usa o cabeçalho Retry-After para indicar quando reintentar.
504 Gateway Timeout: O servidor, actuando como puerta de link, no recibió uma respuesta oportuna do servidor ascendente.

Como depurar códigos de estado HTTP

Ao solucionar erros HTTP, segue este abordagem sistemático:

Verifica o código de estado: Determina se é um error do cliente (4xx) o do servidor (5xx).
Revisa os registros do servidor: Para erros 5xx, os registros do servidor contêm seguimientos de pila e detalhes do error.
Inspecciona as cabeceras da requisição: Usa as ferramentas de desenvolvedor do navegador para verificar que a requisição contenga as cabeceras, cookies e tokens de autenticação corretos.
Experimenta com curl: Reproduce a requisição usando curl para aislar se o problema está no lado do cliente o do servidor.
Verifica os cambios recientes: Despliegues, actualizaciones de configuração o cambios de DNS frequentemente causan erros de código de estado.

Queres buscar rápidamente qualquer código de estado HTTP? Experimenta nossa ferramenta gratuita de referencia de códigos de estado HTTP.

Perguntas frequentes

Quais são os códigos de estado HTTP mais comuns?

O código de estado HTTP mais comum é 200 OK, que indica uma requisição bem-sucedida. Outros códigos comumente encontrados incluem 301 Moved Permanently, 404 Not Found e 500 Internal Server Error.

Qual é a diferença entre redirecção 301 e 302?

Uma redirecção 301 é permanente, indicando a os motores de búsqueda que transfieran a autoridade de links a a nova URL. Uma redirecção 302 é temporal, indicando a os motores de búsqueda que mantengan a URL original indexada. Usa 301 para movimientos permanentes e 302 para cambios temporales.

Como solucionar o error 403 Forbidden?

Um error 403 significa que o servidor entende a requisição mas rechaza a autorização. Verifica os permissões de arquivos, valida as credenciales de autenticação, asegura que o usuario tenga acesso e verifica restricciones de IP o complementos de segurança que bloqueen.

Que significa o código de estado 429?

O código de estado 429 Too Many Requests significa que has enviado demasiadas requisições em um período de tiempo determinado. Isto é limitação de taxa. A respuesta típicamente inclui um cabeçalho Retry-After que indica quanto tiempo esperar antes de volver a solicitar.

Um error 500 é mi problema o do servidor?

500 Internal Server Error é um problema do lado do servidor no causado por a requisição do cliente. Típicamente indica um error no código do servidor, uma mala configuração o problemas de agotamiento de recursos. No entanto, se tua requisição desencadenó o error do servidor, modificar a requisição pode evitarlo.