Guia de Testes de API para Iniciantes com Postman

Por Flaviana Pina | Business Analyst & QA

A arquitetura da maioria dos sistemas modernos é baseada em APIs (Application Programming Interfaces). Garantir que a comunicação entre o front-end e o back-end (ou entre microsserviços) funcione corretamente é uma das habilidades mais valorizadas em um QA hoje. Uma das melhores ferramentas para começar (e escalar) esses testes é o Postman.

1. Conheça os Verbos HTTP

Antes de testar, é preciso entender o que a API deve fazer. Os métodos mais comuns são:

- GET: Busca uma informação (ex: consultar o saldo do cliente).
- POST: Cria um novo registro (ex: cadastrar um novo usuário no sistema).
- PUT / PATCH: Atualiza um registro existente.
- DELETE: Remove uma informação.

2. Valide sempre o Status Code (Teste de Contrato)

O teste mais básico e importante de uma API é verificar se o servidor respondeu o que era esperado. Códigos como 200 (OK) ou 201 (Created) indicam sucesso. Já os da família 400 indicam erros enviados pelo cliente, e 500 indicam erros do servidor. No Postman, você automatiza essa validação na aba "Tests" com um simples comando: pm.response.to.have.status(200);.

3. Validação do Corpo da Resposta (Payload)

Não basta a API retornar "Sucesso", os dados também precisam estar corretos. Se você fez um GET buscando o cliente "João", a API não pode retornar a "Maria". Utilizando JavaScript dentro do Postman, transformamos a resposta em um objeto legível (JSON) e validamos campos específicos: pm.expect(jsonData.nome).to.eql("João");.

4. Indo além: Newman e Integração Contínua

O Postman é incrível para criar e debugar os cenários de teste, mas a verdadeira automação acontece quando integramos tudo em uma pipeline de CI/CD (como Azure DevOps). Para isso, exportamos nossa Collection e usamos o Newman, a versão de linha de comando do Postman, garantindo que a qualidade seja validada a cada novo deploy da equipe de desenvolvimento.

Conclusão

Testar APIs é testar o "cérebro" da aplicação antes mesmo que exista uma tela pronta. Comece garantindo que os contratos estão sendo respeitados, avance para a validação dos dados de negócio e, por fim, automatize a execução contínua.