API-Testing mit Newman

Jetzt testen wir die laufende API von außen mit Newman (dem Kommandozeilen-Runner für Postman-Collections). Die Collection liegt in tests/postman/collection.json.

1. Aufgabe: Newman-Step ergänzen

Ziel: Die API "von außen" über echte HTTP-Requests testen lernen, statt nur intern über Code.

Beschreibung:

1. Suche im Job api-tests den Kommentar # TODO (Block 2, Aufgabe 1).
2. Ergänze den Step, der Newman ausführt.
3. Committe und pushe.
4. Beobachte den Log: Ein Test schlägt bewusst fehl. Finde heraus, welcher und warum.

• Tipp
• Lösung

Bewirkt:

Führt alle Requests der Collection nacheinander gegen die laufende API aus. Der Job wird zunächst rot, weil ein Test bewusst fehlschlägt.

Der Sinn der Aufgabe:

Unit-Tests (Block 1) prüfen nur den Code direkt, nie die tatsächlich laufende, konfigurierte Anwendung. Mit Newman lernt ihr die zweite große Testkategorie kennen: Black-Box-Tests, die die API genauso ansprechen wie ein echter Client. Das ist die Testart, die später auch Secrets, Variables und Environments (Block 3+4) überhaupt sichtbar machen kann.

2. Aufgabe: Fehlerhaften Test korrigieren