#Erp4Me

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.


Índice



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.