Web & Autenticação

Referência de códigos de status HTTP — Guia completo

Referência online e gratuita de códigos de status HTTP. Pesquise e consulte todos os códigos de status de resposta HTTP, com descrições, categorias e casos de uso comuns.

Uso gratuito Sem cadastro Funciona no navegador

1xx Informational

100

Continue

The server has received the request headers and the client should proceed.

101

Switching Protocols

The server is switching protocols as requested (e.g., WebSocket upgrade).

2xx Success

200

The request succeeded. Standard response for successful HTTP requests.

201

Created

The request succeeded and a new resource was created. Common after POST requests.

204

No Content

The request succeeded but there is no content to return. Common for DELETE.

206

Partial Content

The server is delivering only part of the resource due to a range header.

3xx Redirection

301

Moved Permanently

The resource has been permanently moved to a new URL. Use for SEO redirects.

302

Found

The resource is temporarily at a different URL. Often used in OAuth redirects.

304

Not Modified

The resource has not been modified since the last request. Use cached version.

307

Temporary Redirect

Like 302 but preserves the HTTP method. Used in HSTS redirects.

308

Permanent Redirect

Like 301 but preserves the HTTP method.

4xx Client Error

400

Bad Request

The server cannot process the request due to invalid syntax or parameters.

401

Unauthorized

Authentication is required. The client must provide valid credentials.

403

Forbidden

The client does not have permission to access the resource, even with auth.

404

Not Found

The requested resource does not exist on the server.

405

Method Not Allowed

The HTTP method is not supported for the requested resource.

409

Conflict

The request conflicts with the current state of the resource.

410

Gone

The resource is permanently gone and will not be available again.

413

Payload Too Large

The request body exceeds the server limit.

415

Unsupported Media Type

The media type in the request is not supported by the server.

422

Unprocessable Entity

The request is well-formed but contains semantic errors (used in APIs).

429

Too Many Requests

The user has sent too many requests in a given time. Rate limiting.

5xx Server Error

500

Internal Server Error

Generic server error. Something unexpected went wrong.

502

Bad Gateway

The server received an invalid response from an upstream server.

503

Service Unavailable

The server is temporarily unable to handle the request (maintenance/overload).

504

Gateway Timeout

The upstream server did not respond in time.

O que são códigos de status HTTP?

Os códigos de status HTTP são números de três dígitos retornados por um servidor web em resposta à solicitação de um cliente. Eles indicam se a solicitação foi bem-sucedida, redirecionada, resultou em erro do cliente ou causou um erro no servidor. Os códigos são agrupados em cinco categorias: 1xx (informação), 2xx (sucesso), 3xx (redirecionamento), 4xx (erro do cliente) e 5xx (erro do servidor). Entender esses códigos é essencial para desenvolvedores web, designers de APIs e administradores de sistemas que precisam criar, depurar e monitorar aplicações e serviços web.

Como usar a referência de códigos de status HTTP

1Consulte a lista completa de códigos de status HTTP, organizada por categoria (de 1xx a 5xx).
2Use o campo de pesquisa para filtrar códigos por número, nome ou descrição — por exemplo, digite “404” ou “redirect”.
3Cada código de status apresenta seu valor numérico, nome oficial e uma descrição concisa de quando e como ele é usado.
4As categorias identificadas por cores facilitam a distinção entre sucesso (verde), redirecionamento (amarelo), erros do cliente (laranja) e erros do servidor (vermelho).
5Use esta referência ao depurar respostas de APIs, configurar servidores web ou implementar a lógica de tratamento de erros.

Casos de uso comuns

Desenvolvimento de APIs

Escolha os códigos de status corretos ao projetar respostas de APIs REST — saber quando usar 201 em vez de 200, ou 400 em vez de 422, resulta em APIs melhores.

Depuração de erros HTTP

Quando uma API retornar um código de status inesperado, consulte rapidamente seu significado para entender se o problema está no cliente ou no servidor.

SEO e redirecionamentos

Entenda a diferença entre os redirecionamentos 301 (permanente) e 302 (temporário) e seus impactos na otimização para mecanismos de busca.

Criação de páginas de erro

Consulte os códigos corretos ao implementar páginas personalizadas para erros 404, 403, 500 e outros cenários comuns.

Perguntas frequentes

What problem does Referência de códigos de status HTTP — Guia completo solve?