Status code HTTP

Definição

O status code HTTP é o código que indica a categoria e o resultado de uma resposta. Ele abre a resposta e resume o que aconteceu, enquanto o corpo detalha o caso concreto.

As famílias de resposta

Os códigos se organizam por famílias: informação, sucesso, redirecionamento e erro. Dentro de cada família, valores comuns como 200, 201, 400, 401, 403, 404 e 500 apontam situações específicas.

HTTP/1.1 200 OK
Content-Type: application/json

{"id":42,"nome":"Ana"}

HTTP/1.1 404 Not Found
Content-Type: application/json

{"mensagem":"Cliente não encontrado"}

HTTP/1.1 500 Internal Server Error
Content-Type: application/json

{"mensagem":"Falha interna no processamento"}

Código e contrato juntos

O código resume o resultado HTTP, mas não substitui a leitura do corpo nem do contrato. Um 401 indica que a autenticação é necessária, um 403 que o acesso foi negado, e o contrato explica como cada caso deve ser tratado pelo consumidor.

Como conferir o código na prática

A aba Network das ferramentas do navegador mostra o status de cada chamada, e o console da aplicação pode repeti-lo junto da resposta. Confira sempre o código junto do corpo: um 200 com um registro ausente indica erro de contrato, enquanto um 404 com a mensagem esperada indica o caso tratado. A falha mais comum é ler só o corpo e ignorar o código, tratando um 401 ou 403 como falha genérica. O código diz a categoria do resultado, e o corpo completa o que aconteceu naquela operação.

Aplicação na formação

Vibe Coding: Do Zero ao MVP

Na Formação Vibe Coding, o status code resume o resultado de cada chamada da interface à API.

Conhecer a formação →