Lista de códigos de status HTTP: Guia completo e exemplos

Uma lista completa de códigos de status HTTP com explicações detalhadas. Compilamos todos os 96 códigos de resposta HTTP (63 comuns e 33 personalizados) para ajudá-lo a entender melhor seu propósito e uso adequado no desenvolvimento web.

Códigos 1xx

100 ContinueO servidor recebeu a parte inicial da solicitação e está aguardando o restante.
101 Switching ProtocolsO cliente solicitou uma mudança de protocolo, e o servidor está realizando a alteração.
102 ProcessingO servidor aceitou a solicitação, mas o processamento leva mais tempo.
103 Early HintsO servidor envia cabeçalhos com antecedência antes que a resposta completa esteja pronta.

Códigos 2xx

200 OKA solicitação foi processada com sucesso e o servidor forneceu os dados solicitados.
201 CriadoO recurso foi criado com sucesso. O servidor inclui um cabeçalho Location com o endereço do recurso criado.
202 AceitoA solicitação foi aceita, mas o processamento será concluído posteriormente. A resposta pode conter informações adicionais de status.
203 Informação Não AutorizadaA resposta contém informações obtidas de uma fonte de terceiros, em vez do servidor principal.
204 Sem ConteúdoO servidor processou a solicitação com sucesso, mas não retorna conteúdo. O navegador não deve atualizar o documento atual.
205 Redefinir ConteúdoO cliente deve redefinir o formulário de entrada usado na interação atual.
206 Conteúdo ParcialO servidor está enviando apenas parte do recurso solicitado, conforme especificado no cabeçalho Content-Range.
207 Multi-StatusA resposta contém múltiplos códigos de status independentes para diferentes partes da solicitação.
208 Já ReportadoO elemento já foi listado anteriormente na mesma resposta.
218 Isto está bemUm código não oficial que indica que o servidor processou a solicitação com sucesso, mas com pequenas questões.
226 IM UsadoO servidor completou uma solicitação GET e usou um ou mais algoritmos de transformação de recursos.

Códigos 3xx

300 Multiple ChoicesO recurso solicitado está disponível em várias variantes. O servidor pode fornecer uma lista de opções possíveis.
301 Moved PermanentlyO recurso foi permanentemente movido para um novo endereço especificado no cabeçalho Location.
302 FoundO recurso está temporariamente disponível em um endereço diferente, mas a URL antiga pode ser usada novamente no futuro.
303 See OtherO recurso está disponível em outro endereço especificado no cabeçalho Location.
304 Not ModifiedO recurso não foi modificado desde a última solicitação, e a versão em cache é utilizada.
305 Use ProxyO acesso ao recurso só é possível através do servidor proxy especificado.
306 Switch ProxyEste código é reservado, mas não é utilizado em implementações HTTP modernas.
307 Temporary RedirectO recurso foi temporariamente movido, mas o método de solicitação deve permanecer inalterado.
308 Permanent RedirectO recurso foi permanentemente movido para uma nova URL, e o método de solicitação deve ser preservado.

Códigos 4xx

