Aufwendiges Testen mit APIs – so vereinfacht man sich mit Postman das Leben

Eine bestimmte Antwort auf einen HTTP Request zu bekommen, um bspw. Fehlerfälle nachzustellen, ist unabdingbar. Da es teilweise mühselig sein kann, solche Mocks zu erstellen, hat Postman ein nettes Feature in seine Software gebaut: den Postman Mock Server.

Um den Postman Mock Server benutzen zu können, benötigt man einen Postman Account. Diesen kann man kostenlos auf der Website von Postman erstellen.

Ist der Account erstellt, könnt ihr euch in eurem Postman Client anmelden und einen Workspace eurer Wahl öffnen.

Die Schaltfläche zum Erstellen des Mock Servers ist anfangs nicht sichtbar. Klickt dafür in der Sidebar auf „Configure workspace sidebar“ und aktiviert dort den Punkt „Mock servers“.

Anschließend könnt ihr über die Sidebar einen Mock Server erstellen:

Für die Erstellung könnt ihr entweder eine neue Collection erstellen oder eine bestehende benutzen. In diesem Beispiel werden wir eine neue Collection erstellen und zwei Test-Requests angeben, die als Mock einmal einen 200 OK und einen 500 Internal Server Error zurückgeben sollen.

Als nächstes geben wir dem Mock Server noch einen Namen. Wir haben hier auch verschiedene Möglichkeiten:

  1. Das Environment anzugeben.
  2. Die URL des Mock Servers zusätzlich als Environment Variable speichern.
  3. Ein Delay der Response anzugeben.
  4. Den Mock Server mit einem Key absichern.

Postman hat uns nun eine neue Collection mit den angegebenen Requests generiert.

Nun kann man weitere Mocking Responses als „Examples“ hinzufügen. Ich füge dem Customer Request nun ein weiteres Beispiel hinzu und nenne das vorherige der Klarheit wegen um.

Ich habe nun ein weiteres Example an den Request Customer gehängt.

Die URL des Beispiels habe ich auf „(URL des Mock Servers)/Customer/500“ und den Status Code auf 500 geändert. Wenn ein GET Request zum Mock Server mit dieser Adresse gesendet wird, wird eine Response mit Status Code 500 zurückgegeben.

Es kann auch ein Response Body definiert werden, jedoch habe ich das in diesem Beispiel weggelassen.

Ein kleiner Test zeigt, dass wir erfolgreich einen Fehler gemockt haben.

Dieser Tipp kommt aus Stuttgart von Janni Kokkinos.