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 formas que surpreendem muitas equipes pequenas. Se você precisa colaborar sem pagar US$ 19/usuário/mês, há alternativas como exportar JSON, usar workspace público ou sincronizar via Git, mas todas têm custos operacionais. O plano gratuito do Apidog permite compartilhar um workspace com até 3 usuários, sem upgrade.

Experimente o Apidog hoje

💡 Apidog é uma plataforma gratuita e completa para desenvolvimento de APIs. Ela cobre design, testes, mocking e documentação em uma única ferramenta, com colaboração integrada no plano gratuito.

Introdução

O Postman começou como uma extensão do Chrome para enviar requisições HTTP. Com o tempo, virou uma plataforma de API completa — e o modelo de preços também evoluiu.

O problema aparece quando uma equipe pequena precisa apenas compartilhar coleções e trabalhar em conjunto. No plano gratuito, não é possível convidar colegas para editar um workspace privado. Para isso, é necessário ir para um plano pago.

Se você está em uma startup, projeto paralelo ou time enxuto, pagar US$ 19 por usuário/mês apenas para compartilhar uma coleção pode ser difícil de justificar.

Este guia mostra, na prática:

• o que o plano gratuito do Postman permite;
• como compartilhar coleções sem pagar;
• onde cada alternativa falha;
• quando faz sentido usar uma ferramenta como o Apidog.

O que o plano gratuito do Postman permite

Antes de escolher uma solução alternativa, entenda os limites principais do plano gratuito do Postman em 2024-2025.

Ele inclui:

• 1 usuário por workspace;
• espaços de trabalho pessoais ilimitados;
• até 3 workspaces públicos ativos;
• 1.000 chamadas de mock server por mês;
• 1.000 chamadas de monitoramento por mês;
• 25 execuções de collection runner na nuvem por mês.

A limitação crítica é esta:

No plano gratuito, você não pode convidar outros usuários para colaborar em um workspace privado.

Para colaboração privada com múltiplos usuários, é necessário pelo menos o plano Básico, que custa US$ 19/usuário/mês.

Método 1: exportar a coleção como JSON

A forma mais simples de compartilhar uma coleção no Postman é exportá-la como JSON e enviar o arquivo para outra pessoa.

Como fazer

1. Abra o Postman.
2. Na barra lateral, localize a coleção.
3. Clique no menu de três pontos ao lado do nome da coleção.
4. Selecione Exportar.
5. Escolha o formato Collection v2.1.
6. Salve o arquivo .json.
7. Envie o arquivo por e-mail, Slack, Google Drive ou outro canal.

Quem receber o arquivo pode importar assim:

1. Abra o Postman.
2. Vá em File > Import.
3. Arraste o arquivo JSON.
4. Confirme a importação.

Exemplo de fluxo

developer-a/
  postman/
    minha-api.postman_collection.json

Depois de exportar, envie o arquivo:

minha-api.postman_collection.json

O outro desenvolvedor importa esse arquivo e passa a ter uma cópia local da coleção.

Onde esse método falha

Esse método cria um snapshot da coleção.

Se você adicionar um endpoint novo depois da exportação, a outra pessoa não recebe essa atualização automaticamente.

Também há outros problemas:

• variáveis de ambiente não são exportadas junto com a coleção por padrão;
• ambientes precisam ser exportados separadamente;
• não há merge automático;
• duas pessoas podem editar cópias diferentes e gerar conflito manual;
• a coleção importada pode ficar desatualizada rapidamente.

Use este método apenas para entregas pontuais ou coleções que mudam pouco.

Método 2: usar um workspace público

O Postman permite criar workspaces públicos no plano gratuito. Qualquer pessoa com acesso ao link pode visualizar e fazer fork da coleção.

Como configurar

1. Crie um novo workspace no Postman.
2. Na configuração de visibilidade, selecione Public.
3. Adicione a coleção ao workspace.
4. Copie a URL do workspace.
5. Compartilhe o link com sua equipe.

Os colegas podem fazer fork da coleção para seus próprios workspaces.

Onde esse método falha

O ponto principal é simples:

Público significa público.

Qualquer pessoa na internet pode visualizar o workspace se tiver o link ou encontrá-lo na rede pública de APIs do Postman.

Isso não é adequado para:

• APIs internas;
• ambientes de staging;
• endpoints privados;
• exemplos com tokens;
• headers de autenticação;
• dados sensíveis em payloads de exemplo.

Além disso:

• forks não ficam sincronizados automaticamente;
• mudanças no original precisam ser puxadas manualmente;
• visualizadores não editam a coleção original;
• colaboração direta ainda exige plano pago.

Esse método é adequado para APIs públicas, documentação aberta ou projetos open source. Para times internos, normalmente não é a melhor opção.

Método 3: sincronizar o JSON via Git

Outra alternativa é tratar a coleção exportada como um artefato de código e versioná-la em um repositório Git.

Fluxo de trabalho

1. Uma pessoa mantém a coleção principal no Postman.
2. Sempre que muda algo relevante, ela exporta o JSON.
3. O arquivo exportado é commitado no repositório.
4. O restante da equipe faz pull.
5. Cada pessoa importa a versão mais recente no Postman.

Exemplo:

git pull origin main

Depois, no Postman:

File > Import > minha-api.postman_collection.json

Estrutura sugerida

repo/
  docs/
  postman/
    minha-api.postman_collection.json
    staging.postman_environment.json
    production.postman_environment.json

Exemplo de commit

git add postman/minha-api.postman_collection.json
git commit -m "Atualiza coleção Postman com endpoints de usuários"
git push origin main

