Restrictions du Postman Collection Runner : Nouveautés et comment les contourner

En bref

Postman a restreint l'accès au Collection Runner sur son offre gratuite, interrompant l'exécution automatisée des tests pour les équipes qui n'avaient pas mis à niveau leur compte. Cela affecte les exécutions de tests locaux, les pipelines CI/CD, et tout flux de travail utilisant le Runner pour l'exécution de requêtes en masse. Cet article explique ce qui a changé, ce que cela perturbe en pratique, et comment le runner d'Apidog fonctionne sans restrictions sur tous les plans.

Introduction

Le Collection Runner de Postman était l'une de ses fonctionnalités les plus utilisées. Vous construisiez une collection de 50 requêtes API, cliquiez sur "Exécuter la collection", et regardiez Postman les exécuter séquentiellement, avec le passage de variables entre les requêtes, des assertions de test sur chaque réponse, et un rapport récapitulatif à la fin. Pour les développeurs testant des flux complexes en plusieurs étapes, c'était essentiel.

Puis sont venues les restrictions de 2026. Dans le cadre de la réduction de l'offre gratuite, Postman a limité l'accès au Collection Runner. Les comptes gratuits ne peuvent plus exécuter de collections au-delà d'un certain nombre de requêtes par mois, et certaines fonctionnalités du Runner sont désormais entièrement payantes.

L'impact s'est rapidement fait sentir dans les flux de travail des développeurs. Les équipes ayant des pipelines CI basés sur Newman (le CLI runner de Postman) ont commencé à atteindre des limites. Les développeurs exécutant des tests de non-régression avant le déploiement dans le Collection Runner ont constaté que la fonctionnalité était grisée ou ralentie.

Ce que Postman a changé dans le Collection Runner

L'offre gratuite de Postman restreint désormais le Collection Runner de deux manières principales :

Limites d'exécution mensuelles. Les comptes gratuits ont un plafond sur le nombre d'exécutions du Collection Runner qu'ils peuvent effectuer par mois. Postman n'a pas publié le nombre exact clairement, mais des rapports de la communauté l'estiment à environ 25 exécutions par mois. Pour les développeurs exécutant des tests plusieurs fois par jour, cette limite est atteinte en quelques jours.

Restrictions de Newman CLI. Newman, l'outil CLI open-source qui permet d'exécuter des collections Postman en terminal et dans des environnements CI, fonctionnait auparavant avec n'importe quelle exportation de collection Postman sans atteindre les limites du plan. Après 2026, certaines fonctionnalités de Newman sont liées au niveau de votre plan de compte Postman lorsque vous utilisez des collections synchronisées avec le cloud.

Exécution de tests sans code. Le Collection Runner visuel, accessible depuis la barre latérale, affiche un statut "paywall" sur les comptes gratuits une fois la limite d'exécution atteinte.

Ce qui n'est pas restreint : l'exécution individuelle de requêtes manuellement (cliquer sur "Envoyer" sur une seule requête) reste illimitée. Les restrictions ciblent spécifiquement l'exécution automatisée par lots.

Ce qui ne fonctionne plus en pratique

Tests de non-régression avant le commit et avant le déploiement

De nombreuses équipes exécutent un passage du Collection Runner avant de fusionner une pull request ou de déployer en staging. Si vous aviez 30 requêtes dans votre collection de tests de non-régression, une équipe de trois développeurs l'exécutant chacun deux fois par jour épuiserait la limite mensuelle gratuite de Postman en environ deux jours.

Pipelines CI/CD

Les pipelines CI basés sur Newman sont les plus touchés. Un flux de travail GitHub Actions comme celui-ci :

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

Commencera à échouer ou à rencontrer des erreurs de débit une fois la limite du compte atteinte. Cela est particulièrement préjudiciable pour les équipes ayant plusieurs pipelines se déclenchant à chaque push.

Suites de tests de bout en bout

Certaines équipes ont construit des flux de travail API en plusieurs étapes dans Postman qui enchaînent les requêtes, transmettant la sortie d'une requête (comme un jeton d'authentification) à la suivante. Le Collection Runner gère cela via le modèle pm.environment.set(). Avec le Runner restreint, ces flux de travail ne peuvent être testés qu'en parcourant manuellement les requêtes une par une.

Tests de charge et de performance

Le Collection Runner de Postman a des options "délai" et "itérations" qui vous permettent d'exécuter une collection plusieurs fois en séquence, utile pour des tests de charge basiques. Avec les limites d'exécution en place, ce cas d'utilisation est effectivement disparu sur l'offre gratuite.

Solutions de contournement immédiates au sein de Postman

