Códigos de status HTTP

Pesquise todos os códigos de status HTTP, de 1xx a 5xx, com significado e quando usar cada um

Como consultar um código de status HTTP

  1. 1

    Pesquise por código ou palavra

    Digite um número como 404, um nome como "Not Found" ou uma palavra como "redirecionamento" ou "timeout" na busca. A lista é filtrada enquanto você digita.

  2. 2

    Filtre por classe

    Clique em 1xx, 2xx, 3xx, 4xx ou 5xx para mostrar só os códigos informativos, de sucesso, de redirecionamento, de erro do cliente ou de erro do servidor.

  3. 3

    Abra um código

    Clique em um código para ler quando usá-lo, ou use Expandir todos para abrir todos os da lista atual.

  4. 4

    Copie

    Use Copiar código ou Copiar linha de status (por exemplo "404 Not Found") para colar no seu código, documentação ou relatório de bug.

As cinco classes de códigos de status HTTP

O primeiro dígito do código indica que tipo de resultado o servidor está informando. Conhecer a classe muitas vezes basta para entender uma resposta antes de ler os detalhes.

  • 1xx Informativos: a requisição foi recebida e o processo continua (100, 101, 103)
  • 2xx Sucesso: a requisição foi recebida, entendida e aceita (200, 201, 204)
  • 3xx Redirecionamento: o cliente precisa dar outro passo, normalmente ir para outra URL (301, 302, 304)
  • 4xx Erro do cliente: a requisição está errada ou não é permitida (400, 401, 403, 404, 429)
  • 5xx Erro do servidor: o servidor falhou ao atender uma requisição válida (500, 502, 503, 504)

Os códigos que você mais vai encontrar

200 OK, 201 Created e 204 No Content cobrem quase todas as chamadas bem-sucedidas de uma API. 301 e 302 tratam redirecionamentos, e 304 diz ao navegador para usar a cópia em cache. Entre os erros, 400 é requisição inválida, 401 é não autenticado, 403 é sem permissão, 404 é não encontrado e 429 é limite de requisições excedido.

Para problemas do servidor, 500 é a falha genérica, 502 e 504 costumam apontar para um proxy ou balanceador que não alcançou sua aplicação a tempo, e 503 indica serviço temporariamente indisponível, muitas vezes por manutenção.

301 vs 302 vs 307 vs 308

301 e 308 são redirecionamentos permanentes; 302 e 307 são temporários. A diferença entre cada par é o método: 301 e 302 podem transformar um POST em GET, enquanto 307 e 308 garantem que o método e o corpo continuem iguais. Para SEO, use 301 ou 308 quando uma página muda de vez, para que os buscadores transfiram o ranking para a nova URL.

401 vs 403

Um 401 significa que o servidor não sabe quem você é: as credenciais estão ausentes, expiradas ou erradas. Um 403 significa que o servidor sabe quem você é, mas você não tem permissão para fazer isso. Retorne 401 para pedir login e 403 quando entrar de novo não adiantaria.

Escolhendo o código certo para a sua API

Use códigos específicos em vez de 200 com uma mensagem de erro no corpo. Retorne 201 com o cabeçalho Location após criar um recurso, 204 após uma exclusão, 422 para erros de validação e 409 para conflitos. Clientes, caches, ferramentas de monitoramento e buscadores dependem do código de status para se comportar corretamente.

Privado e rápido

Toda a referência carrega junto com a página e a busca roda no seu navegador. Nada do que você digita é enviado a um servidor.

Perguntas frequentes sobre códigos HTTP

O que é um código de status HTTP?

É um número de três dígitos que o servidor envia no início de cada resposta para dizer se a requisição funcionou, precisa de outro passo ou falhou, e por quê.

Qual a diferença entre erros 4xx e 5xx?

Os 4xx indicam que o problema está na requisição (o cliente): URL errada, falta de login, dados inválidos. Os 5xx indicam que a requisição era válida, mas o servidor falhou ao atendê-la.

O que significa 404 Not Found?

O servidor não encontra o recurso naquela URL. Pode ser erro de digitação, página excluída ou ID errado. Se a página foi removida de propósito e não volta, 410 Gone é mais preciso.

Quando usar 301 e quando usar 302?

Use 301 quando a mudança é permanente, como um novo domínio ou URL alterada, para que os buscadores transfiram o ranking. Use 302 quando a mudança é temporária.

Qual a diferença entre 502, 503 e 504?

502 Bad Gateway: o proxy recebeu uma resposta inválida da aplicação. 503 Service Unavailable: o servidor está sobrecarregado ou em manutenção. 504 Gateway Timeout: a aplicação demorou demais para responder ao proxy.

O código 418 I am a teapot é real?

Sim. Vem de uma RFC de brincadeira de 1º de abril (RFC 2324), continua no registro e às vezes é usado como easter egg.

É grátis?

Sim. É grátis, não exige cadastro e roda inteiramente no seu navegador.