Onde esse método falha

Esse fluxo melhora o versionamento, mas não resolve a colaboração em tempo real.

Problemas comuns:

• alguém esquece de exportar depois de alterar a coleção;
• o JSON no Git fica defasado;
• importar uma nova versão pode sobrescrever alterações locais;
• merges em JSON de coleção podem ser difíceis de revisar;
• ainda é necessário importar manualmente no Postman;
• não dá para executar requisições diretamente do repositório.

Esse método funciona melhor quando a equipe já usa Git como fonte da verdade e aceita o custo operacional de exportar/importar.

Método 4: compartilhar uma única conta do Postman

Algumas equipes pequenas tentam contornar o limite usando uma única conta “principal” do Postman em várias máquinas.

Na prática, todos entram com o mesmo login e editam o mesmo workspace pessoal.

Isso não é recomendado.

Problemas:

• pode violar os Termos de Serviço do Postman;
• alterações simultâneas podem gerar conflitos;
• não há rastreabilidade por usuário;
• não dá para saber quem alterou o quê;
• a conta pode ser bloqueada se o uso compartilhado for detectado.

Esse método é citado porque acontece na prática, mas não deve ser usado como solução de equipe.

Como o Apidog lida com colaboração no plano gratuito

O Apidog resolve esse problema de forma diferente: o plano gratuito permite até 3 membros em um workspace compartilhado, com sincronização entre os usuários.

Na prática, isso remove as etapas manuais de:

• exportar JSON;
• enviar arquivo;
• importar coleção;
• sincronizar forks;
• atualizar repositório manualmente.

Quando alguém altera uma definição de API no Apidog, os demais membros trabalham a partir da mesma fonte de verdade.

Importando uma coleção do Postman para o Apidog

Se você já tem coleções no Postman, o fluxo é direto:

1. No Postman, exporte a coleção no formato Collection v2.1.
2. Abra o Apidog.
3. Vá em Importar.
4. Selecione o arquivo JSON exportado.
5. Confirme a importação.

O Apidog suporta importação de arquivos Postman Collection v2.1, incluindo requisições, headers e variáveis de ambiente.

O que o plano gratuito do Apidog inclui

O plano gratuito também inclui:

• editor de design de API com suporte a OpenAPI 3.0 e Swagger;
• Mock Inteligente;
• test runner sem limite mensal de execuções;
• documentação de API gerada automaticamente;
• armazenamento local-first;
• colaboração em workspace para até 3 usuários.

Para equipes de 2 ou 3 pessoas, isso cobre o cenário em que o Postman exige um plano pago para colaboração privada.

Comparação rápida dos métodos

Situação	Melhor abordagem
Entrega única, coleção estável	Exportar JSON e compartilhar o arquivo
API pública ou projeto open source	Workspace público do Postman
Equipe pequena com desenvolvimento ativo	Plano gratuito do Apidog
Equipe que já usa Git como fonte da verdade	Git + exportação manual de JSON

Checklist para escolher a abordagem

Use este checklist:

A coleção muda com frequência?
  Sim -> Evite exportação manual.
  Não -> Exportar JSON pode ser suficiente.

A API contém dados internos ou sensíveis?
  Sim -> Evite workspace público.
  Não -> Workspace público pode funcionar.

A equipe precisa editar a mesma coleção?
  Sim -> Use colaboração real em workspace.
  Não -> Fork ou JSON podem resolver.

A equipe tem até 3 pessoas?
  Sim -> O plano gratuito do Apidog pode ser suficiente.

FAQ

Posso compartilhar uma coleção do Postman sem uma conta?

Sim. Exporte a coleção como arquivo JSON e envie diretamente para outra pessoa.

O destinatário pode importá-la em um cliente de API que suporte o formato Postman Collection v2.1, incluindo o Apidog.

O plano Básico do Postman permite colaboração em equipe?

Sim. O plano Básico, a US$ 19/usuário/mês, permite colaboração em workspace privado com múltiplos usuários.

O plano gratuito não permite esse tipo de colaboração privada.

O que é um workspace público do Postman?

É um workspace visível publicamente na internet.

Visitantes podem visualizar e fazer fork de coleções, mas não podem editar os originais.

No plano gratuito, é possível criar até 3 workspaces públicos ativos.

As variáveis de ambiente são exportadas com a coleção?

Não.

As variáveis de ambiente precisam ser exportadas separadamente.

Fluxo:

1. Vá em Environments.
2. Clique no menu de três pontos do ambiente.
3. Selecione Export.
4. Compartilhe o JSON do ambiente junto com o JSON da coleção.

Quantos usuários podem compartilhar um workspace no plano gratuito do Apidog?

O plano gratuito do Apidog suporta até 3 usuários em um workspace compartilhado, com sincronização entre eles.

Posso importar coleções existentes do Postman para o Apidog?

Sim. O Apidog suporta importação direta de arquivos JSON no formato Postman Collection v2.1.

Você pode importar coleções com requisições, headers e variáveis de ambiente.

Conclusão

As limitações de compartilhamento do plano gratuito do Postman são reais. As alternativas funcionam, mas têm custo operacional:

• exportar JSON gera cópias desatualizadas;
• workspace público expõe dados;
• Git exige disciplina manual;
• conta compartilhada não é uma boa prática.

Se sua equipe tem até 3 pessoas e precisa colaborar em APIs de forma privada, usar uma ferramenta com colaboração incluída no plano gratuito tende a ser mais simples do que manter um fluxo baseado em exportações manuais.