400 Bad RequestA solicitação está incorreta devido a um erro de sintaxe.
401 UnauthorizedA autenticação do usuário é necessária para acessar o recurso.
402 Payment RequiredO acesso ao recurso requer pagamento.
403 ForbiddenO acesso ao recurso é proibido pelo servidor.
404 Not FoundO recurso solicitado não foi encontrado.
405 Method Not AllowedO método de solicitação não é suportado pelo servidor para este recurso.
406 Not AcceptableO formato de resposta do servidor não corresponde à solicitação do cliente.
407 Proxy Authentication RequiredA autenticação através de um servidor proxy é necessária.
408 Request TimeoutA solicitação expirou; a conexão foi fechada.
409 ConflictA solicitação não pode ser concluída devido a um conflito com o estado atual do recurso.
410 GoneO recurso solicitado não está mais disponível e não será restaurado.
411 Length RequiredO servidor requer o cabeçalho Content-Length.
412 Precondition FailedUma das pré-condições na solicitação não foi atendida.
413 Payload Too LargeO tamanho da solicitação excede o limite permitido pelo servidor.
414 URI Too LongA URI solicitada é muito longa para o servidor processar.
415 Unsupported Media TypeO formato dos dados da solicitação não é suportado pelo servidor.
416 Range Not SatisfiableA faixa solicitada não pode ser processada pelo servidor.
417 Expectation FailedO servidor não pode satisfazer o valor do cabeçalho Expect.
418 I’m a TeapotO servidor se recusa a preparar café porque é uma chaleira.
419 Page ExpiredA sessão do usuário expirou.
420 Method FailureFalha no método.
420 Enhance Your CalmSolicitações excessivas, por favor reduza a carga.
421 Misdirected RequestA solicitação foi direcionada a um servidor que não pode processá-la.
422 Unprocessable EntityO servidor não pode processar a solicitação devido a um erro de conteúdo.
423 LockedO acesso ao recurso está bloqueado.
424 Failed DependencyA solicitação falhou devido a uma falha em uma solicitação dependente.
425 Too EarlyO servidor se recusa a processar a solicitação porque foi enviada muito cedo.
426 Upgrade RequiredO cliente deve atualizar para um protocolo diferente para concluir a solicitação.
428 Precondition RequiredO servidor requer que a solicitação atenda a certas pré-condições.
429 Too Many RequestsO cliente enviou muitas solicitações em um curto período.
430 Shopify Security RejectionA solicitação foi rejeitada pelo sistema de segurança da Shopify.
430 Shopify Security RejectionA solicitação foi rejeitada pelo sistema de segurança da Shopify.
431 Request Header Fields Too LargeOs cabeçalhos da solicitação são muito grandes para o servidor processar.
440 Login Time-outA sessão do usuário expirou.
444 No ResponseO servidor fechou a conexão sem enviar uma resposta.
449 Retry WithInformações adicionais são necessárias para processar a solicitação.
450 Blocked by Windows Parental ControlsO acesso ao recurso é restrito pelo controle parental do Windows.
451 Unavailable For Legal ReasonsO acesso ao recurso é restrito por razões legais.
494 Request Header Too LargeO cabeçalho da solicitação é muito grande para o servidor processar.
495 SSL Certificate ErrorO certificado SSL apresentado pelo cliente é inválido.
496 SSL Certificate RequiredUm certificado SSL válido é necessário para acessar este recurso.
497 HTTP Request Sent to HTTPS PortO cliente enviou uma solicitação HTTP para uma porta apenas HTTPS.
498 Invalid TokenO token fornecido na solicitação é inválido ou expirou.
499 Client Closed RequestO cliente fechou a conexão antes de receber uma resposta do servidor.

Códigos 5xx

500 Internal Server ErrorOcorreu um erro interno do servidor, o processamento da solicitação é impossível.
501 Not ImplementedA solicitação não pode ser processada porque o servidor não suporta a funcionalidade necessária.
502 Bad GatewayO servidor recebeu uma resposta inválida de outro servidor ao processar a solicitação.
503 Service UnavailableO servidor está temporariamente indisponível devido a sobrecarga ou manutenção.
504 Gateway Time-outO limite de tempo para aguardar uma resposta de outro servidor ou gateway foi excedido.
505 HTTP Version not supportedA versão HTTP utilizada não é suportada pelo servidor.
506 Variant Also NegotiatesErro de configuração do servidor, a seleção da variante também participa da negociação.
507 Insufficient StorageO servidor não pode concluir a solicitação devido à falta de memória ou espaço em disco.
508 Loop DetectedUm loop infinito foi detectado ao processar a solicitação.
509 Bandwidth Limit ExceededO limite de largura de banda do servidor foi excedido.
510 Not ExtendedA solicitação requer extensões adicionais que não são suportadas pelo servidor.
511 Network Authentication RequiredAutenticação de rede é necessária para acessar o recurso.
520 Unknown ErrorErro de servidor desconhecido.
521 Web Server Is DownO servidor web está indisponível.
522 Connection Timed OutTempo limite da conexão excedido.
523 Origin Is UnreachableA origem do recurso é inacessível.
524 A Timeout OccurredO tempo limite da solicitação foi excedido.
525 SSL Handshake FailedFalha na negociação SSL.
526 Invalid SSL CertificateCertificado SSL inválido.
527 Railgun ErrorErro de conexão via Railgun.
529 Site is overloadedO site está sobrecarregado com solicitações.
530 Site is frozenO site está congelado e indisponível.
530 Origin DNS ErrorErro de DNS do lado da origem.
540 Temporarily DisabledO servidor está temporariamente desativado.
598 Network read timeout errorErro de leitura de rede devido ao tempo limite.
599 Network Connect Timeout ErrorErro de conexão devido ao tempo limite.

