Códigos de Status HTTP (HTTP Status Codes)

Definição

Os códigos de status HTTP são respostas numéricas enviadas pelo servidor para indicar o resultado de uma requisição.

Cada código possui três dígitos e pertence a uma classe, identificada pelo primeiro número:

• 1xx – Informativo
• 2xx – Sucesso
• 3xx – Redirecionamento
• 4xx – Erros do cliente
• 5xx – Erros do servidor

Objetivos dos códigos de status

• Informar ao cliente sobre o resultado da requisição.
• Permitir que navegadores, APIs e aplicações reajam de forma apropriada.
• Ajudar no diagnóstico de falhas e no entendimento do comportamento da rede.
• Facilitar o controle de fluxo em aplicações web e RESTful APIs.

Exemplo prático (requisição com fetch)

fetch("https://api.exemplo.com/dados").then((res) => {
  if (res.status === 200) {
    return res.json();
  } else {
    console.error("Erro:", res.status);
  }
});

Nesse exemplo:

• Um código 200 indica sucesso.

• Qualquer outro valor pode ser tratado como erro ou comportamento especial.

O ciclo de uso de um status HTTP

[Cliente faz uma requisição HTTP]
↓
[Servidor processa a requisição]
↓
[Servidor retorna um status]
↓
[Cliente interpreta o status e toma ação com base nele]

Exemplos comuns

Exemplos comuns

Relacionados

• HTTP
• Cabeçalhos HTTP
• URL e URI