Do Postman ao Bruno

Versão em Inglês Originalmente lançado como uma extensão do Chrome em 2012, o Postman começou como um projeto paralelo de Abhinav Asthana. Ao longo dos anos, o Postman se tornou um companheiro inestimável para fazer requisições e testar APIs. Os arquivos de collection e ambiente do Postman foram compartilhados inúmeras vezes por desenvolvedores. A collection do Postman foi projetada para ser um único arquivo contendo todas as requisições de API, scripts de pré-requisição, scripts de pós-requisição, scripts de teste, etc. Os arquivos de ambiente também desempenham um grande papel no ciclo de desenvolvimento, facilitando as trocas de ambiente. No entanto, manter uma collection do Postman pode ser desafiador se houver uma quantidade substancial de APIs em equipes com mais de três membros. Um plano pago é necessário para obter colaboração ilimitada no Postman e manter a collection do Postman em sua cloud. Uma equipe que mantém cerca de cinquenta endpoints sob o plano gratuito teria dificuldades para manter a collection atualizada. Devido à dificuldade de manter um grande arquivo de collection do Postman versionado no git, era hora de procurar alternativas. O recurso mais importante em um novo API Client seria ser amigável ao git e ter pelo menos as mesmas funcionalidades básicas que o Postman oferece, como scripts, configuração de ambiente, etc. O Bruno API Client é um API Client relativamente novo que teve seu primeiro lançamento público em outubro de 2022. O que torna o Bruno único é sua estrutura de collection: em vez de ser apenas um único arquivo, ele é organizado como um projeto nodejs, com um arquivo principal cercado por vários arquivos de suporte. Cada requisição de API é salva como um arquivo com a extensão .bru. O Bruno é projetado pra ser developer friendly, facilitando a integração com o Git. Isso significa que você pode gerenciar suas collections do Bruno através de um repositório Git, o que realmente aumenta a colaboração entre os membros da equipe. Você pode instalar o Bruno facilmente, seja baixando-o diretamente do site oficial ou usando um gerenciador de pacotes do sistema operacional, como homebrew, apt ou chocolatey. A estrutura da collection do Bruno se assemelha a um projeto nodejs, tornando a collection colaborativa e fácil de manter. Arquivos de Ambiente No Bruno, os arquivos de ambiente estão associados a uma collection específica e são armazenados na pasta environments, com cada ambiente salvo em seu próprio arquivo separado. Ao contrário do Postman, onde os arquivos de ambiente podem ser compartilhados entre várias collections, os arquivos de ambiente do Bruno são dedicados a collections individuais, garantindo uma configuração mais organizada e focada. O Bruno oferece uma variedade de variáveis de ambiente, incluindo global, environment, collection, folder, request, runtime e process variables. Além disso, ele suporta nativamente arquivos dotenv, permitindo que você armazene informações sensíveis de forma segura em sua máquina local, enquanto as mantém fora do controle de versão com gitignore. Isso torna o gerenciamento de seus dados sensíveis fácil e seguro! Configuração do Arquivo Dotenv Para começar, basta colocar um arquivo .env no diretório raiz da sua collection. Agora, vamos configurar uma API Key no arquivo .env! API_KEY = fd79a328afe69b0 Você pode usar a variável API_KEY em suas requisições, bem como em arquivos de ambiente, referenciando-a assim: {{process.env.API_KEY}} Bibliotecas Externas Como a collection do Bruno é estruturada como um projeto nodejs, instalar uma nova biblioteca é apenas um comando npm de distância. Usar uma biblioteca externa é necessário para habilitar o modo desenvolvedor. No entanto, isso exigiria adicionar à whitelist alguns módulos no arquivo bruno.json. Cheerio é uma biblioteca para analisar respostas HTML que requer adicionar à whitelist algumas de suas dependências, como os módulos vm e buffer. Como mostrado abaixo: "scripts": { "moduleWhitelist": [ "vm", "buffer" ], "filesystemAccess": { "allow": false } } Considerações Finais O Bruno API Client é uma ferramenta valiosa para equipes que priorizam o gerenciamento de collections de API Client com uma abordagem voltada para o Git. Seus recursos e estrutura únicos tornam a colaboração mais fácil e eficiente, tornando-o uma ótima escolha para desenvolvedores.

Apr 30, 2025 - 12:34