Outro

783 Token Inesperado (Shopify)Token inesperado na solicitação do Shopify.
999 Não-padrãoCódigo de erro não-padrão.

Lista de Códigos de Status HTTP

Os códigos de status HTTP são respostas do servidor que indicam o resultado de uma requisição feita por um cliente. Eles desempenham um papel crucial na comunicação entre clientes e servidores, fornecendo informações sobre o sucesso ou falha de uma operação. A seguir, apresentamos uma descrição detalhada dos diferentes grupos de códigos de status HTTP.

Descrição Geral dos Códigos de Status

Definição de Códigos de Status: Um código de status HTTP é um número de três dígitos retornado pelo servidor que indica o resultado de uma solicitação HTTP.
Importância dos Códigos de Status: Eles ajudam os desenvolvedores e administradores de sistemas a diagnosticar problemas e a entender como as requisições estão sendo processadas.

1xx: Códigos Informativos

Esta categoria de códigos é usada para informar ao cliente que a requisição foi recebida e está sendo processada.

100 Continue: Indica que o inicial da requisição foi recebido e o cliente pode continuar com a transmissão do restante.
101 Switching Protocols: Informa que o servidor está mudando os protocolos de acordo com a solicitação do cliente.

2xx: Códigos de Sucesso

Os códigos nesta categoria indicam que a requisição foi bem-sucedida e que o servidor retornou os dados esperados.

200 OK: A requisição foi bem-sucedida e o servidor retornou os dados solicitados.
201 Created: A requisição foi bem-sucedida e resultou na criação de um novo recurso.
204 No Content: A requisição foi bem-sucedida, mas não há conteúdo a ser retornado.

3xx: Códigos de Redirecionamento

Esses códigos são utilizados para redirecionar o cliente para outra URL.

301 Moved Permanently: O recurso foi movido permanentemente para uma nova URL.
302 Found: O recurso foi encontrado, mas está temporariamente disponível em outra URL.
304 Not Modified: Indica que o recurso não foi modificado desde a última requisição.

4xx: Códigos de Erros do Cliente

Os códigos dessa categoria indicam que houve um problema com a requisição enviada pelo cliente.

400 Bad Request: A requisição não pôde ser entendida pelo servidor devido a sintaxe inválida.
401 Unauthorized: O acesso ao recurso requerido requer autenticação.
404 Not Found: O recurso solicitado não foi encontrado no servidor.

5xx: Códigos de Erros do Servidor

Esses códigos indicam que o servidor encontrou um erro ao processar a requisição do cliente.

500 Internal Server Error: Ocorreu um erro inesperado no servidor.
502 Bad Gateway: O servidor, atuando como um gateway ou proxy, recebeu uma resposta inválida do servidor upstream.
503 Service Unavailable: O servidor não está disponível no momento, geralmente devido a manutenção ou sobrecarga.

Códigos de Status na Prática

Os códigos de status são fundamentais na prática de desenvolvimento e manutenção de APIs. Aqui estão algumas considerações sobre como utilizá-los corretamente:

Utilização em Desenvolvimento: Ao desenvolver uma API, é importante retornar os códigos de status apropriados para cada situação, permitindo que os clientes entendam rapidamente o resultado de suas requisições.
Recomendações para Tratamento de Erros: Ao lidar com erros, forneça informações adicionais na resposta, como mensagens de erro ou códigos de erro personalizados, para facilitar o diagnóstico e a resolução de problemas.
Impacto na Experiência do Usuário: Códigos de status bem implementados ajudam a melhorar a experiência do usuário, proporcionando feedback claro sobre o que está acontecendo com suas requisições.

Código	Descrição	Categoría
200	OK	Sucesso
404	Not Found	Erro do Cliente
500	Internal Server Error	Erro do Servidor