Deine API mit Postman testen – Schritt für Schritt

Du hast deine erste API mit instantapi.io erstellt – und jetzt willst du wissen, ob sie korrekt funktioniert, bevor du sie in deine App oder dein Tool integrierst. Genau dafür ist Postman gemacht: ein kostenloses Tool, das dir eine übersichtliche Oberfläche bietet, um API-Anfragen zu senden, Antworten zu inspizieren und Tests zu verwalten.

In diesem Tutorial führen wir dich Schritt für Schritt durch den gesamten Prozess: Installation, Collection anlegen, Umgebungsvariablen setzen und alle relevanten HTTP-Methoden (GET, POST, PUT, DELETE) ausprobieren. Als Alternative zeigen wir auch, wie du dieselben Anfragen mit curl im Terminal absetzen kannst.

Was ist Postman?

Postman ist eine Entwicklerumgebung für APIs. Ursprünglich als Browser-Plugin gestartet, ist es heute eine vollwertige Desktop-Applikation für Windows, macOS und Linux. Mit Postman kannst du:

• HTTP-Anfragen aller Art (GET, POST, PUT, DELETE, PATCH, …) an beliebige APIs senden.
• Anfragen in Collections organisieren – quasi Ordner für zusammengehörige API-Calls.
• Mit Environments Variablen wie API-URL und API-Key zentral verwalten.
• Antworten im JSON-Format übersichtlich anzeigen und debuggen.
• Automatisierte Tests schreiben, die auf bestimmte Statuscodes oder Felder prüfen.

Collection und Environment anlegen

Bevor du die erste Anfrage absendest, lege eine strukturierte Umgebung an. Das spart Zeit und vermeidet Fehler.

Environment erstellen

1. Klicke in Postman links auf „Environments" und dann auf „+" (Neu erstellen).
2. Benenne die Umgebung z. B. „instantapi.io – Produktion".
3. Füge folgende Variablen hinzu:

Speichere die Umgebung und wähle sie oben rechts im Environment-Dropdown aus.

Collection erstellen

1. Klicke links auf „Collections" und dann auf „+".
2. Benenne die Collection z. B. „instantapi.io – Meine API".
3. In dieser Collection wirst du alle Anfragen speichern.

GET-Request: Daten abrufen

Erstelle in deiner Collection einen neuen Request. Wähle die Methode GET und trage folgende URL ein:

Wechsle zum Tab „Headers" und füge folgenden Header hinzu:

Klicke auf „Send". Im unteren Bereich siehst du die API-Antwort. Der Status-Code sollte 200 OK sein, die Antwort ein JSON-Objekt mit total, limit, offset und data.

Query-Parameter hinzufügen

Wechsle zum Tab „Params", um Query-Parameter komfortabel hinzuzufügen:

POST-Request: Neuen Datensatz anlegen

Mit einem POST-Request kannst du einen neuen Datensatz in deinem Dataset anlegen. Erstelle einen neuen Request in der Collection:

• Methode: POST
• URL: {{API_BASE_URL}}/{{DATASET}}/data
• Header: x-api-key: {{API_KEY}} und Content-Type: application/json

Wechsle zum Tab „Body", wähle „raw" und das Format „JSON". Trage den neuen Datensatz ein:

Bei Erfolg antwortet die API mit Status-Code 201 Created und dem neu erstellten Datensatz inklusive der automatisch vergebenen id.

PUT-Request: Datensatz aktualisieren

Um einen bestehenden Datensatz zu ändern, verwende PUT mit der ID des Datensatzes in der URL:

• Methode: PUT
• URL: {{API_BASE_URL}}/{{DATASET}}/data/42 (wobei 42 die ID des Datensatzes ist)
• Header: x-api-key: {{API_KEY}} und Content-Type: application/json

Du musst nur die Felder mitschicken, die du ändern möchtest. Alle anderen Felder bleiben unverändert. Bei Erfolg antwortet die API mit 200 OK und dem aktualisierten Datensatz.

DELETE-Request: Datensatz löschen

Um einen Datensatz zu löschen, sende einen DELETE-Request mit der ID:

• Methode: DELETE
• URL: {{API_BASE_URL}}/{{DATASET}}/data/42
• Header: x-api-key: {{API_KEY}}
• Kein Request Body nötig.

Bei Erfolg antwortet die API mit Status-Code 204 No Content – kein Response Body, aber das ist korrekt und bedeutet: Datensatz erfolgreich gelöscht.

HTTP-Status-Codes verstehen

Jede API-Antwort enthält einen Status-Code, der dir sagt, ob die Anfrage erfolgreich war – und wenn nicht, warum. Hier die wichtigsten:

Alternative: curl im Terminal

Wer lieber im Terminal arbeitet oder keine GUI-Anwendung installieren möchte, kann alle Anfragen auch mit curl absetzen. curl ist auf macOS und Linux vorinstalliert; unter Windows steht es ab Windows 10 zur Verfügung.

GET mit curl

POST mit curl

DELETE mit curl

---

Fazit: Postman macht API-Tests zum Kinderspiel

Mit Postman hast du eine professionelle Umgebung, um deine instantapi.io-API systematisch zu testen – lange bevor du sie in eine App integrierst. Durch Environments und Collections bleibst du organisiert, kannst schnell zwischen verschiedenen Datasets wechseln und alle HTTP-Methoden komfortabel ausprobieren.

Der API-Key gehört immer in den Header x-api-key. Status-Codes geben dir sofort Feedback, ob eine Anfrage erfolgreich war. Und mit curl hast du eine schlanke Alternative für das Terminal, die keine Installation erfordert.