Códigos de Status HTTP

Referência completa de códigos HTTP. Pesquise, filtre por categoria e aprenda quando usar cada código.

Como funciona: Explore todos os códigos HTTP abaixo. Use a barra de pesquisa para encontrar códigos por número ou nome, ou filtre por categoria (1xx-5xx). Clique em qualquer código para copiá-lo.

Mostrando 34 de 34 códigos

100

Continuar

clique para copiar

O servidor recebeu os headers e o cliente deve prosseguir com o envio do corpo da solicitação.

101

Mudando Protocolos

clique para copiar

O servidor está mudando protocolos conforme solicitado pelo cliente (ex: upgrade para WebSocket).

102

Processando

clique para copiar

O servidor recebeu e está processando a solicitação, mas ainda não há resposta disponível (WebDAV).

103

Dicas Antecipadas

clique para copiar

Usado para retornar alguns headers antes da mensagem final, permitindo ao navegador pré-carregar recursos.

200

OK

clique para copiar

A solicitação foi bem-sucedida. O significado depende do método HTTP: GET retorna o recurso, POST retorna o resultado da ação.

201

Criado

clique para copiar

A solicitação foi bem-sucedida e um novo recurso foi criado. Tipicamente usado como resposta a solicitações POST.

202

Aceito

clique para copiar

A solicitação foi aceita para processamento, mas ainda não foi concluída. Usado para operações assíncronas.

204

Sem Conteúdo

clique para copiar

O servidor processou a solicitação com sucesso mas não retorna conteúdo. Resposta comum para operações DELETE.

206

Conteúdo Parcial

clique para copiar

O servidor entrega apenas parte do recurso devido a um header Range enviado pelo cliente.

207

Multi-Status

clique para copiar

Resposta que transmite informações sobre múltiplos recursos onde vários códigos de status podem ser apropriados (WebDAV).

301

Movido Permanentemente

clique para copiar

O recurso foi movido permanentemente para uma nova URL. Os buscadores atualizarão seus links.

302

Encontrado

clique para copiar

O recurso reside temporariamente em outra URL. O cliente deve continuar usando a URL original para futuras solicitações.

303

Ver Outro

clique para copiar

A resposta pode ser encontrada em outra URL usando GET. Frequentemente usado após POST para redirecionar a uma página de confirmação.

304

Não Modificado

clique para copiar

O recurso não foi modificado desde a última solicitação. Usado para cache — o cliente pode usar sua versão salva.

307

Redirecionamento Temporário

clique para copiar

O recurso reside temporariamente em outra URL. Diferente do 302, o método de solicitação não deve mudar.

308

Redirecionamento Permanente

clique para copiar

O recurso foi movido permanentemente. Diferente do 301, o método de solicitação não deve mudar.

400

Solicitação Inválida

clique para copiar

O servidor não pode processar a solicitação devido a sintaxe malformada, parâmetros inválidos ou campos obrigatórios ausentes.

401

Não Autorizado

clique para copiar

Autenticação é necessária. O cliente deve fornecer credenciais válidas (API key, token ou login) para acessar.

403

Proibido

clique para copiar

O servidor entendeu a solicitação mas se recusa a autorizá-la. Autenticação não ajudará — o usuário não tem permissão.

404

Não Encontrado

clique para copiar

O recurso solicitado não foi encontrado no servidor. A URL pode estar incorreta ou o recurso pode ter sido excluído.

405

Método Não Permitido

clique para copiar

O método HTTP usado não é suportado para este recurso. Por exemplo, usar POST em um endpoint somente leitura.

408

Tempo Esgotado

clique para copiar

O servidor esgotou o tempo de espera. O cliente demorou demais para enviar a solicitação completa.

409

Conflito

clique para copiar

A solicitação conflita com o estado atual do servidor. Comum em controle de versão ou ao tentar criar um recurso duplicado.

410

Desaparecido

clique para copiar

O recurso não está mais disponível e não estará novamente. Diferente do 404, esta é uma condição permanente.

413

Carga Muito Grande

clique para copiar

O corpo da solicitação é maior do que o servidor aceita. Comum para limites de upload de arquivos.

415

Tipo de Mídia Não Suportado

clique para copiar

O tipo de mídia do corpo da solicitação não é suportado. Por exemplo, enviar XML quando apenas JSON é aceito.

418

Sou um Bule

clique para copiar

O servidor se recusa a preparar café porque é, permanentemente, um bule de chá. Uma piada do April Fools' do RFC 2324.

422

Entidade Não Processável

clique para copiar

O servidor entende o conteúdo mas não pode processá-lo. Usado para erros de validação — a sintaxe está correta mas os dados são inválidos.

429

Muitas Solicitações

clique para copiar

O usuário enviou muitas solicitações em um período de tempo (rate limiting). Verifique o header Retry-After.

500

Erro Interno do Servidor

clique para copiar

O servidor encontrou uma condição inesperada que o impediu de atender a solicitação. Um erro genérico do servidor.

501

Não Implementado

clique para copiar

O servidor não suporta a funcionalidade necessária. O método pode não ser reconhecido.

502

Gateway Inválido

clique para copiar

O servidor, atuando como gateway ou proxy, recebeu uma resposta inválida do servidor upstream.

503

Serviço Indisponível

clique para copiar

O servidor não pode atender a solicitação temporariamente devido a manutenção ou sobrecarga. Geralmente temporário.

504

Tempo Esgotado do Gateway

clique para copiar

O servidor, atuando como gateway ou proxy, não recebeu uma resposta a tempo do servidor upstream.

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

Códigos de status HTTP são números de três dígitos retornados por servidores web para indicar o resultado de uma solicitação. São agrupados em cinco categorias: 1xx (Informativo), 2xx (Sucesso), 3xx (Redirecionamento), 4xx (Erro do Cliente) e 5xx (Erro do Servidor). Entender esses códigos é essencial para desenvolvimento web, design de APIs e depuração de problemas de rede.

Códigos HTTP mais comuns

Os códigos mais frequentes são 200 OK (solicitação bem-sucedida), 301 Movido Permanentemente (recurso realocado), 404 Não Encontrado (recurso não existe), 403 Proibido (acesso negado) e 500 Erro Interno do Servidor (falha do servidor). Esses cinco códigos representam a grande maioria das respostas HTTP que você encontrará na navegação web e desenvolvimento de APIs.

Códigos HTTP em APIs REST

APIs REST usam códigos de status para comunicar o resultado de operações. Uma API bem projetada retorna 200 para GET bem-sucedidos, 201 para POST bem-sucedidos (recurso criado), 204 para DELETE bem-sucedidos (sem conteúdo), 400 para entrada inválida, 401 para falhas de autenticação, 403 para falhas de autorização, 404 para recursos inexistentes e 422 para erros de validação.

Melhores práticas com códigos HTTP

  • Retorne o código mais específico — 404 é melhor que um genérico 400
  • Use 201 Created (não 200) quando um recurso é criado via POST
  • Retorne 204 No Content para operações DELETE bem-sucedidas
  • Use 429 com header Retry-After para rate limiting
  • Nunca retorne 200 com erro no body — use códigos 4xx/5xx
  • Use 301 para redirecionamentos permanentes (SEO) e 307 para temporários