Postman-Sammlung

Eine Collection ist die Einheit, in der Postman die Arbeit organisiert: eine Ordnerstruktur mit Anfragen, jede mit ihrer Methode, URL, Headern, Body und optionalen Skripten sowie gemeinsam genutzten Variablen. Exportiert wird sie als JSON-Datei, die von anderen Personen, einem CI-Job oder Newman (dem Kommandozeilen-Runner von Postman) geöffnet und ausgeführt werden kann.

So funktioniert es

Anfragen referenzieren Variablen wie {{baseUrl}} und {{token}} , die aus der Umgebung stammen, sodass dieselbe Sammlung für lokale, Staging- und Produktionsumgebungen ausgeführt wird. Testskripte, die an eine Anfrage angehängt sind, überprüfen deren Antwort und können Variablen für die nächste Anfrage festlegen – beispielsweise ein Token vom Login erfassen und es dann bei jedem weiteren Aufruf verwenden.

Das Missverständnis

Eine Sammlung dient der Dokumentation. Sie speichert, was jemand einmal gesendet hat, nicht, was die API akzeptiert. Eine Sammlung kann Monate alt sein und trotzdem erfolgreich sein, solange niemand die Anfrage hinzugefügt hat, die fehlschlagen würde. Die Generierung aus der OpenAPI-Dokumentation der API gewährleistet die Aktualität.

Probieren Sie es hier aus

Jede Dokumentationsseite exportiert eine Postman-Collection für die jeweilige API, die aus denselben Definitionen wie das zugehörige OpenAPI-Dokument generiert wird. Der Arbeitsbereich funktioniert analog: Variablen, Erfassungen und Zusicherungen pro gespeicherter Anfrage.

Verwandte Inhalte

• What OpenAPI is
• Einstiegsanleitung

Quellen

• Postman collection schema

Weitere Begriffe

• OpenAPI — Eine maschinenlesbare Beschreibung einer HTTP-API – ihrer Pfade, Parameter, Bodys und Antworten – in JSON oder YAML.
• REST-API — Eine API, die ein System als adressierbare Ressourcen modelliert, die mit Standard-HTTP-Methoden manipuliert werden.
• API-Endpunkt — Eine URL plus eine HTTP-Methode – die kleinste Einheit einer API, die ein Client aufrufen kann.
• Abfrageparameter — Die Schlüssel-Wert-Paare nach dem Fragezeichen in einer URL dienen dazu, die Ergebnisse eines Endpunkts zu filtern, zu sortieren, zu paginieren oder zu strukturieren.
• Pfadparameter — Ein variabler Abschnitt eines URL-Pfades, wie zum Beispiel die 42 in /orders/42 , der eine bestimmte Ressource identifiziert.
• HTTP-Header — Name-Wert-Metadaten werden mit jeder Anfrage und Antwort separat vom Nachrichtentext gesendet.

Diese Seite auf Englisch lesen

Alle Glossarbegriffe · Testtechniken · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert 16. Oktober 2026