O servidor recebeu os cabeçalhos e o cliente deve enviar o corpo da requisição.
101
Switching Protocols
O servidor está trocando de protocolo conforme solicitado, quase sempre para WebSocket.
200
OK
A resposta de sucesso padrão. O corpo traz o recurso solicitado.
201
Created
A requisição deu certo e um novo recurso foi criado. O endereço dele vai no cabeçalho Location.
202
Accepted
A requisição foi aceita para processamento, mas ainda não terminou. Comum em tarefas assíncronas.
204
No Content
Sucesso sem corpo para retornar. Muito usado em DELETE e em atualizações com PUT.
206
Partial Content
O servidor está devolvendo parte do recurso em resposta a um cabeçalho Range, como no streaming de vídeo.
301
Moved Permanently
O recurso mudou de endereço permanentemente. Transfere os sinais de ranqueamento para a nova URL: é o redirecionamento certo para uma mudança definitiva.
302
Found
Um redirecionamento temporário. Os buscadores mantêm a URL original indexada, então nunca use isso para uma mudança definitiva.
304
Not Modified
A cópia em cache ainda é válida. É enviado em resposta a uma requisição condicional e economiza banda.
307
Temporary Redirect
Como o 302, mas garante que o método HTTP não muda no redirecionamento.
308
Permanent Redirect
Como o 301, mas preserva o método e o corpo da requisição.
400
Bad Request
O servidor não conseguiu interpretar a requisição. Normalmente é um JSON malformado ou um parâmetro obrigatório ausente.
401
Unauthorized
Falta autenticação ou ela é inválida. Apesar do nome, trata-se de autenticação, não de permissão.
403
Forbidden
A identidade é conhecida, mas não tem permissão para isso. Repetir com as mesmas credenciais não vai adiantar.
404
Not Found
Não há recurso nessa URL. Precisa devolver um 404 de verdade: uma página de «não encontrado» que responde 200 é um soft 404.
405
Method Not Allowed
A URL existe, mas não aceita esse método HTTP. Inclua um cabeçalho Allow listando os métodos aceitos.
409
Conflict
A requisição entra em conflito com o estado atual, como uma chave única duplicada ou uma versão desatualizada.
410
Gone
Removido de forma deliberada e permanente. Os buscadores tiram uma URL com 410 do índice mais rápido do que uma com 404.
418
I'm a teapot
Uma piada de 1º de abril de 1998 que navegadores e servidores mantêm viva desde então.
422
Unprocessable Content
A sintaxe é válida, mas o conteúdo não passa nas regras de validação. Comum em APIs JSON.
429
Too Many Requests
Limite de requisições atingido. Inclua um cabeçalho Retry-After para o cliente saber quando tentar de novo.
500
Internal Server Error
Uma exceção não tratada no servidor. É o código curinga quando nada mais específico se aplica.
502
Bad Gateway
Um proxy recebeu uma resposta inválida do servidor de origem. Normalmente a aplicação está fora do ar ou quebrando.
503
Service Unavailable
Sobrecarga temporária ou manutenção. É o código certo para uma parada planejada, junto com o Retry-After.
504
Gateway Timeout
Um proxy esperou demais pela resposta da origem. Costuma indicar consulta lenta ou dependência travada.
Tudo é calculado no seu navegador. O que você digita não é enviado para nenhum servidor.
Códigos de status HTTP: para que serve
Os códigos de status HTTP dizem muito mais do que a maioria das APIs aproveita. A diferença entre 301 e 302 determina se os sinais de ranqueamento são transferidos, e a diferença entre 401 e 403 é a que separa autenticação de autorização. Esta referência com busca cobre os códigos padrão com suas implicações práticas.
Códigos de status HTTP: como usar
Busque pelo número do código ou por palavra-chave.
Filtre por classe: 2xx sucesso, 3xx redirecionamento, 4xx erro do cliente, 5xx erro do servidor.
Leia o significado e a causa típica.
Preste atenção aos redirecionamentos e erros que afetam a indexação.
Perguntas frequentes
Qual é a diferença entre um redirecionamento 301 e um 302?
O 301 é permanente e transfere os sinais de ranqueamento para a nova URL; o 302 é temporário e diz aos buscadores para manter a original indexada. Usar 302 para uma mudança definitiva é um erro comum e caro.
Quando devolver 404 e quando 410?
O 404 significa «não encontrado», talvez temporariamente. O 410 indica remoção deliberada e permanente, e os buscadores tiram uma URL com 410 do índice mais rápido.
O que é um soft 404?
Uma página que diz «não encontrado» para o usuário mas responde com código 200. Os buscadores a indexam como página real e desperdiçam orçamento de rastreamento. Aplicações de página única produzem isso com muita facilidade.
Qual é a diferença entre 401 e 403?
O 401 diz que você não se autenticou, então credenciais podem ajudar. O 403 diz que você está autenticado mas não tem permissão, e repetir com a mesma identidade não vai adiantar.