Dúvidas sobre os códigos de status da API no Postman.
Este artigo é para ajudar você a entender rapidamente o que significam os códigos de status que a API retorna em seus testes no Postman, focado em clareza e organização por tópicos.
1. Entendendo os Códigos de Sucesso (Família códigos: 2xx)
Estes códigos indicam que a sua solicitação foi processada com sucesso.
200 OK
Significado:Sucesso Padrão. Tudo certo! A requisição foi processada corretamente. A resposta contém os dados solicitados (em requisições GET) ou a confirmação da ação.
Importância: É a confirmação de uma conexão bem-sucedida.
201 Created
Significado:Novo Recurso Criado. A requisição foi bem-sucedida e resultou na criação de um novo recurso no servidor.
Uso Comum: Muito comum em requisições do tipo POST.
204 No Content
Significado:Sucesso Sem Conteúdo. A requisição foi bem-sucedida, mas não há conteúdo para retornar no corpo da resposta.
Uso Comum: Usado para métodos como DELETE ou PUT, quando a operação foi concluída e não é necessário retornar dados.
2. O que Fazer em Caso de Erro (Família códigos: 4xx?
Se você receber um código de erro (4xx), a API geralmente retorna uma mensagem que explica o problema. Sempre leia essa mensagem!
Inconsistências no body da requisição:
400 Bad Request
Causa: A solicitação não foi entendida ou estava malformada, como parâmetros incorretos ou dados faltando (ex: usuário ou senha inválidos).
Como Solucionar: Revise o corpo da requisição (Body), a URL e os parâmetros para garantir que todos os dados obrigatórios estejam corretos.
401 Unauthorized
Causa:Falta ou é inválido o token de autenticação. O cliente precisa se autenticar para acessar o recurso.
Como Solucionar: Verifique se o seu token de autenticação foi enviado corretamente na requisição e se ele ainda é válido.
403 Forbidden
Causa:Acesso Proibido. O servidor entendeu a requisição, mas se recusa a autorizá-la. Você pode estar autenticado, mas não tem permissão para acessar o recurso específico.
Como Solucionar: O problema é de permissão. Se necessário, entre em contato com o administrador do sistema.
404 Not Found
Causa:O recurso solicitado não foi encontrado no servidor. O endereço (endpoint) não existe ou o recurso foi removido.
Como Solucionar: Revise cuidadosamente a URL do endpoint que você digitou.
405 Method Not Allowed
Causa: Você usou o método HTTP errado (ex: usou POST quando o esperado era GET) para o recurso solicitado.
Como Solucionar: Mude o método da requisição no Postman para o método que o endpoint espera.