Originalmente lançado como uma extensão do Chrome em 2012, o Postman começou como um projeto paralelo de Abhinav Asthana. Ao longo dos anos, o Postman se tornou um companheiro inestimável para fazer requisições e testar APIs. Os arquivos de collection e ambiente do Postman foram compartilhados inúmeras vezes por desenvolvedores.

A collection do Postman foi projetada para ser um único arquivo contendo todas as requisições de API, scripts de pré-requisição, scripts de pós-requisição, scripts de teste, etc. Os arquivos de ambiente também desempenham um grande papel no ciclo de desenvolvimento, facilitando as trocas de ambiente.

No entanto, manter uma collection do Postman pode ser desafiador se houver uma quantidade substancial de APIs em equipes com mais de três membros. Um plano pago é necessário para obter colaboração ilimitada no Postman e manter a collection do Postman em sua cloud. Uma equipe que mantém cerca de cinquenta endpoints sob o plano gratuito teria dificuldades para manter a collection atualizada.

Devido à dificuldade de manter um grande arquivo de collection do Postman versionado no git, era hora de procurar alternativas. O recurso mais importante em um novo API Client seria ser amigável ao git e ter pelo menos as mesmas funcionalidades básicas que o Postman oferece, como scripts, configuração de ambiente, etc.

O Bruno API Client é um API Client relativamente novo que teve seu primeiro lançamento público em outubro de 2022. O que torna o Bruno único é sua estrutura de collection: em vez de ser apenas um único arquivo, ele é organizado como um projeto nodejs, com um arquivo principal cercado por vários arquivos de suporte. Cada requisição de API é salva como um arquivo com a extensão .bru. O Bruno é projetado pra ser developer friendly, facilitando a integração com o Git. Isso significa que você pode gerenciar suas collections do Bruno através de um repositório Git, o que realmente aumenta a colaboração entre os membros da equipe.

Você pode instalar o Bruno facilmente, seja baixando-o diretamente do site oficial ou usando um gerenciador de pacotes do sistema operacional, como homebrew, apt ou chocolatey.

A estrutura da collection do Bruno se assemelha a um projeto nodejs, tornando a collection colaborativa e fácil de manter.

Arquivos de Ambiente

No Bruno, os arquivos de ambiente estão associados a uma collection específica e são armazenados na pasta environments, com cada ambiente salvo em seu próprio arquivo separado. Ao contrário do Postman, onde os arquivos de ambiente podem ser compartilhados entre várias collections, os arquivos de ambiente do Bruno são dedicados a collections individuais, garantindo uma configuração mais organizada e focada.

O Bruno oferece uma variedade de variáveis de ambiente, incluindo global, environment, collection, folder, request, runtime e process variables. Além disso, ele suporta nativamente arquivos dotenv, permitindo que você armazene informações sensíveis de forma segura em sua máquina local, enquanto as mantém fora do controle de versão com gitignore. Isso torna o gerenciamento de seus dados sensíveis fácil e seguro!

Configuração do Arquivo Dotenv

Para começar, basta colocar um arquivo .env no diretório raiz da sua collection. Agora, vamos configurar uma API Key no arquivo .env!

API_KEY = fd79a328afe69b0

Você pode usar a variável API_KEY em suas requisições, bem como em arquivos de ambiente, referenciando-a assim:

{{process.env.API_KEY}}

Bibliotecas Externas

Como a collection do Bruno é estruturada como um projeto nodejs, instalar uma nova biblioteca é apenas um comando npm de distância. Usar uma biblioteca externa é necessário para habilitar o modo desenvolvedor. No entanto, isso exigiria adicionar à whitelist alguns módulos no arquivo bruno.json.

Cheerio é uma biblioteca para analisar respostas HTML que requer adicionar à whitelist algumas de suas dependências, como os módulos vm e buffer. Como mostrado abaixo:

"scripts": {
    "moduleWhitelist": [
      "vm",
      "buffer"
    ],
    "filesystemAccess": {
      "allow": false
    }
  }

Considerações Finais

O Bruno API Client é uma ferramenta valiosa para equipes que priorizam o gerenciamento de collections de API Client com uma abordagem voltada para o Git. Seus recursos e estrutura únicos tornam a colaboração mais fácil e eficiente, tornando-o uma ótima escolha para desenvolvedores.