Skip to main content

Status Code API | Conceito

  • Status Code API | Conceito

1xx​

  • 1XX: Resposta Informacional (Exemplo: 100, 101, 102, etc.) Códigos de status na faixa 1xx indicam que o servidor recebeu a solicitação do cliente e está continuando o processo. Esses códigos são usados principalmente para fins informativos e normalmente não exigem nenhuma ação do cliente.

2xx​

  • 2XX: Resposta Bem-sucedida (Exemplo: 200, 201, 203, 204, etc.) Sempre que você receber um código 2XX como resposta, significa que a solicitação foi bem-sucedida. Códigos de status na faixa 2xx indicam que o servidor recebeu, entendeu e aceitou a solicitação do cliente. Esses códigos geralmente indicam que a ação solicitada foi concluída com sucesso.
info

Status Code 201:

RFC 7231 (Hypertext Transfer Protocol – Semantics and Content), Seção 6.3.2 diz:

  • o recurso principal criado deve ser identificado por um header Location na resposta ou, se esse header não existir, pela URI efetiva da requisição;
POST /usuarios HTTP/1.1
Content-Type: application/json

{ "nome": "Adolfo" }
HTTP/1.1 201 Created
Location: /usuarios/123
Content-Type: application/json

{ "id": 123, "nome": "Adolfo" }
  • Exemplo mínimo no .NET
app.MapPost("/usuarios", (UsuarioCriacaoDto dto) =>
{
    var usuario = new UsuarioDto(123, dto.Nome);

    return Results.Created($"/usuarios/{usuario.Id}", usuario);
});

3xx​

  • 3XX: Resposta de Redirecionamento (Exemplo: 301, 302, 304, etc.) Sempre que você receber um código 3XX como resposta, significa que está ocorrendo um redirecionamento no servidor. Códigos de status na faixa 3xx indicam que o cliente precisa realizar uma ação adicional para concluir a solicitação. Esses códigos são usados quando um recurso foi movido ou está temporariamente indisponível, e o cliente precisa tomar medidas adicionais para acessá-lo.

    danger

    Os status code 301 e 302 são extremamente importantes no desenvolver de um encurtador de URL

    info

    301 Moved Permanently​

    • Indica que o recurso foi movido permanentemente para uma nova URL.

    • O navegador ou cliente deve atualizar seus links para o novo endereço.

    • Os motores de busca (como Google) transferem o SEO para o novo link.

    📘 Exemplo:

    HTTP/1.1 301 Moved Permanently
    Location: https://exemplo.com/novo-endereco

    💡 Uso típico: quando muda a estrutura de URLs do site (ex: http → https).

    302 Found (ou “Moved Temporarily”)​

    • Indica que a mudança de endereço é temporária.

    • O cliente não deve atualizar seus links.

    • Motores de busca não transferem o SEO automaticamente.

    ⚖️ Diferença resumida​

    CódigoTipo de RedirecionamentoPermanenteSEOCliente deve atualizar link?
    301Permanente✅ Sim✅ Sim✅ Sim
    302Temporário❌ Não❌ Não❌ Não

4xx​

  • 4XX: Resposta de Erro do Cliente (Exemplo: 400, 401, 404, 405, etc.) Sempre que você receber um código 4XX como resposta, significa que há algum problema na solicitação do cliente. Códigos de status na faixa 4xx indicam que a solicitação não foi bem-sucedida devido a um erro no lado do cliente. Esses códigos geralmente estão relacionados a problemas como requisições inválidas, acesso não autorizado ou recursos inexistentes.
info

404 – serve tanto para indicar que a URL digitada é inválida quanto para informar que um recurso (dados) não existe.

5xx​

  • 5XX: Resposta de Erro do Servidor (Exemplo: 500, 502, 503, 504, etc.) Sempre que você receber um código 5XX como resposta, significa que há algum problema no servidor. Códigos de status na faixa 5xx indicam que o servidor encontrou um erro ao processar a solicitação do cliente. Esses códigos normalmente estão associados a falhas internas do servidor, indicando que a ação solicitada não pôde ser concluída por motivos técnicos.