Pague-me um café
Dev

Códigos de Status HTTP

Guia de referência de todos os códigos de status HTTP com descrições. Funciona no seu dispositivo — nada é enviado, nada é armazenado.

Mostrando 50 de 50 códigos de status
100
Continue
1xx

O cliente deve continuar com a requisição. Usado para informar ao cliente que a parte inicial da requisição foi recebida.

Caso de uso: O servidor reconhece a requisição parcial; o cliente deve prosseguir.
101
Switching Protocols
1xx

O servidor está mudando para um protocolo diferente, conforme solicitado pelo cliente.

Caso de uso: Atualização do handshake WebSocket a partir do HTTP.
102
Processing
1xx

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

Caso de uso: Prevenção de tempo limite em requisições WebDAV de longa duração.
103
Early Hints
1xx

Usado para retornar alguns cabeçalhos de resposta antes da mensagem HTTP final.

Caso de uso: Pré-carregamento de recursos antes de a resposta completa estar pronta.
200
OK
2xx

A requisição foi bem-sucedida. O significado depende do método HTTP utilizado.

Caso de uso: Resposta padrão para GET, POST, PUT e DELETE bem-sucedidos.
201
Criada
2xx

A requisição foi bem-sucedida e um novo recurso foi criado como resultado.

Caso de uso: Requisição POST que criou com sucesso um novo usuário ou registro.
202
Accepted
2xx

Requisição recebida, mas ainda não processada. O processamento ocorre de forma assíncrona.

Caso de uso: Disparo de um job em segundo plano ou tarefa assíncrona via API.
203
Non-Authoritative Information
2xx

Os metadados retornados não vêm do servidor de origem, mas de uma cópia local ou de terceiros.

Caso de uso: Servidores proxy transformando ou armazenando respostas em cache.
204
No Content
2xx

A requisição foi bem-sucedida, mas não há conteúdo a ser enviado na resposta.

Caso de uso: DELETE ou PUT que não precisa retornar dados.
206
Partial Content
2xx

O servidor está entregando apenas parte do recurso devido a um cabeçalho de intervalo enviado pelo cliente.

Caso de uso: Streaming de vídeo ou downloads de arquivos retomáveis.
207
Multi-Status
2xx

Vários códigos de status para várias sub-requisições no WebDAV.

Caso de uso: Respostas PROPFIND do WebDAV com vários status de recurso.
208
Already Reported
2xx

Membros de um binding DAV já enumerados em uma resposta anterior.

Caso de uso: Respostas WebDAV evitando a repetição de membros.
226
IM Used
2xx

O servidor atendeu a uma requisição GET e a resposta é resultado de manipulações de instância.

Caso de uso: Codificação delta em respostas HTTP.
301
Moved Permanently
3xx

A URL do recurso solicitado mudou permanentemente. A nova URL é fornecida na resposta.

Caso de uso: Redirecionamento permanente amigável para SEO da URL antiga para a nova URL.
302
Found
3xx

A URL do recurso solicitado mudou temporariamente. Outras alterações podem ocorrer.

Caso de uso: Redirecionamento temporário enquanto uma página está sendo atualizada.
303
See Other
3xx

O servidor envia esta resposta para direcionar o cliente a obter o recurso solicitado em outra URI com uma requisição GET.

Caso de uso: Redirecionamento após o envio de um formulário via POST.
304
Not Modified
3xx

Usado para cache. Informa ao cliente que a resposta não mudou, para que ele possa usar a versão em cache.

Caso de uso: Validação de cache do navegador com cabeçalhos ETag ou Last-Modified.
307
Temporary Redirect
3xx

O servidor envia esta resposta para direcionar o cliente a obter o recurso solicitado em outra URI com o mesmo método.

Caso de uso: Redirecionamento temporário preservando o método HTTP original.
308
Permanent Redirect
3xx

Redirecionamento permanente que preserva o método HTTP usado na requisição original.

Caso de uso: Migração permanente de endpoint de API preservando o método POST.
400
Bad Request
4xx

O servidor não consegue processar a requisição devido a sintaxe malformada ou estruturação inválida da mensagem.

Caso de uso: Corpo JSON inválido ou parâmetros de consulta obrigatórios ausentes.
401
Unauthorized
4xx

A autenticação é necessária e não foi fornecida ou é inválida.

Caso de uso: Requisição de API sem um token ou sessão válidos.
402
Payment Required
4xx

Reservado para uso futuro; às vezes usado para exigências de pagamento digital.

Caso de uso: Paywall ou assinatura necessária para acessar o conteúdo.
403
Forbidden
4xx

O cliente não tem direitos de acesso ao conteúdo. Diferente do 401, a identidade é conhecida.

Caso de uso: Usuário autenticado tentando acessar um recurso exclusivo de administrador.
404
Not Found
4xx

O servidor não consegue encontrar o recurso solicitado. A URL não é reconhecida.

