Como Compartilhar Coleções do Postman Sem Precisar do Plano de Equipe

TL;DR

O nível gratuito do Postman limita o compartilhamento de coleções de maneiras que pegam muitos desenvolvedores de surpresa. Se você precisa colaborar com colegas de equipe sem pagar US$ 19/usuário/mês, existem algumas soluções alternativas, mas cada uma delas apresenta desvantagens reais. O plano gratuito do Apidog permite que você compartilhe seu espaço de trabalho com até 3 usuários, sem necessidade de upgrade.

Introdução

O Postman começou como uma simples extensão do Chrome para enviar requisições HTTP. Ao longo dos anos, ele se tornou uma plataforma de API completa, e seus preços cresceram junto. Hoje, equipes que desejam compartilhar coleções e colaborar em tempo real precisam de um plano pago. O nível gratuito deixa muitos desenvolvedores procurando soluções alternativas.

Se você está gerenciando uma pequena equipe, um projeto paralelo ou uma startup onde cada dólar conta, pagar US$ 19 por usuário por mês apenas para compartilhar uma coleção parece muito. São US$ 228 por pessoa por ano antes mesmo de você lançar uma única funcionalidade.

A boa notícia é que existem maneiras legítimas de compartilhar coleções do Postman no plano gratuito. Nenhuma delas é tão tranquila quanto pagar pelo plano Team, mas elas funcionam. Este guia apresenta cada método, explica o que falha e mostra como é uma alternativa gratuita genuína.

O que o plano gratuito do Postman realmente permite

Antes de analisar as soluções alternativas, é útil entender o que o plano gratuito inclui a partir de 2024-2025.

O plano gratuito do Postman oferece:

• 1 usuário por espaço de trabalho (sem edição compartilhada)
• Até 3 espaços de trabalho públicos ativos
• Espaços de trabalho pessoais ilimitados
• 1.000 chamadas de mock server por mês
• 1.000 chamadas de monitoramento por mês
• Execuções de coleção limitadas a 25 por mês no cloud runner

A limitação crítica: você não pode convidar colegas de equipe para um espaço de trabalho privado no plano gratuito. Espaços de trabalho privados exigem pelo menos o plano Básico, a US$ 19/usuário/mês. Essa é a barreira que a maioria das pequenas equipes encontra primeiro.

Método 1: Exporte a coleção como JSON e compartilhe o arquivo

A solução alternativa mais direta é exportar sua coleção como um arquivo JSON e enviá-lo para seu colega de equipe.

Como fazer:

1. Abra o Postman e navegue até sua coleção na barra lateral esquerda.
2. Clique no menu de três pontos ao lado do nome da coleção.
3. Selecione "Exportar".
4. Escolha o formato Coleção v2.1 (este é o padrão atual e possui a mais ampla compatibilidade).
5. Salve o arquivo JSON e compartilhe-o por e-mail, Slack ou um drive compartilhado.

Seu colega de equipe importa-o indo em Arquivo > Importar e arrastando o arquivo JSON.

O que falha:

No momento em que você exporta, a coleção se torna um instantâneo. Se você adicionar um novo endpoint ou corrigir uma requisição, seu colega de equipe não tem como saber. Eles estão trabalhando com uma cópia desatualizada.

Variáveis de ambiente não viajam com a coleção por padrão. Você precisa exportar os ambientes separadamente, e seu colega de equipe também terá que importá-los. Se você esquecer uma variável, as requisições deles falharão e eles gastarão tempo depurando algo que na verdade não está quebrado.

Não há fluxo de trabalho de merge. Se duas pessoas editarem suas cópias locais simultaneamente e depois tentarem reconciliá-las, você terá que fazer isso manualmente.

Este método funciona para entregas ocasionais e únicas. Ele falha rapidamente quando a coleção está mudando ativamente.

Método 2: Use um espaço de trabalho público

O Postman permite criar espaços de trabalho públicos no plano gratuito. Qualquer pessoa com o link pode visualizar e fazer um "fork" da coleção.

Como configurar:

1. Crie um novo espaço de trabalho no Postman.
2. Quando solicitado a escolher a visibilidade, selecione "Público".
3. Adicione sua coleção ao espaço de trabalho público.
4. Compartilhe o URL do espaço de trabalho com seus colegas de equipe.

Seus colegas de equipe podem fazer um "fork" da coleção para seu próprio espaço de trabalho e trabalhar a partir daí.

O que falha:

Público significa público. Qualquer pessoa na internet pode encontrar e visualizar sua coleção se tiver o URL ou pesquisar na rede de API pública do Postman. Para ferramentas internas, ambientes de homologação ou qualquer coisa com tokens de autenticação inseridos em respostas de exemplo, isso é um risco significativo.

Coleções "forkadas" não permanecem sincronizadas automaticamente. Se você atualizar o original, os colegas de equipe precisam puxar manualmente as alterações para o "fork" deles. Não há notificação de que uma mudança ocorreu.

Comentários e colaboração direta ainda exigem o plano Team. Espaços de trabalho públicos são somente leitura para visualizadores; eles não podem editar o original.

Este método funciona bem para projetos de código aberto ou documentação de API pública. Não é adequado para fluxos de trabalho de equipes internas.

Método 3: Use um repositório Git como camada de sincronização

Algumas equipes resolvem o problema de sincronização tratando o JSON exportado como um artefato de código e o commitando em um repositório Git.

