Restrições do Postman Collection Runner: O que Mudou e Como Contornar

TL;DR

O Postman restringiu o acesso ao Collection Runner em seu plano gratuito, quebrando a execução automatizada de testes para equipes que não fizeram upgrade. Isso afeta execuções de testes locais, pipelines de CI/CD e qualquer fluxo de trabalho que usava o Runner para execução em massa de requisições. Este artigo explica o que mudou, o que isso quebra na prática e como o runner do Apidog funciona sem restrições em qualquer plano.

Introdução

O Collection Runner do Postman era uma de suas funcionalidades mais usadas. Você criava uma coleção de 50 requisições de API, clicava em "Run Collection" (Executar Coleção) e observava o Postman executá-las em sequência, com passagem de variáveis entre as requisições, asserções de teste em cada resposta e um relatório de resumo no final. Para desenvolvedores testando fluxos multi-etapas complexos, era essencial.

Então vieram as restrições de 2026. Como parte da redução do plano gratuito, o Postman limitou o acesso ao Collection Runner. Contas gratuitas não podem mais executar coleções além de um certo número de requisições por mês, e algumas funcionalidades do Runner agora estão totalmente bloqueadas por paywall.

O impacto apareceu rapidamente nos fluxos de trabalho dos desenvolvedores. Equipes que tinham pipelines de CI dependendo do Newman (o CLI runner do Postman) começaram a atingir os limites. Desenvolvedores executando testes de fumaça pré-implantação no Collection Runner encontraram a funcionalidade acinzentada ou com limites.

O que o Postman mudou no Collection Runner

O plano gratuito do Postman agora restringe o Collection Runner de duas maneiras principais:

Limites de execução mensais. Contas gratuitas têm um limite de quantas execuções do Collection Runner podem realizar por mês. O Postman não publicou o número exato claramente, mas relatórios da comunidade o estimam em cerca de 25 execuções por mês. Para desenvolvedores que executam testes várias vezes ao dia, esse limite é atingido em poucos dias.

Restrições do Newman CLI. O Newman, a ferramenta CLI de código aberto que permite executar coleções do Postman no terminal e em ambientes de CI, anteriormente funcionava com qualquer exportação de coleção do Postman sem atingir limites de plano. Após 2026, algumas funcionalidades do Newman se conectam ao plano da sua conta Postman ao usar coleções sincronizadas na nuvem.

Execução de testes sem código. O Collection Runner visual, acessível na barra lateral, mostra um estado de paywall em contas gratuitas depois que o limite de execuções é atingido.

O que não é restrito: executar requisições individuais manualmente (clicando em "Send" (Enviar) em uma única requisição) permanece ilimitado. As restrições visam especificamente a execução automatizada em lote.

O que quebra na prática

Testes de fumaça pré-commit e pré-implantação

Muitas equipes executam uma passagem do Collection Runner antes de mesclar um PR ou implantar em staging. Se você tinha 30 requisições em sua coleção de testes de fumaça, uma equipe de três desenvolvedores, cada um executando-a duas vezes ao dia, esgotaria o limite mensal gratuito do Postman em cerca de dois dias.

Pipelines de CI/CD

Pipelines de CI baseados em Newman são os mais afetados. Um fluxo de trabalho do GitHub Actions como este:

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json

Começará a falhar ou a atingir erros de taxa quando o limite da conta for atingido. Isso é especialmente prejudicial para equipes com múltiplos pipelines acionando a cada push.

Suítes de teste ponta a ponta

Algumas equipes construíram fluxos de trabalho de API multi-etapas no Postman que encadeiam requisições, passando a saída de uma requisição (como um token de autenticação) para a próxima. O Collection Runner lida com isso através do padrão pm.environment.set(). Com o Runner restrito, esses fluxos de trabalho só podem ser testados percorrendo manualmente as requisições, uma de cada vez.

Testes de carga e desempenho

O Collection Runner do Postman tem uma opção de "delay" (atraso) e "iterations" (iterações) que permite executar uma coleção várias vezes em sequência, útil para testes básicos de carga. Com os limites de execução em vigor, este caso de uso está efetivamente desaparecido no plano gratuito.

Soluções imediatas dentro do Postman

Se você ainda não está pronto para trocar de ferramenta, algumas soluções alternativas existem dentro do ecossistema Postman.

Exportar para Newman e executar localmente. O Newman executa uma coleção exportada localmente em um arquivo JSON sem exigir um login de conta Postman, desde que você não use funcionalidades que "telefonam para casa". Exporte sua coleção e ambiente, depois execute o Newman completamente offline:

