Postman Collection Runner Einschränkungen: Was sich geändert hat und wie man sie umgeht

TL;DR

Postman hat den Zugriff auf den Collection Runner in seinem kostenlosen Tarif eingeschränkt, wodurch die automatisierte Testausführung für Teams, die kein Upgrade durchgeführt haben, unterbrochen wurde. Dies betrifft lokale Testläufe, CI/CD-Pipelines und jeden Workflow, der den Runner für die Massenausführung von Anfragen nutzte. Dieser Artikel erklärt, was sich geändert hat, was in der Praxis dadurch beeinträchtigt wird und wie Apidogs Runner ohne Einschränkungen in jedem Tarif funktioniert.

Einleitung

Postmans Collection Runner war eine seiner meistgenutzten Funktionen. Man konnte eine Sammlung von 50 API-Anfragen erstellen, auf „Collection ausführen“ klicken und Postman dabei zusehen, wie es diese der Reihe nach ausführt, mit Variablenübergabe zwischen den Anfragen, Test-Assertions für jede Antwort und einem zusammenfassenden Bericht am Ende. Für Entwickler, die komplexe mehrstufige Abläufe testeten, war dies unerlässlich.

Dann kamen die Einschränkungen von 2026. Im Rahmen der Reduzierung des kostenlosen Tarifs hat Postman den Zugriff auf den Collection Runner eingeschränkt. Kostenlose Konten können Sammlungen nicht mehr über eine bestimmte Anzahl von Anfragen pro Monat hinaus ausführen, und einige Runner-Funktionen sind jetzt komplett kostenpflichtig.

Die Auswirkungen zeigten sich schnell in den Entwickler-Workflows. Teams, deren CI-Pipelines auf Newman (Postmans CLI-Runner) basierten, stießen an Grenzen. Entwickler, die Pre-Deployment-Smoke-Tests im Collection Runner durchführten, fanden die Funktion ausgegraut oder gedrosselt vor.

Was Postman am Collection Runner geändert hat

Postmans kostenloser Tarif schränkt den Collection Runner nun auf zwei Hauptarten ein:

Monatliche Ausführungslimits. Kostenlose Konten haben eine Obergrenze dafür, wie viele Collection Runner-Ausführungen sie pro Monat durchführen können. Postman hat die genaue Zahl nicht klar veröffentlicht, aber Community-Berichte beziffern sie auf etwa 25 Läufe pro Monat. Für Entwickler, die Tests mehrmals täglich durchführen, wird dieses Limit innerhalb weniger Tage erreicht.

Newman CLI-Einschränkungen. Newman, das Open-Source-CLI-Tool, mit dem Sie Postman-Sammlungen in Terminal- und CI-Umgebungen ausführen können, funktionierte zuvor mit jedem Postman-Sammlungsexport, ohne Tarifgrenzen zu erreichen. Nach 2026 sind einige Newman-Funktionen an den Tarif Ihres Postman-Kontos gebunden, wenn Cloud-synchronisierte Sammlungen verwendet werden.

No-Code-Testausführung. Der visuelle Collection Runner, der über die Seitenleiste zugänglich ist, zeigt bei kostenlosen Konten nach Erreichen des Ausführungslimits einen kostenpflichtigen Zustand an.

Was nicht eingeschränkt ist: Das manuelle Ausführen einzelner Anfragen (Klicken auf „Senden“ bei einer einzelnen Anfrage) bleibt unbegrenzt. Die Einschränkungen zielen speziell auf die automatisierte Batch-Ausführung ab.

Was in der Praxis nicht mehr funktioniert

Pre-Commit- und Pre-Deployment-Smoke-Tests

Viele Teams führen einen Collection Runner-Durchlauf durch, bevor sie einen PR zusammenführen oder auf Staging deployen. Hätten Sie 30 Anfragen in Ihrer Smoke-Test-Sammlung, würde ein Team von drei Entwicklern, die diese jeweils zweimal täglich ausführen, Postmans kostenloses Monatslimit in etwa zwei Tagen ausschöpfen.

CI/CD-Pipelines

Newman-basierte CI-Pipelines sind am stärksten betroffen. Ein GitHub Actions-Workflow wie dieser:

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

Wird fehlschlagen oder Ratenfehler verursachen, sobald das Kontolimit erreicht ist. Dies ist besonders schädlich für Teams mit mehreren Pipelines, die bei jedem Push ausgelöst werden.

End-to-End-Testsuiten

Einige Teams haben mehrstufige API-Workflows in Postman erstellt, die Anfragen miteinander verketten und die Ausgabe einer Anfrage (z.B. ein Auth-Token) an die nächste weitergeben. Der Collection Runner handhabt dies über das Muster pm.environment.set(). Da der Runner eingeschränkt ist, können diese Workflows nur getestet werden, indem man Anfragen manuell nacheinander durchläuft.

Last- und Performance-Tests

Postmans Collection Runner verfügt über eine „Verzögerungs“- und „Iterationen“-Option, mit der Sie eine Sammlung mehrmals nacheinander ausführen können, was für grundlegende Lasttests nützlich ist. Mit den vorhandenen Ausführungslimits ist dieser Anwendungsfall im kostenlosen Tarif praktisch nicht mehr nutzbar.

Sofortige Workarounds innerhalb von Postman

Falls Sie noch nicht bereit sind, das Tool zu wechseln, existieren einige Workarounds innerhalb des Postman-Ökosystems.

