Referencia de Codigos de Status HTTP

Entendendo os Codigos de Status HTTP

Codigos de status HTTP sao numeros de tres digitos que um servidor retorna em resposta a cada requisicao HTTP. Eles fazem parte da especificacao HTTP e fornecem uma maneira padronizada para os servidores comunicarem o resultado de uma requisicao ao cliente. Quando voce visita uma pagina web, seu navegador envia uma requisicao HTTP ao servidor, e o servidor responde com um codigo de status junto com o conteudo solicitado ou uma mensagem de erro. Entender esses codigos e fundamental para desenvolvimento web, design de API, administracao de servidores e depuracao de problemas de rede.

Os codigos de status sao agrupados em cinco classes com base no primeiro digito. Cada classe representa um tipo diferente de resposta. Os codigos 1xx sao informativos, indicando que a requisicao foi recebida e o processamento esta continuando. Os codigos 2xx sinalizam sucesso, significando que a requisicao foi recebida, entendida e aceita. Os codigos 3xx indicam redirecionamento, informando ao cliente que deve tomar acoes adicionais para completar a requisicao. Os codigos 4xx representam erros do cliente, onde a requisicao contem sintaxe incorreta ou nao pode ser atendida. Os codigos 5xx indicam erros do servidor, onde o servidor falhou ao atender uma requisicao valida.

As Cinco Categorias de Codigos de Status

Respostas Informativas 1xx

Respostas informativas indicam que o servidor recebeu a requisicao e esta continuando a processa-la. A mais notavel e 100 Continue, que informa ao cliente para prosseguir com o envio do corpo da requisicao apos enviar apenas os cabecalhos. Isso e util para uploads grandes onde o cliente quer verificar se o servidor aceitara a requisicao antes de transmitir um payload potencialmente grande. O 103 Early Hints e uma adicao mais recente que permite ao servidor enviar cabecalhos preliminares antes da resposta final, permitindo que o navegador pre-carregue folhas de estilo e scripts enquanto o servidor prepara a resposta principal.

Codigos de Sucesso 2xx

Codigos de sucesso confirmam que a requisicao foi processada corretamente. O 200 OK e o mais comum, retornado para requisicoes GET bem-sucedidas padrao. O 201 Created e usado quando um novo recurso foi criado, tipicamente em resposta a uma requisicao POST. O 204 No Content indica sucesso sem corpo de resposta, comumente usado para operacoes DELETE e acoes de API que nao precisam retornar dados. O 206 Partial Content suporta requisicoes de intervalo, permitindo que clientes baixem arquivos grandes em partes ou retomem downloads interrompidos.

Redirecionamento 3xx e Codigos de Erro 4xx/5xx

Codigos de redirecionamento instruem o cliente a procurar o recurso solicitado em outro lugar. A distincao entre 301 Moved Permanently e 302 Found e critica para SEO, pois mecanismos de busca os tratam de forma diferente ao transferir autoridade de links. Codigos de erro do cliente na faixa 4xx cobrem tudo, desde requisicoes malformadas (400) ate falhas de autenticacao (401, 403), recursos inexistentes (404) e limitacao de taxa (429). Codigos de erro do servidor na faixa 5xx indicam problemas no lado do servidor, desde falhas gerais (500) ate respostas de bad gateway (502) e indisponibilidade do servico (503). Monitorar esses codigos ajuda equipes de operacoes a identificar e resolver problemas rapidamente.

Codigos de Status Comuns no Desenvolvimento de API

APIs RESTful dependem fortemente de codigos de status para comunicar resultados. Uma API bem projetada usa 200 para leituras bem-sucedidas, 201 para criacoes bem-sucedidas, 204 para exclusoes bem-sucedidas, 400 para erros de validacao, 401 para autenticacao ausente, 403 para permissoes insuficientes, 404 para recursos que nao existem, 409 para conflitos como entradas duplicadas, 422 para requisicoes semanticamente invalidas e 429 para requisicoes com taxa limitada. O uso consistente de codigos de status torna as APIs previsiveis e mais faceis de integrar pelos consumidores.

Perguntas Frequentes

O que sao codigos de status HTTP?

Numeros de tres digitos retornados por servidores web indicando o resultado de uma requisicao. Sao agrupados em cinco classes: 1xx Informativo, 2xx Sucesso, 3xx Redirecionamento, 4xx Erro do Cliente e 5xx Erro do Servidor.

O que significam os codigos de status 4xx?

Codigos 4xx indicam erros do cliente. A requisicao estava malformada, nao autorizada ou apontava para um recurso inexistente. Exemplos comuns incluem 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found e 429 Too Many Requests.

Qual e a diferenca entre redirecionamentos 301 e 302?

301 e um redirecionamento permanente que informa navegadores e mecanismos de busca para atualizarem suas URLs. 302 e um redirecionamento temporario onde a URL original ainda deve ser usada para requisicoes futuras. 301 transfere a autoridade de links para SEO; 302 nao transfere.

O que e o codigo de status HTTP 418?

Uma brincadeira de Primeiro de Abril da RFC 2324 que define o Hyper Text Coffee Pot Control Protocol. Um bule retorna 418 quando solicitado a preparar cafe. Apesar de ser humoristico, foi amplamente implementado como um Easter egg.

Quando devo usar uma resposta 204 No Content?

Use 204 para requisicoes bem-sucedidas que nao precisam de corpo de resposta, como operacoes DELETE, atualizacoes bem-sucedidas onde o cliente ja possui os dados e acoes de API do tipo disparar-e-esquecer.