Postman Tutorial für Anfänger | Einführung in API Tests (2021)

Postman Tutorial Guide - Coding Lab Steffen Lippke einfach erklärt
Postman Tutorial Guide – Coding Lab Steffen Lippke einfach erklärt

Du brauchst ein praktisches Postman Tutorial?

Dieses Tutorial gibt Dir eine schnelle Einführung in das Tool!

[+ Bonus: Tipps zur API Nutzung und API Gestaltung]

Let’s Begin!

Was ist Postman?

Das Programm Postman ist ein Test-Programm für Anwendungsschnittstellen (API), welches modifiziert HTTP-Anfragen an einen Server senden kann.

00 Start
00 Postman Start

Der Entwickler hat mit Postman die volle Kontrolle über die …

  • Parameter
  • Inhalte
  • Methoden

… der HTTP-Anfrage. Dieses Tool nutzen Entwickler, um ein Backend zu testen, welches über HTTP erreichbar ist.

Was ist eine API und der Unterschied zum Script?

Ein Application Programming Interface (API) ist eine Zusammenstellung von verschiedenen ausführbaren Dateien, die miteinander kombiniert die Backend-Komponente bilden. Ein einfaches Programm-Skript auf einem Server ist die Vorstufe einer API, die nicht so komplex ist.

Wann soll ich eine API programmieren?

Die Entwicklung einer Application Programming Interface (API) lohnt sich, wenn das Backend verschiedenste und umfangreiche Funktionen erfüllen soll. Der Entwickler braucht für ein API-Framework Einarbeitungszeit und ist deshalb für winzige Projekte ungeeignet. Bei mittelgroßen bis großen Projekten ist eine API ein Muss.

Postman Tutorial – Einrichtung

  1. Gehe auf https://www.postman.com/downloads/
  2. Downloade Dir die Version von Postman für Dein Betriebssystem.
  3. Das Programm Postman braucht keine Admin-Rechte für die Installation, weil sich das Programm automatisch selbst in AppData installiert.
  4. Überspringe die Registrierung mit dem Link unterhalb des Registrierungsfelds (grau in grau)
    00 Übspringe de Registrierung- Postman Tutorial Steffen Lippke Coding Lab
  5. Klicke oben links auf den Button New.
    01 Collection auswählen- Postman Tutorial Steffen Lippke Coding Lab
  6. Wähle den Menüpunkt Collection aus. Eine Collection hilft Dir Deine Requests zu sortieren und in eine Struktur zu bringen. Wenn Du schnell eine API-Route testen möchtest, dann eignet sich der Menüpunkt Request besser.
  7. Wähle einen Namen aus
    02 Collection anlegen- Postman Tutorial Steffen Lippke Coding Lab
  8. (Optional) Erstelle Variablen für die Postman Collection.
    03 Variablen anlegen- Postman Tutorial Steffen Lippke Coding Lab
  9. Klicke auf Create

Postman Tutorial – Anfrage erstellen

Klicke in der Mitte auf den Menüpunkt Request, um eine HTTP-Anfrage erstellen. Postman zeigt Dir die Anfragen-Konfigurations-Oberfläche an.

04 Erstelle einen Request- PSteffen Lippke Coding Lab
04 Erstelle einen Request – Postman Tutorial Steffen Lippke Coding Lab

Der folgende Abschnitt erklärt die Anfragen-Konfigurations-Oberfläche in allen Bestandteilen, weil diese der zentrale Bestandteil von Postman darstellt.

Oben befindet sich das URL-Eingabefeld mit dem Dropdown für die HTTP-Methode (links) und der Button zum Absenden des Requests (rechts). Der „Enter“-Shortcut bzw. Button sendet den Request ab.

Tabs zur Modifizierung des HTTP-Requests

Unterhalb der ersten Zeile findest Du die Tabs:

Tabs Postman
Tabs Postman
  • Params: Dieser Tab legt die URL-GET-Parameter fest, die Postman am Ende in der URI anfügt.
  • Auth: Über diesen Tab kannst Du die Authentifizierungsmethode einstellen. Postman unterstützt die Methoden Basic Auth, OAuth, Baerer Token usw. Verwende für die Authentifizierung die vorher gesetzten Variablen.
    06 Postman Auth- Postman Tutorial Steffen Lippke Coding Lab
  • Header: Du kannst in diesem Tab HTTP-Anfrage-Header setzen, die Du mit Deiner Anfragen mitsendest. Vergessen nicht das Postman sieben Header standardmäßig ausblendet. Ändere diese notfalls ab.
    05 Versteckte Header- Postman Tutorial Steffen Lippke Coding Lab
  • Body: Definiere in diesem Tab Inhalte, die mit der Anfrage mitgesendet werden. Du kannst zwischen verschiedenen Body-Typen wie JSON, Form, Text, Binär usw. wählen.
    08 Body mit JSON- Postman Tutorial Steffen Lippke Coding Lab
  • Settings: Neben der Anfrage kannst Du das Verhalten von Postman beeinflussen. Postman ist eine Art „Entwickler-Browser“, bei dem Du SSL, Weiterleitung oder Textcodierung aus- und einschalten kannst. Wenn Du z.B. Probleme mit dem SSL-Zertifikat hast, dann kannst Du mit einem Klick, die SSL-Verifizierung beenden.
07 Settings helfen weiter wenn nichts geht- Steffen Lippke Coding Lab
07 Settings helfen weiter wenn nichts geht- Postman Tutorial Steffen Lippke Coding Lab

Postman Ergebnis – Vorbereitet und Formatiert

Erstelle eine GET-Anfrage, indem DU die URI angibst und auf den Button Send drückst.

