Sehen wir zunächst, was die Macher von Postman selbst sagen:
„Postman ist ein kräftiger Satz von Werkzeugen zur API-Prüfung, auf die viele Entwickelnde nicht mehr verzichten. Wir machen großartige Produkte, die helfen, eindrucksvolle Schnittstellen zu bauen und die Arbeit ergiebiger zu machen. Postman nutzen weltweit mehr als eine Million Entwickelnde, und diese Zahl wächst beständig. Wir haben vor, weitere Produkte zu entwickeln, um Entwickelnden die stärkste Lösung zum Bauen und Prüfen von APIs zu geben.“
Die heutige Fassung von Postman ist noch kräftiger als die alten, und viele Pro-Möglichkeiten sind jetzt kostenlos zu haben. Mehr noch: Dieses Werkzeug wurde nicht nur für Entwickelnde gemacht. Selbst das Prüfen selbsttätiger Antworten verlangt kein besonderes Wissen. Es ist ein sehr einfaches und zugleich kräftiges Werkzeug.
Eine Anfrage senden
Öffnen Sie diesen Satz, gehen Sie zu „Request Methods“ und dann zu „GET Requests“, so erscheinen alle gespeicherten Angaben im mittleren Teil des Postman-Fensters. Klicken Sie nun auf „Submit“. Sie haben soeben Ihre erste Anfrage gesendet und die erste Antwort erhalten.
POST-Anfragen sind etwas schwieriger, bleiben aber ebenso verständlich und folgerichtig. Diesmal nutzen Sie eine eigene Anfrage. Klicken Sie auf das Pluszeichen, um einen neuen Reiter zu öffnen, ändern Sie die Art der Anfrage von GET auf POST und geben Sie https://jsonplaceholder.typicode.com/posts als Adresse der Anfrage an. Das ist ein kostenloser REST-Dienst, den man für erfundene Daten nutzen kann. Er ist sehr nützlich zum Lernen, zum Nachahmen eines Servers und zum Verbreiten von Codebeispielen.
Nun brauchen Sie den Rumpf der POST-Anfrage. Klicken Sie unter der Adresse auf „Body“, ändern Sie die Art auf „raw“ und „Text“ auf „JSON“. Fügen Sie dann diese Anfrage in den Editor ein:
- {
- “title”: “My first POST request”,
- “body”: “Content of my first POST request!”,
- “userId”: 789
- }
Klicken Sie auf „send“. Sie sollten eine Antwort mit Ihrem Text erhalten — die Bestätigung, dass die Anfrage geglückt ist. Speichern Sie sie für später. Sie können auch eine neue Sammlung anlegen: Klicken Sie einfach rechts neben der Adresse auf „Save“. Es öffnet sich ein Fenster zum Speichern, in dem Sie der Anfrage einen Namen geben und eine neue Sammlung anlegen können.
Prüfungen
Eine weitere ausgezeichnete Möglichkeit von Postman sind selbsttätige Prüfungen der Anfragen. Haben Sie erst einmal eine Prüfung für eine Anfrage angelegt, prüft Postman jede eingehende Antwort nach Ihren Fällen. Sehen wir uns ein einfaches Beispiel an.
Fügen Sie eine neue eigene Anfrage hinzu, um POST von https://jsonplaceholder.typicode.com/posts mit ID = 6 zu holen, und öffnen Sie den Reiter „Tests“. Rechts im Postman-Fenster sehen Sie eine Liste von Vorlagen. Sie hilft beim Aufsetzen der ersten, der zweiten und aller weiteren Prüfungen, denn dieser Code taugt für alles — er muss nur ein wenig an Ihre Bedürfnisse angepasst werden.
tests[“Status code is 200”] = responseCode.code === 200;
- var jsonData = JSON.parse(responseBody);
- tests[“User ID is 1”] = jsonData.userId === 1;
- tests[“Post ID is 6”] = jsonData.id === 6;
- tests[“Body matches string”] = responseBody.has(“dolorem eum magni eos aperiam quia”);
- In der ersten Prüfung sehen wir nach, ob die Antwort auf unsere Anfrage den HTTP-Status „200“ zurückgibt, ob die Kennung der Nutzerin 1 und die Kennung des Beitrags 6 lautet und ob im Rumpf der Antwort der erwartete Text steht.
Klicken Sie jetzt einfach auf „Submit“. Sobald die Antwort da ist, öffnen Sie den Reiter „Tests“ und prüfen Sie, ob alles bestanden wurde.
Mit diesem Beitrag wollten wir zeigen, wie einfach und angenehm sich mit Postman arbeiten lässt!