Exportieren Sie nach Newman und führen Sie es lokal aus. Newman läuft mit einer lokal exportierten Sammlungs-JSON-Datei, ohne eine Postman-Kontoanmeldung zu erfordern, solange Sie keine Funktionen nutzen, die nach Hause telefonieren. Exportieren Sie Ihre Sammlung und Umgebung, und führen Sie Newman dann komplett offline aus:

newman run collection.json -e environment.json

Dies umgeht das Ausführungslimit des Postman-Kontos, da Newman eine lokale Datei liest. Die Einschränkung ist, dass Sie die Synchronisierung mit Ihrem Live-Postman-Arbeitsbereich verlieren, sodass Sie bei jeder Änderung der Sammlung neu exportieren müssen.

Teilen Sie große Sammlungen in kleinere Stücke auf. Wenn Sie sich dem monatlichen Limit nähern, bedeutet die Aufteilung einer 100-Anfragen-Sammlung in vier 25-Anfragen-Sammlungen, dass jede einen separaten Ausführungszähler verwendet. Dies ist ein Workaround, keine Lösung, und es unterbricht den logischen Ablauf mehrstufiger Tests.

Selektiv upgraden. Wenn nur ein Teammitglied die CI-Pipeline ausführt, ist es günstiger, dieses eine Konto auf einem kostenpflichtigen Plan zu haben, während andere kostenlos bleiben, als alle zu upgraden. Das bezahlte Konto führt Newman ohne Limits aus; andere verwenden manuelles Testen.

Wie Apidogs Collection Runner anders funktioniert

Apidogs Runner, der „Test-Szenarien“ genannt wird oder über die Schaltfläche „Ausführen“ (Run) in jeder Sammlung zugänglich ist, hat keine monatlichen Ausführungslimits in keinem Tarif. Dies beinhaltet den kostenlosen Tarif.

Hier ist ein Vergleich dessen, was Postman eingeschränkt hat:

Der Apidog CLI-Runner (apidog-cli) integriert sich auf die gleiche Weise in CI/CD wie Newman. Die Befehlsstruktur ist ähnlich:

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

Sie können eine Sammlung auch aus Apidog exportieren und offline ausführen, ähnlich dem lokalen Datei-Ansatz von Newman, jedoch ohne sich um kontobasierte Einschränkungen kümmern zu müssen.

Apidog Runner in Ihrer CI-Pipeline einrichten

Wenn Sie eine Newman-basierte Pipeline zu Apidog migrieren, sieht der Übergang in GitHub Actions folgendermaßen aus.

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

Nachher (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 }}

Die Hauptunterschiede sind der Authentifizierungsmechanismus (Apidog verwendet ein Access Token statt eines Postman API-Keys) und die projektbasierte Referenz anstelle eines lokalen Dateipfads. Beide unterstützen JSON-Ausgaben für die Testberichterstattung.

Alternativ, wenn Sie Newmans vertraute Benutzeroberfläche weiterhin nutzen möchten, können Sie eine Apidog-Sammlung als Postman-kompatible JSON exportieren und Newman weiterhin damit ausführen. Dies ermöglicht Ihnen den Offline-Ansatz ohne Kontoanforderung, während Sie täglich mit Apidog arbeiten.

Erweiterte Runner-Funktionen in Apidog

Über die Übereinstimmung mit Postmans eingeschränktem Funktionsumfang hinaus bietet Apidogs Runner einige wissenswerte Funktionen.

Datengesteuertes Testen. Importieren Sie eine CSV- oder JSON-Datei in einen Testlauf, um dieselbe Sammlung mit verschiedenen Datensätzen auszuführen. Jede Zeile wird zu einer Iteration. Dies entspricht der Datendatei-Funktion von Postman, die in höheren Postman-Tarifen ebenfalls kostenpflichtig ist.

Benutzerdefinierte Iterationsanzahlen. Legen Sie eine bestimmte Anzahl von Iterationen für einen Testlauf fest, ohne sich um einen monatlichen Zähler kümmern zu müssen. Führen Sie Ihre Sammlung bei Bedarf 500 Mal für einen grundlegenden Stresstest aus.

Smart Mock-Integration. Während der Runner ausgeführt wird, kann er mit Apidogs integriertem Mock-Server interagieren. Das bedeutet, Sie können Tests gegen gemockte Endpunkte ausführen, ohne einen separaten Server starten zu müssen, was nützlich ist, wenn Client-Code gegen eine noch nicht erstellte API getestet wird.

Geplante Läufe. Richten Sie automatische Testläufe nach einem Zeitplan (stündlich, täglich usw.) direkt in Apidog ein, ohne externe Cron-Jobs oder CI-Trigger zu benötigen. Die Ergebnisse erscheinen in der Testhistorie Ihres Projekts.

Postmans Einschränkungen für den Collection Runner sind ein praktisches Hindernis für Teams, die CI-Pipelines und automatisierte Test-Workflows im kostenlosen Tarif aufgebaut haben. Der direkteste Weg ist der Wechsel zu einem Runner ohne Nutzungslimits. Apidogs Runner deckt alle Anwendungsfälle ab, die Postmans kostenloser Tarif eingeschränkt hat, und die CLI-Integration funktioniert in bestehenden Pipeline-Setups mit einer kleinen Konfigurationsänderung.