O fluxo de trabalho se parece com isto:

1. Uma pessoa é proprietária da coleção do Postman e a exporta após cada alteração significativa.
2. Eles fazem o commit do JSON atualizado para um repositório Git compartilhado (GitHub, GitLab, Bitbucket).
3. Os colegas de equipe puxam a versão mais recente e a importam para o Postman local deles.

O que falha:

Cada importação sobrescreve a coleção local existente. Se um colega de equipe fez alterações locais, essas alterações desaparecem a menos que ele tenha exportado e mesclado primeiro.

O fluxo de trabalho exige disciplina. Alguém precisa se lembrar de exportar e fazer o commit sempre que algo muda. Na prática, a versão do Git quase sempre fica atrasada em relação ao estado real do Postman.

Você não pode executar requisições diretamente de um repositório Git. Alguém sempre precisa fazer a etapa de importação, o que leva tempo e cria atrito.

Este método é melhor do que o compartilhamento de arquivos brutos porque oferece um histórico e uma única fonte de verdade, mas as etapas manuais adicionam uma sobrecarga que desacelera as equipes.

Método 4: Use o espaço de trabalho pessoal gratuito do Postman com uma conta “primária”

Algumas pequenas equipes contornam o limite de colaboração fazendo com que todos compartilhem uma única conta do Postman. Uma pessoa faz login em várias máquinas usando as mesmas credenciais.

Isso é contra os Termos de Serviço do Postman e cria problemas reais:

• O Postman pode detectar credenciais compartilhadas e bloquear a conta.
• Alterações feitas por uma pessoa podem sobrescrever as feitas por outra se ocorrerem conflitos de sincronização.
• Não há como atribuir alterações a pessoas específicas.

Este método é mencionado aqui porque as equipes o utilizam, não porque seja uma boa ideia.

Como o Apidog lida com o compartilhamento no nível gratuito

O Apidog adota uma abordagem diferente para o problema de colaboração. O plano gratuito inclui até 3 membros da equipe em um espaço de trabalho compartilhado, com sincronização em tempo real entre todos eles. Sem soluções alternativas, sem embaralhar arquivos JSON.

Quando você faz uma alteração em uma definição de API no Apidog, seus colegas de equipe a veem imediatamente. Todos vocês estão trabalhando a partir da mesma fonte de verdade, sem que ninguém precise exportar ou importar nada.

Se você já usa o Postman, pode importar suas coleções existentes diretamente. O Apidog lê o formato Postman Collection v2.1, então a mudança é um clique, não um projeto de fim de semana.

O plano gratuito também inclui:

• Editor completo de design de API (OpenAPI 3.0 e Swagger)
• Mock Inteligente para gerar respostas realistas sem dependência de nuvem
• Um test runner sem limites de execução mensais
• Documentação de API gerada automaticamente a partir de suas definições
• Armazenamento local-first, para que seus dados permaneçam em sua máquina, a menos que você escolha sincronizar

Para uma equipe de 2-3 pessoas, o plano gratuito do Apidog cobre o mesmo terreno que o plano Team do Postman, sem custo.

Escolhendo o método certo para sua situação

Aqui está um guia rápido de decisão:

Se sua equipe está construindo APIs ativamente e você está atingindo os limites de compartilhamento do Postman, as soluções alternativas de JSON e Git irão atrasá-lo. Elas resolvem o problema imediato, mas adicionam atrito contínuo.

FAQ

Posso compartilhar uma coleção do Postman sem uma conta?Sim. Exporte a coleção como um arquivo JSON e envie o arquivo diretamente. O destinatário pode importá-la sem uma conta Postman se estiver usando um cliente de API que suporte o formato Postman Collection v2.1, incluindo o Apidog.

O plano Básico do Postman permite compartilhamento em equipe?Sim. O plano Básico a US$ 19/usuário/mês permite a colaboração em espaço de trabalho privado com múltiplos usuários. O plano gratuito não.

O que é um espaço de trabalho público do Postman?Um espaço de trabalho público é visível para qualquer pessoa na internet. Visitantes podem visualizar e fazer "fork" de coleções, mas não podem editar os originais. É gratuito criar até 3 espaços de trabalho públicos no plano gratuito.

Minhas variáveis de ambiente serão exportadas com minha coleção?Não. As variáveis de ambiente são exportadas separadamente. Vá para Ambientes na barra lateral, clique no menu de três pontos no ambiente que você precisa e exporte-o como um arquivo JSON separado. Compartilhe ambos os arquivos com seu colega de equipe.

Quantos usuários podem compartilhar um espaço de trabalho no plano gratuito do Apidog?O plano gratuito do Apidog suporta até 3 usuários em um espaço de trabalho compartilhado com sincronização em tempo real, sem necessidade de cartão de crédito.

Posso importar minhas coleções existentes do Postman para o Apidog?Sim. O Apidog suporta a importação direta de arquivos JSON do Postman Collection v2.1. Vá para Importar no Apidog, selecione seu arquivo, e sua coleção será importada com requisições, cabeçalhos e variáveis de ambiente intactas.

As limitações de compartilhamento no nível gratuito do Postman são reais, e as soluções alternativas têm custos reais em tempo e confiabilidade. Para equipes de até 3 pessoas que precisam de colaboração real, mudar para uma ferramenta feita para compartilhamento de nível gratuito é frequentemente mais limpo do que remendar um fluxo de trabalho que exige esforço manual constante.