newman run collection.json -e environment.json

Isso ignora o limite de execução da conta Postman porque o Newman está lendo um arquivo local. A limitação é que você perde a sincronização com seu espaço de trabalho Postman ativo, então você precisa reexportar toda vez que a coleção muda.

Dividir coleções grandes em partes menores. Se você está perto do limite mensal, dividir uma coleção de 100 requisições em quatro coleções de 25 requisições significa que cada uma usa um contador de execução separado. Esta é uma solução alternativa, não uma solução, e quebra o fluxo lógico de testes multi-etapas.

Atualizar seletivamente. Se apenas um membro da equipe executa o pipeline de CI, ter essa única conta em um plano pago enquanto os outros permanecem gratuitos é mais barato do que atualizar todo mundo. A conta paga executa o Newman sem limites; os outros usam testes manuais.

Como o Collection Runner do Apidog funciona de forma diferente

O runner do Apidog, chamado "Test Scenarios" (Cenários de Teste) ou acessível através do botão "Run" (Executar) em qualquer coleção, não tem limites de execução mensais em nenhum plano. Isso inclui o plano gratuito.

Aqui está como ele se compara ao que o Postman restringiu:

O runner CLI do Apidog (apidog-cli) integra-se com CI/CD da mesma forma que o Newman. A estrutura de comando é semelhante:

apidog run {project-id} --collection {collection-id} --environment {env-id}

Você também pode exportar uma coleção do Apidog e executá-la offline, semelhante à abordagem de arquivo local do Newman, mas sem precisar se preocupar com restrições baseadas em conta.

Configurando o runner do Apidog em seu pipeline de CI

Se você está migrando um pipeline baseado em Newman para o Apidog, veja como é a transição no GitHub Actions.

Antes (Newman):

- name: Install Newman
  run: npm install -g newman

- name: Run API tests
  run: newman run ./collections/api-tests.json -e ./environments/staging.json --reporters cli,json --reporter-json-export results.json

Depois (Apidog CLI):

- name: Install Apidog CLI
  run: npm install -g apidog-cli

- name: Run API tests
  run: apidog run --project {project-id} --env {env-id} --output results.json
  env:
    APIDOG_ACCESS_TOKEN: ${{ secrets.APIDOG_ACCESS_TOKEN }}

As principais diferenças são o mecanismo de autenticação (Apidog usa um token de acesso em vez de uma chave de API do Postman) e a referência baseada em projeto em vez de um caminho de arquivo local. Ambos suportam saída JSON para relatórios de resultados de testes.

Alternativamente, se você preferir continuar usando a interface familiar do Newman, pode exportar uma coleção do Apidog como um JSON compatível com Postman e continuar executando o Newman contra ela. Isso oferece a abordagem offline, sem necessidade de conta, enquanto trabalha com o Apidog no dia a dia.

Funcionalidades avançadas do runner no Apidog

Além de igualar o conjunto de funcionalidades restritas do Postman, o runner do Apidog adiciona algumas capacidades que valem a pena conhecer.

Teste orientado a dados. Importe um arquivo CSV ou JSON para uma execução de teste para executar a mesma coleção com diferentes conjuntos de dados. Cada linha se torna uma iteração. Isso é equivalente ao recurso de arquivo de dados do Postman, que também é restrito a planos pagos em níveis mais altos do Postman.

Contagens de iteração personalizadas. Defina um número específico de iterações para uma execução de teste sem se preocupar com um contador mensal. Execute sua coleção 500 vezes para um teste de estresse básico, se necessário.

Integração Smart Mock. Enquanto o runner está executando, ele pode interagir com o servidor de mock integrado do Apidog. Isso significa que você pode executar testes contra endpoints mockados sem precisar iniciar um servidor separado, útil ao testar código cliente contra uma API que ainda não foi construída.

Execuções agendadas. Configure execuções de teste automáticas em um cronograma (de hora em hora, diariamente, etc.) diretamente no Apidog sem a necessidade de cron jobs externos ou gatilhos de CI. Os resultados aparecem no histórico de testes do seu projeto.

As restrições do Collection Runner do Postman são um bloqueador prático para equipes que construíram pipelines de CI e fluxos de trabalho de testes automatizados no plano gratuito. O caminho mais direto a seguir é mudar para um runner sem limites de uso. O runner do Apidog cobre todos os casos de uso que o plano gratuito do Postman restringiu, e a integração CLI funciona em configurações de pipeline existentes com uma pequena mudança de configuração.