Postman Schulung: Sammlungen, Assertions und Testläufe

Einstieg in Postman

• Warum Sie Ihre API-Tests automatisieren sollten: Regression, Geschwindigkeit, Nachvollziehbarkeit
• Testumgebung einrichten: Desktop-App oder Web, Konto, Arbeitsbereiche und Rollen
• Übungs-API bereitstellen und erste Anfrage aus einem curl-Befehl importieren
• Sammlungen und Ordner erstellen und sinnvoll nach Ressourcen oder Abläufen gliedern
• Sammlung aus einer OpenAPI-Beschreibung erzeugen und bei Änderungen abgleichen

Anfragen erstellen

• GET-Anfragen mit Pfad- und Abfrageparametern, POST-Anfragen mit JSON-Body
• PUT- und DELETE-Anfragen; PATCH für Teiländerungen
• Body-Varianten: raw JSON, form-data, x-www-form-urlencoded und Datei-Uploads
• Negative Anfragen erstellen: fehlende Pflichtfelder, falsche Typen, unbekannte IDs
• Authentifizierung im Reiter „Authorization“: API-Schlüssel, Bearer-Token, OAuth 2.0
• Authentifizierung auf Sammlung oder Ordner festlegen und an Anfragen vererben

Variablen und Datenfluss zwischen Anfragen

• Umgebungsvariablen verwenden: Test-, Abnahme- und Produktionssystem trennen
• Gültigkeitsbereiche: global, Sammlung, Umgebung, Daten und lokal – wer gewinnt?
• Antwortdaten als Variable speichern mit pm.environment.set und pm.collectionVariables.set
• Variablen zu einer Anfrage hinzufügen: {{baseUrl}} in URL, Header und Body
• Dynamische Testdaten mit Variablen wie {{$randomEmail}} und {{$guid}}
• Pre-request-Skripte: Token holen, Zeitstempel oder Signaturen berechnen
• Geheimnisse im Postman Vault statt in geteilten Variablenwerten ablegen

Einfache Postman-Assertions

• Assertions schreiben im Post-response-Skript mit pm.test und pm.expect (Chai-Syntax)
• Statuscode-Assertions: pm.response.to.have.status und Gruppen wie 2xx oder 4xx
• Body-Assertions: Text, einzelne Felder und erwartete Werte prüfen
• Header- und Antwortzeit-Assertions: Content-Type, Caching-Header, Schwellwert in Millisekunden
• Debugging mit der Postman-Konsole: gesendete Header, Rohantwort, console.log
• Aussagekräftige Testnamen, damit ein roter Lauf ohne Nachschlagen verständlich ist

Erweiterte Postman-Assertions

• JSON-Assertions: pm.response.json() auslesen, Typen und Pflichtfelder prüfen
• Verschachtelte JSON-Assertions: Objekte in Arrays, optionale Felder, null
• Assertions für kompliziertes JSON: Listen mit find, every und some durchsuchen
• Komplizierte Assertions: ganze Antwort gegen ein JSON Schema mit jsonSchema validieren
• Wiederverwendbare Prüfungen in Sammlungsskripten und der Package Library (ab Tarif Solo) ablegen
• Ablauf steuern: Reihenfolge im Lauf mit pm.execution.setNextRequest verändern

Sammlungen automatisieren

• Den Collection Runner verwenden: Reihenfolge, Iterationen, Verzögerung, Ergebnisse
• Datengetriebene Tests mit CSV- oder JSON-Dateien im Runner
• Sammlung und Umgebung exportieren und im Repository versionieren
• Eine Sammlung mit Newman ausführen: Optionen, Umgebungsdatei, Reporter
• Postman CLI: Anmeldung per API-Schlüssel, postman collection run, Unterschiede zu Newman
• Testlauf in GitHub Actions oder GitLab CI mit JUnit-Bericht als Abnahmekriterium
• Monitore für zeitgesteuerte Läufe gegen laufende Systeme

Mock-Server, Dokumentation und Zusammenarbeit

• Mock-Server aus gespeicherten Beispielantworten, um gegen noch fehlende Endpunkte zu testen
• Dokumentation aus der Sammlung erzeugen und Beschreibungen pflegen
• Zusammenarbeit im Team: Forks, Pull Requests, Kommentare und Versionsverlauf
• KI-Funktionen von Postman im Überblick: Agent Mode (früher Postbot) für Testskripte, Fehlersuche und Dokumentation
• Tarife und Funktionsgrenzen kennen: was im kostenlosen Plan (seit März 2026 nur eine Person) geht und was nicht

Postman-Sammlungen mit Coding-Agenten pflegen

• Postman MCP Server mit eng begrenztem API-Schlüssel anbinden, damit der Agent Sammlungen lesen kann
• Agent ergänzt pm.expect-Prüfungen für Fehlerfälle; Abnahme ist ein grüner Lauf der Postman CLI
• Exportierte Sammlung im Repository: Änderungen des Agenten im Diff auf feste URLs und Tokens prüfen
• Assertions, die nur die aktuelle Antwort spiegeln, gegen die Fachregeln der API abgleichen
• Agent Mode im Werkzeug oder externer Agent im Repository – Abwägung nach Aufgabe und Datenschutz

Praxisprojekt: Regressionssuite für eine Bestell-API

• Sammlung mit Ordnern für Anmeldung, Artikel und Bestellungen sowie Umgebungen für Test und Abnahme
• Ablauf verketten: Token holen, Bestellung anlegen, ID speichern, prüfen, stornieren
• Negativfälle und Schemaprüfung ergänzen, Testdaten für 20 Bestellungen aus einer CSV-Datei laden
• Suite per Postman CLI in der Pipeline ausführen und einen fehlenden Endpunkt über einen Mock-Server simulieren