Si vous n'êtes pas encore prêt à changer d'outil, quelques solutions de contournement existent au sein de l'écosystème Postman.

Exporter vers Newman et exécuter localement. Newman s'exécute sur un fichier JSON de collection exporté localement sans nécessiter de connexion à un compte Postman, tant que vous n'utilisez pas de fonctionnalités qui appellent un service externe. Exportez votre collection et votre environnement, puis exécutez Newman complètement hors ligne :

newman run collection.json -e environment.json

Ceci contourne la limite d'exécution du compte Postman car Newman lit un fichier local. La limitation est que vous perdez la synchronisation avec votre espace de travail Postman en direct, vous devez donc réexporter chaque fois que la collection change.

Diviser les grandes collections en morceaux plus petits. Si vous êtes proche de la limite mensuelle, diviser une collection de 100 requêtes en quatre collections de 25 requêtes signifie que chacune utilise un compteur d'exécution séparé. C'est une solution de contournement, pas une solution, et cela rompt le flux logique des tests en plusieurs étapes.

Mettre à niveau de manière sélective. Si un seul membre de l'équipe exécute le pipeline CI, avoir ce compte sur un plan payant tandis que les autres restent gratuits est moins cher que de mettre à niveau tout le monde. Le compte payant exécute Newman sans limites ; les autres utilisent les tests manuels.

Comment le Collection Runner d'Apidog fonctionne différemment

Le runner d'Apidog, appelé "Scénarios de test" ou accessible via le bouton "Exécuter" sur n'importe quelle collection, n'a aucune limite d'exécution mensuelle sur aucun plan. Cela inclut l'offre gratuite.

Voici comment il se compare à ce que Postman a restreint :

Le runner CLI d'Apidog (apidog-cli) s'intègre à CI/CD de la même manière que Newman. La structure des commandes est similaire :

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

Vous pouvez également exporter une collection d'Apidog et l'exécuter hors ligne, de manière similaire à l'approche de Newman avec un fichier local, mais sans avoir à vous soucier des restrictions basées sur le compte.

Mise en place du runner Apidog dans votre pipeline CI

Si vous migrez un pipeline basé sur Newman vers Apidog, voici à quoi ressemble la transition dans GitHub Actions.

Avant (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

Après (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 }}

Les principales différences sont le mécanisme d'authentification (Apidog utilise un jeton d'accès plutôt qu'une clé API Postman) et la référence basée sur le projet au lieu d'un chemin de fichier local. Les deux prennent en charge la sortie JSON pour la création de rapports de résultats de test.

Alternativement, si vous préférez continuer à utiliser l'interface familière de Newman, vous pouvez exporter une collection Apidog au format JSON compatible avec Postman et continuer à exécuter Newman dessus. Cela vous donne l'approche hors ligne, sans compte requis, tout en travaillant avec Apidog au quotidien.

Fonctionnalités avancées du runner dans Apidog

Au-delà de l'égalisation des fonctionnalités restreintes de Postman, le runner d'Apidog ajoute quelques capacités à connaître.

Tests basés sur les données. Importez un fichier CSV ou JSON dans une exécution de test pour exécuter la même collection avec différents ensembles de données. Chaque ligne devient une itération. Ceci est équivalent à la fonction de fichier de données de Postman, qui est également payante dans les niveaux Postman supérieurs.

Nombre d'itérations personnalisées. Définissez un nombre spécifique d'itérations pour une exécution de test sans vous soucier d'un compteur mensuel. Exécutez votre collection 500 fois pour un test de stress de base si nécessaire.

Intégration Smart Mock. Pendant que le runner s'exécute, il peut interagir avec le serveur de maquette intégré d'Apidog. Cela signifie que vous pouvez exécuter des tests sur des points de terminaison maquettés sans démarrer un serveur séparé, utile lors du test du code client contre une API qui n'est pas encore construite.

Exécutions planifiées. Configurez des exécutions de tests automatiques selon un calendrier (horaire, quotidien, etc.) directement dans Apidog sans avoir besoin de tâches cron externes ou de déclencheurs CI. Les résultats apparaissent dans l'historique des tests de votre projet.

Les restrictions du Collection Runner de Postman constituent un obstacle pratique pour les équipes qui ont construit des pipelines CI et des flux de travail de tests automatisés sur l'offre gratuite. La voie la plus directe est de passer à un runner sans limites d'utilisation. Le runner d'Apidog couvre tous les cas d'utilisation que l'offre gratuite de Postman a restreints, et l'intégration CLI fonctionne dans les configurations de pipeline existantes avec une petite modification de configuration.