Caso de uso: Acesso a uma página ou recurso que não existe.
405
Method Not Allowed
4xx

O método da requisição é conhecido, mas não é compatível com o recurso de destino.

Caso de uso: Envio de DELETE para um endpoint que só aceita GET.
406
Not Acceptable
4xx

O servidor não consegue produzir uma resposta que corresponda à lista de valores aceitáveis definida nos cabeçalhos da requisição.

Caso de uso: API que retorna apenas JSON, mas o cliente solicita XML.
408
Request Timeout
4xx

O servidor não recebeu uma mensagem de requisição completa dentro do tempo que estava preparado para esperar.

Caso de uso: O cliente demora muito para enviar o corpo da requisição.
409
Conflict
4xx

A requisição entra em conflito com o estado atual do servidor.

Caso de uso: Tentativa de criar um nome de usuário que já existe.
410
Gone
4xx

O recurso de destino não está mais disponível e não estará disponível novamente.

Caso de uso: Conteúdo excluído permanentemente, sem endereço de redirecionamento.
411
Length Required
4xx

O servidor recusou a requisição porque o campo de cabeçalho Content-Length está ausente.

Caso de uso: Requisição POST sem o cabeçalho Content-Length.
413
Payload Too Large
4xx

O servidor recusa a requisição porque o payload é maior do que o servidor está disposto a processar.

Caso de uso: Upload de arquivo excedendo o tamanho máximo permitido.
414
URI Too Long
4xx

A URI solicitada pelo cliente é mais longa do que o servidor está disposto a interpretar.

Caso de uso: Query strings extremamente longas em requisições GET.
415
Unsupported Media Type
4xx

O servidor se recusa a aceitar a requisição porque o formato do payload não é compatível.

Caso de uso: Envio de XML para um endpoint de API que só aceita JSON.
422
Unprocessable Entity
4xx

O servidor entende o tipo de conteúdo, mas não consegue processar as instruções.

Caso de uso: Dados de formulário com JSON válido, mas valores de campo inválidos.
423
Locked
4xx

O recurso que está sendo acessado está bloqueado.

Caso de uso: Recurso WebDAV bloqueado por outro usuário.
425
Too Early
4xx

Indica que o servidor não está disposto a arriscar processar uma requisição que possa ser repetida.

Caso de uso: Dados antecipados em conexões TLS 1.3.
429
Too Many Requests
4xx

O usuário enviou requisições demais em um determinado período (limitação de taxa).

Caso de uso: Limite de taxa da API excedido; o cliente deve recuar.
431
Request Header Fields Too Large
4xx

O servidor se recusa a processar a requisição porque os campos de cabeçalho são grandes demais.

Caso de uso: Cookies ou cabeçalhos personalizados excedendo os limites do servidor.
451
Unavailable For Legal Reasons
4xx

O servidor está negando acesso a um recurso devido a exigências legais.

Caso de uso: Conteúdo bloqueado devido a uma notificação DMCA ou ordem judicial.
500
Internal Server Error
5xx

O servidor encontrou uma situação que não sabe como tratar.

Caso de uso: Exceção não tratada no código do lado do servidor.
501
Not Implemented
5xx

O método da requisição não é compatível com o servidor e não pode ser tratado.

Caso de uso: O servidor não é compatível com o método PATCH em um recurso.
502
Bad Gateway
5xx

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

Caso de uso: Nginx recebendo uma resposta inválida do servidor de aplicação no backend.
503
Service Unavailable
5xx

O servidor não está pronto para tratar a requisição. Causas comuns são estar em manutenção ou sobrecarregado.

Caso de uso: Servidor em manutenção ou com tráfego elevado.
504
Gateway Timeout
5xx

O servidor atuando como gateway não obteve uma resposta a tempo do servidor upstream.

Caso de uso: API upstream demorando demais para responder.
505
HTTP Version Not Supported
5xx

A versão de HTTP usada na requisição não é compatível com o servidor.

Caso de uso: Cliente usando HTTP/3 com um servidor que só é compatível com HTTP/1.1.
506
Variant Also Negotiates
5xx

O servidor tem um erro de configuração interna na negociação de conteúdo transparente.

Caso de uso: Negociação de conteúdo mal configurada no servidor.
507
Insufficient Storage
5xx

O servidor não consegue armazenar a representação necessária para concluir a requisição.

Caso de uso: Servidor WebDAV ficando sem espaço de armazenamento.
508
Loop Detected
5xx

O servidor detectou um loop infinito ao processar a requisição.

Caso de uso: Requisição WebDAV criando referências circulares.
510
Not Extended
5xx

São necessárias extensões adicionais à requisição para que o servidor a atenda.

Caso de uso: O cliente precisa enviar uma requisição do HTTP Extension Framework.
511
Network Authentication Required
5xx

O cliente precisa se autenticar para obter acesso à rede.

Caso de uso: Portal cativo exigindo login antes do acesso à internet.