Testar APIs REST é uma parte essencial do desenvolvimento de software moderno. Felizmente, existem diversas ferramentas que facilitam esse processo, cada uma com suas características únicas. Este artigo apresenta seis das mais populares: curl, Postman, Insomnia, Bruno, HTTPie e Apidog, incluindo instruções de instalação, uso básico e como adicionar autenticação por token em endpoints que exigem autorização.
curl
Instalação
O curl geralmente vem pré-instalado em sistemas Unix-like (Linux, macOS). No Windows, pode ser instalado via:
- Git Bash
- WSL (Windows Subsystem for Linux)
- Ou baixando o executável oficial em curl.se
Uso Básico
Para fazer uma requisição GET simples:
curl https://api.example.com/usersCom Autenticação (Token Bearer)
Para adicionar um token de autenticação no header Authorization:
curl -H "Authorization: Bearer SEU_TOKEN_AQUI" https://api.example.com/protegidoSubstitua SEU_TOKEN_AQUI pelo seu token real. Outros métodos (POST, PUT, etc.) seguem o mesmo padrão, apenas alterando o verb (-X POST, -X PUT, etc.).
Postman
Instalação
Baixe o instalador oficial do site postman.com para Windows, macOS ou Linux. Também está disponível como aplicativo Snap (sudo snap install postman) ou via Homebrew (brew install --cask postman no macOS).
Uso Básico
- Abra o Postman e clique em "New" → "HTTP Request".
- Insira a URL (ex:
https://api.example.com/users). - Selecione o método HTTP (GET, POST, etc.) ao lado da URL.
- Clique em "Send" para ver a resposta.
Com Autenticação (Token Bearer)
- Na aba "Headers" da requisição, clique em "Add".
- Em "Key", digite
Authorization. - Em "Value", digite
Bearer SEU_TOKEN_AQUI. - Clique em "Send".
Alternativamente, use variáveis de ambiente para gerenciar tokens de forma mais segura em múltiplas requisições.
Insomnia
Instalação
Disponível para download no site insomnia.rest. Também pode ser instalado via:
- Homebrew:
brew install --cask insomnia - Snap:
sudo snap install insomnia - Chocolatey (Windows):
choco install insomnia
Uso Básico
- Abra o Insomnia e clique em "+" → "New Request".
- Nomeie a requisição, escolha o método e cole a URL.
- Clique em "Send".
Com Autenticação (Token Bearer)
- Na requisição aberta, vá para a aba "Headers".
- Clique no campo abaixo de "Headers" e selecione "Authorization" no dropdown.
- No campo de valor, selecione "Bearer Token" e cole seu token.
- Clique em "Send".
O Insomnia também permite salvar tokens em variáveis de ambiente ou em arquivos de configuração para reutilização.
Apidog
Instalação
Apidog está disponível como aplicativo desktop para Windows, macOS e Linux, além de versão web. Pode ser baixado diretamente do site oficial apidog.com. Também oferece versão para deploy privado para equipes que necessitam de solução on-premise.
Uso Básico
- Abra o Apidog e clique em "+ New Request" ou use o atalho Ctrl+N.
- Insira a URL da API (ex:
https://api.example.com/users). - Selecione o método HTTP desejado (GET, POST, PUT, DELETE, etc.) no dropdown ao lado do campo de URL.
- Clique no botão "Send" para enviar a requisição e visualizar a resposta.
Com Autenticação (Token Bearer)
- Na aba "Headers" da requisição, clique no campo abaixo para adicionar um novo header.
- Em "Key", selecione ou digite
Authorization. - Em "Value", escolha o tipo "Bearer Token" no dropdown e cole seu token no campo fornecido. Alternativamente, você pode digitar diretamente:
Bearer SEU_TOKEN_AQUI. - Clique em "Send" para executar a requisição com autenticação.
O Apidog também permite salvar tokens em variáveis de ambiente ou usar seu sistema de gerenciamento de credenciais integrado para maior segurança e reutilização entre diferentes requisições e ambientes.
Bruno
Instalação
O Bruno é uma ferramenta que pode usar pelo terminal e desktop, com o diferencial em versionamento de requisições via Git. Instale-o via:
- npm:
npm install -g @usebruno/bruno - Homebrew:
brew install bruno - Ou baixe o binário diretamente das site oficial da ferramenta useBruno
Uso Básico
- Inicie uma coleção:
bruno init minha-colecao - Crie uma nova requisição:
bruno request get usuarios(isso cria um arquivo.bru) - Edite o arquivo gerado (ex:
minha-colecao/usuarios.get.bru) para definir URL, método, etc. - Execute:
bruno run minha-colecao/usuarios.get.bru
Com Autenticação (Token Bearer)
No arquivo .bru, adicione o header de autorização diretamente:
GET https://api.example.com/protegido
Authorization: Bearer SEU_TOKEN_AQUIExecute como de costume com bruno run. O Bruno é ideal para equipes que preferem armazenar requisições como código-fonte versionado.
HTTPie
Instalação
Instale via:
- pip:
pip install httpie - Homebrew:
brew install httpie - apt (Ubuntu/Debian):
sudo apt install httpie - Ou veja mais opções em httpie.io/docs#installation
Uso Básico
Para uma requisição GET simples:
http GET https://api.example.com/usersCom Autenticação (Token Bearer)
Adicione o header Authorization diretamente:
http GET https://api.example.com/protegido Authorization:"Bearer SEU_TOKEN_AQUI"Ou, usando a sintaxe curta para headers:
http GET https://api.example.com/protegido 'Authorization:Bearer SEU_TOKEN_AQUI'O HTTPie também suporta autenticação via --auth-type e --auth, mas para Bearer Token, definir o header diretamente é o método mais direto.
Considerações Finais
Todas as ferramentas apresentadas cumprem o mesmo propósito fundamental: testar e interagir com APIs REST de forma eficaz. A escolha entre elas depende fortemente de preferências pessoais, contexto de uso e fluxo de trabalho da equipe.
curl e HTTPiesão excelentes para usuários que preferem trabalhar no terminal, especialmente útil para scripts de automação ou ambientes sem interface gráfica.Postman, Insomnia, Bruno, Apidog, HTTPieoferecem interfaces gráficas intuitivas, recursos avançados como coleções, variáveis de ambiente, geração de código e testes integrados, sendo ideais para exploratory testing e documentação colaborativa.Brunose destaca por sua abordagem baseada em arquivos, permitindo versionar requisições diretamente no Git, o que é atraente para equipes que adotam práticas de DevOps e Infrastructure as Code.
Não há uma "ferramenta ideal" universal; a melhor escolha é aquela que se alinha melhor com seus hábitos, necessidades específicas e ambiente de trabalho. Experimente algumas delas e adotar aquela que tornar seu processo de teste de API mais eficiente e agradável. Lembre-se: o objetivo é validar suas APIs com confiança, independentemente da ferramenta utilizada.
Boa testagem!
Referências
Feito!
Nenhum comentário:
Postar um comentário