Als HTTP-Antwort-Body-Ergebnis erhältst Du in meinen Fall eine HTML-Webseite als blanken HTML-Code. Ändere die Anzeige des HTTP-Antwort-Bodys, indem Du zwischen den Tabs…

  • Pretty (Code formatieren)
  • Raw (unleserlicher Code)
  • Preview (Browser-Ansicht)
  • Visualize (Spezielle Postman Visualisierung)

… wählst.

Sicherung des Arbeitsstands – Nichts geht verloren

Klicke oben rechts auf den Button Save, um Deine Anfrage in Deiner Postman Collection zu speichern. Verwende in der Collection einzelne Ordner, um Deine Anfragen besser zu strukturieren. Verwende einen aussagekräftigen Namen für die Anfrage.

History – Einen Schritt zurückspringen

Postman speichert jede gestellte Anfrage, sodass Du Dir die alten im History-Tab ansehen kannst. Du kannst Dir große Datei-HTTP-Antworten auf Deiner Festplatte abspeichern, um diese zu bearbeiten. Um die Antwort auf Deiner Festplatte abzuspeichern, klicke im Request-Abschnitt auf den orangen Link Save Request.

Tipps zur API Nutzung für das Postman Tutorial

#1 Doku genau lesen!

Wenn Du eine API-Doku zur Verfügung hast, solltest Du vorher die Doku lesen, um Fehler bei den Anfragen vorzubeugen. Nicht jede API nutzt die gleiche Authentifizierung und die Fehler Codes sind nicht immer identisch.

#2 Wiederholungen über Variablen nutzen

Du kannst URI-Präfixe und Suffixe mit Variablen verwalten. Ändert sich der Server, musst Du nicht alle Anfragen bearbeiten, sondern nur eine Variable. Das Programm Postmann erlaubt generische Variablen wie z.B.

  • {{$guid}} Identifier GUID
  • {{$timestamp}} aktuelles Datum und Zeit
  • {{$randomInt}} Ganzzahl zwischen 0 und 1000.

Postman nutzt zur Verwaltung der Variablen Variablen-Bereiche:

  • Global (Programm-weit),
  • Collection (Sammlung)
  • Environment (z. B. Dev vs. Prod)
  • Local

#3 Halte Dein Passwörter für die API geheim

Lade niemals eine Postman Konfiguration mit Passwörtern auf ein öffentliches Repo hoch! Viele API-Zugangsdaten musst Du erst kaufen oder mieten – lösche die Zugangsdaten immer aus den Dateien heraus.

#4 Kenne Deine Shortcuts

Wenn Du viel mit Postman arbeiten willst, sind die Programm Shortcuts für Dich ein Muss. Du kannst das Programm schneller mit Shortcut bedienen als mit der Maus.

#5 Lerne die Grundlage von HTTP

Viele Fehler kannst Du vermeiden, indem Du gründlich Dir die Grundlagen von Hypertext Tranfer Protocols (HTTP), den IP/TCP Stack ansiehst und wie Authentifizierung funktioniert.

Du kannst zusammen mit dem Einlesen in die Theorie gleich praktisch mit Postman experimentieren. Postman ist ein Schwerzeitaschenmesser-Browser, mit dem Du alles probieren kannst und Deine HTTP-Anfragen nach Deinen Wünschen gestalten kannst.

Tipps zur API Gestaltung und API Doku

Jeder Backenentwickler sollte diese Tipps zum Erstellen von APIs kennen:

  1. Verwende Nomen, um eine API Schnittstelle zu benennen und nutze sprechende, verständliche Begriffe.
  2. Bündele Domänen! Präfixe Schnittstellen, die in einen Zusammenhang stehen, mit dem gleichen Wort /user/ oder /payment/
  3. Bevorzuge einen kurzen Pfad. Keep it simple stupid und erfinde nicht das Rad neu.
  4. Nutze Beispiele für Deine Dokumentation. Einige konkrete Request-Beispiele helfen Neulingen weiter. Unerfahrene Nutzer sind thematisch in Deine API nicht vertieft.
  5. Erkläre in Deiner Dokumentation ausführlich, strukturiere die Texte und verwende zahlreiche Verweise, Links und Bilder in Deine Texten.
  6. Optimiere Deine API-Doku für Suchmaschinen. Neulinge versuchen über Google antworten im Netz zu finden. Die qualitative und verifizierte Antworten geben oftmals nur die Entwickler des Softwareprodukts selbst.

Alternative Insomnia

Das Programm Insomnia ist die Alternative zu Postman. Viele Funktionen sind sehr ähnlich zu Postman – aber das User-Interface ist nach meinem Geschmack besser aufgeräumt und übersichtlich. Wenn Du mit Postman klarkommst, gewöhnst Du Dich schnell an das Insomnia Tool.


Danke fürs Lesen! Erhalte weitere Tutorials in meinem kostenlosen Newsletter*.
Jeden Monat teile ich mit Dir 4 neue praxisnahe Tutorials.
Trage Deine Mail ein und werde Teil von uns.



Quellenangabe Bilder: Icons und SVG-Grafiken im Titelbild von Microsoft PowerPoint 2019, frei verfügbar nach EULA
*) Mit dem Abonnement des Newsletters erklären Sie sich mit der Analyse des Newsletters durch individuelle Messung, Speicherung und Analyse von Öffnungsraten und der Klickraten in Profilen zu Zwecken der Gestaltung künftig besserer Newsletter einverstanden. Sie können die Einwilligung in den Empfang des Newsletters und die Messung mit Wirkung für die Zukunft widerrufen. Der Versand erfolgt mit MailChimp. Mehr in der Datenschutzerklärung.

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht.

Diese Website verwendet Akismet, um Spam zu reduzieren. Erfahre mehr darüber, wie deine Kommentardaten verarbeitet werden.