Testes de API para Iniciantes: Guia Pratico

O Que Sao Testes de API?

Teste de API e o processo de enviar requisicoes a um endpoint de API e verificar se a resposta esta correta — codigo de status certo, formato de dados certo, valores certos, dentro de um tempo de resposta aceitavel. Diferente de testes de UI, que interagem com botoes e formularios, testes de API trabalham diretamente com a camada de dados.

APIs sao a espinha dorsal do software moderno. Seu app mobile fala com uma API. Seu frontend fala com uma API. Integracoes de terceiros (pagamento, envio, email) sao todas APIs. Se a API esta errada, tudo construido sobre ela esta errado.

Fundamentos HTTP

A maioria das APIs se comunica via HTTP. Os metodos mais importantes:

• GET: Recuperar dados. Nao deve modificar nada. GET /api/users/42 retorna o usuario 42.
• POST: Criar um novo recurso. POST /api/users com um corpo JSON cria um novo usuario.
• PUT: Substituir um recurso existente completamente.
• PATCH: Atualizar parcialmente um recurso.
• DELETE: Remover um recurso.

Codigos de Status

• 200 OK: Requisicao bem-sucedida.
• 201 Created: Recurso criado com sucesso.
• 400 Bad Request: Requisicao malformada — campos faltando, tipos errados, JSON invalido.
• 401 Unauthorized: Autenticacao necessaria mas nao fornecida ou invalida.
• 403 Forbidden: Autenticado mas sem permissao para este recurso.
• 404 Not Found: O recurso nao existe nesta URL.
• 500 Internal Server Error: Algo quebrou no lado do servidor.

Primeira Requisicao de API

O jeito mais simples de testar uma API e com uma ferramenta baseada no navegador — sem instalacao. Digite a URL, escolha o metodo HTTP, adicione headers e corpo se necessario, e envie.

Um fluxo tipico de teste segue o ciclo CRUD:

1. Envie um GET para listar recursos existentes. Verifique resposta 200 e formato correto.
2. Envie um POST para criar um novo recurso. Verifique resposta 201.
3. Envie um GET para o novo recurso. Verifique se existe e os dados estao corretos.
4. Envie um PUT ou PATCH para atualiza-lo. Verifique as mudancas.
5. Envie um DELETE. Depois um GET — deve retornar 404.

Headers e Autenticacao

• Content-Type: Diz ao servidor o formato do corpo. Quase sempre application/json.
• Authorization: Carrega as credenciais. Bearer <token> para JWT, Basic <base64> para usuario:senha.
• Accept: Diz ao servidor qual formato de resposta voce quer.

Os tres metodos de autenticacao mais comuns: API Keys, Bearer Tokens (JWT) e OAuth 2.0.

O Que Testar

• Caminho feliz: Entradas corretas produzem saidas corretas.
• Validacao: Campos obrigatorios faltando retornam 400, nao 500.
• Casos limite: Strings vazias, strings muito longas, caracteres especiais, valores nulos.
• Autenticacao: Requisicoes sem token retornam 401.
• Performance: Tempo de resposta sob carga.

Experimente no Navegador

Nosso Testador de API permite enviar requisicoes HTTP a qualquer API direto do navegador. Defina metodo, URL, headers e corpo, depois veja a resposta com JSON formatado, codigo de status e tempo.