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
Continuar
clique para copiarO servidor recebeu os headers e o cliente deve prosseguir com o envio do corpo da solicitação.
Mudando Protocolos
clique para copiarO servidor está mudando protocolos conforme solicitado pelo cliente (ex: upgrade para WebSocket).
Processando
clique para copiarO servidor recebeu e está processando a solicitação, mas ainda não há resposta disponível (WebDAV).
Dicas Antecipadas
clique para copiarUsado para retornar alguns headers antes da mensagem final, permitindo ao navegador pré-carregar recursos.
OK
clique para copiarA solicitação foi bem-sucedida. O significado depende do método HTTP: GET retorna o recurso, POST retorna o resultado da ação.
Criado
clique para copiarA solicitação foi bem-sucedida e um novo recurso foi criado. Tipicamente usado como resposta a solicitações POST.
Aceito
clique para copiarA solicitação foi aceita para processamento, mas ainda não foi concluída. Usado para operações assíncronas.
Sem Conteúdo
clique para copiarO servidor processou a solicitação com sucesso mas não retorna conteúdo. Resposta comum para operações DELETE.
Conteúdo Parcial
clique para copiarO servidor entrega apenas parte do recurso devido a um header Range enviado pelo cliente.
Multi-Status
clique para copiarResposta que transmite informações sobre múltiplos recursos onde vários códigos de status podem ser apropriados (WebDAV).
Movido Permanentemente
clique para copiarO recurso foi movido permanentemente para uma nova URL. Os buscadores atualizarão seus links.
Encontrado
clique para copiarO recurso reside temporariamente em outra URL. O cliente deve continuar usando a URL original para futuras solicitações.
Ver Outro
clique para copiarA resposta pode ser encontrada em outra URL usando GET. Frequentemente usado após POST para redirecionar a uma página de confirmação.
Não Modificado
clique para copiarO recurso não foi modificado desde a última solicitação. Usado para cache — o cliente pode usar sua versão salva.
Redirecionamento Temporário
clique para copiarO recurso reside temporariamente em outra URL. Diferente do 302, o método de solicitação não deve mudar.
Redirecionamento Permanente
clique para copiarO recurso foi movido permanentemente. Diferente do 301, o método de solicitação não deve mudar.
Solicitação Inválida
clique para copiarO servidor não pode processar a solicitação devido a sintaxe malformada, parâmetros inválidos ou campos obrigatórios ausentes.
Não Autorizado
clique para copiarAutenticação é necessária. O cliente deve fornecer credenciais válidas (API key, token ou login) para acessar.
Proibido
clique para copiarO servidor entendeu a solicitação mas se recusa a autorizá-la. Autenticação não ajudará — o usuário não tem permissão.
Não Encontrado
clique para copiarO recurso solicitado não foi encontrado no servidor. A URL pode estar incorreta ou o recurso pode ter sido excluído.
Método Não Permitido
clique para copiarO método HTTP usado não é suportado para este recurso. Por exemplo, usar POST em um endpoint somente leitura.
Tempo Esgotado
clique para copiarO servidor esgotou o tempo de espera. O cliente demorou demais para enviar a solicitação completa.
Conflito
clique para copiarA solicitação conflita com o estado atual do servidor. Comum em controle de versão ou ao tentar criar um recurso duplicado.
Desaparecido
clique para copiarO recurso não está mais disponível e não estará novamente. Diferente do 404, esta é uma condição permanente.
Carga Muito Grande
clique para copiarO corpo da solicitação é maior do que o servidor aceita. Comum para limites de upload de arquivos.
Tipo de Mídia Não Suportado
clique para copiarO tipo de mídia do corpo da solicitação não é suportado. Por exemplo, enviar XML quando apenas JSON é aceito.
Sou um Bule
clique para copiarO servidor se recusa a preparar café porque é, permanentemente, um bule de chá. Uma piada do April Fools' do RFC 2324.
Entidade Não Processável
clique para copiarO 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.
Muitas Solicitações
clique para copiarO usuário enviou muitas solicitações em um período de tempo (rate limiting). Verifique o header Retry-After.
Erro Interno do Servidor
clique para copiarO servidor encontrou uma condição inesperada que o impediu de atender a solicitação. Um erro genérico do servidor.
Não Implementado
clique para copiarO servidor não suporta a funcionalidade necessária. O método pode não ser reconhecido.
Gateway Inválido
clique para copiarO servidor, atuando como gateway ou proxy, recebeu uma resposta inválida do servidor upstream.
Serviço Indisponível
clique para copiarO servidor não pode atender a solicitação temporariamente devido a manutenção ou sobrecarga. Geralmente temporário.
Tempo Esgotado do Gateway
clique para copiarO 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