Zum Hauptinhalt springen

Wie erstelle ich eine Sammlung in Postman

Postman ist eine leistungsstarke API-Testanwendung, mit der Entwickler in einer benutzerfreundlichen und intuitiven Umgebung mit APIs arbeiten können. Eine der Hauptfunktionen von Postman besteht darin, Sammlungen zu erstellen und zu verwalten, mit denen Sie API-Anfragen in einem praktischen Format gruppieren und organisieren können.

Um mit Sammlungen in Postman zu beginnen, müssen Sie im linken Bereich der Anwendung auf die Registerkarte "Sammlungen" klicken. Klicken Sie dann auf die Schaltfläche "Create a Collection", um eine neue Sammlung zu erstellen. Wenn Sie eine Sammlung erstellen, werden Sie aufgefordert, einen Namen und eine Beschreibung der Sammlung anzugeben, um sie in Zukunft leichter zu identifizieren.

Nachdem Sie die Sammlung erstellt haben, können Sie API-Anfragen innerhalb der Sammlung hinzufügen. Klicken Sie dazu auf die Schaltfläche "Create a Request" und geben Sie die URL Ihrer Anfrage, die Methode und andere Parameter ein. Nachdem Sie eine Abfrage erstellt haben, können Sie sie der ausgewählten Sammlung hinzufügen, indem Sie sie aus der Dropdown-Liste auswählen. Wenn Sie weitere Abfragen hinzufügen müssen, wiederholen Sie einfach den Vorgang zum Erstellen und Hinzufügen einer API-Anfrage zur Sammlung.

Sammlungen in Postman können auch Variablen enthalten, mit denen Sie die Werte in Abfragen im laufenden Betrieb ändern können. Sie können der Sammlung Variablen hinzufügen, indem Sie sie auf der Registerkarte "Sammlungen" öffnen und auf die Schaltfläche "Umgebungen verwalten" klicken. Sie können diese Variablen dann in Abfragen verwenden, indem Sie sie als > angeben. Dies ist beispielsweise nützlich für die Arbeit mit verschiedenen Umgebungen (Test, Entwicklung, Produktion) oder für die Übertragung dynamischer Werte in Abfragen.

Konto registrieren

Um eine Sammlung bei Postman zu erstellen, müssen Sie ein Konto registrieren. Dadurch können Sie Ihre Sammlungen zwischen Geräten speichern und synchronisieren, sie mit anderen Benutzern teilen und auf zusätzliche Funktionen zugreifen.

  1. Gehen Sie zur offiziellen Website von Postman.
  2. Klicken Sie auf die Schaltfläche "Anmelden".
  3. Wählen Sie eine Registrierungsmethode aus: per E-Mail oder über Google- oder GitHub-Konten.
  4. Füllen Sie die erforderlichen Formularfelder aus: Benutzername, E-Mail-Adresse und Passwort.
  5. Aktivieren Sie die Kontrollkästchen, um den Nutzungsbedingungen und der Datenschutzrichtlinie zuzustimmen.
  6. Klicken Sie auf "Create Account" (Konto erstellen).
  7. Bestätigen Sie Ihre Registrierung, indem Sie die Anweisungen befolgen, die an die von Ihnen angegebene E-Mail-Adresse gesendet werden.

Sobald die Registrierung abgeschlossen ist, können Sie sich bei Ihrem Konto anmelden und mit der Erstellung Ihrer Sammlungen in Postman beginnen. Mit einem registrierten Konto können Sie Abfragen, Umgebungsvariablen und andere Einstellungen speichern, Anfragen an externe APIs stellen und viele andere nützliche Aktionen ausführen.

Installieren von Postman auf einem Computer

Führen Sie die folgenden Schritte aus, um Postman auf Ihrem Computer zu installieren:

  1. Gehen Sie zur offiziellen Postman-Website unter https://www.postman.com /.
  2. Klicken Sie oben auf der Seite auf die Schaltfläche "App herunterladen".
  3. Wählen Sie die Version der Anwendung aus, die Ihrem Betriebssystem entspricht (Windows, macOS oder Linux).
  4. Klicken Sie auf den Download-Button und warten Sie, bis der Download abgeschlossen ist.
  5. Führen Sie das Postman-Installationsprogramm gemäß den Anweisungen auf dem Bildschirm aus.

Nach Abschluss der Installation ist Postman auf Ihrem Computer verfügbar. Jetzt können Sie damit beginnen, API-Anfragen zu erstellen und zu senden, Ihre Anwendungen zu testen und zu debuggen.

Wichtig: Neben der Standardinstallation bietet Postman auch eine webbasierte Version der Anwendung an, die ohne Installation auf dem Computer verwendet werden kann. Auf die Webversion kann nach der Registrierung auf der offiziellen Postman-Website zugegriffen werden.

Erstellen einer neuen Sammlung

Führen Sie die folgenden Schritte aus, um eine neue Sammlung in Postman zu erstellen:

  1. Öffnen Sie die Postman-Anwendung auf Ihrem Computer.
  2. Klicken Sie im linken Bereich auf die Schaltfläche "Sammlungen".
  3. Wählen Sie im angezeigten Menü die Option Sammlung erstellen aus.
  4. Geben Sie im angezeigten Dialogfeld einen Namen für Ihre neue Sammlung ein und klicken Sie auf die Schaltfläche Speichern.

Jetzt haben Sie eine neue leere Sammlung, der Sie Abfragen hinzufügen und deren Parameter anpassen können. Sie können die erstellte Sammlung verwenden, um Testabfragen durchzuführen, Ihr Projekt zu organisieren und zu strukturieren oder mit anderen Teammitgliedern zusammenzuarbeiten.

Hinzufügen von Abfragen zu einer Auflistung

Nachdem Sie die Sammlung in Postman erstellt haben, können Sie verschiedene Anfragen zur späteren Verwendung hinzufügen. Das Hinzufügen von Abfragen zu einer Sammlung ist sehr einfach und bequem.

Führen Sie die folgenden Schritte aus, um der Auflistung eine Abfrage hinzuzufügen:

  1. Öffnen Sie die Sammlung, der Sie die Abfrage hinzufügen möchten.
  2. Klicken Sie oben rechts auf dem Bildschirm auf die Schaltfläche "Anfrage hinzufügen".
  3. Geben Sie den Namen der Anfrage ein und wählen Sie den Typ der Anfrage aus (GET, POST, PUT, DELETE usw.).
  4. Geben Sie die Anforderungs-URL ein und fügen Sie bei Bedarf Parameter hinzu.
  5. Sie können Anforderungsheader hinzufügen, wenn dies erforderlich ist.
  6. Fügen Sie ggf. einen Anforderungstext wie JSON oder ein Datenformular hinzu.
  7. Klicken Sie auf die Schaltfläche Speichern, um die Abfrage der Sammlung hinzuzufügen.

Nachdem Sie eine Abfrage zu einer Sammlung hinzugefügt haben, können Sie sie jederzeit einfach wiederholen, indem Sie die entsprechende Sammlung auswählen und die Abfrage darin eingeben.

In Postman können Sie der Abfrage auch automatisierte Tests und Funktionsskripte hinzufügen und sie in verschiedenen Umgebungen und auf verschiedenen Geräten ausführen.

Festlegen von Abfrageparametern

Mit Postman können Sie Anforderungsparameter für verschiedene Aktionen konfigurieren. Verwenden Sie dazu die Registerkarte "Params" im Fenster "Abfrage bearbeiten".

Auf dieser Registerkarte können Sie verschiedene Abfrageparameter angeben, z. B. Abfrageparameter, Kopfzeilenparameter, Abfragetextparameter und andere.

Query-Parameter sind Parameter, die nach dem Fragezeichen ("?"). Sie können einen neuen query-Parameter hinzufügen, indem Sie seinen Namen und Wert in die entsprechenden Felder eingeben. Sie können auch mehrere Query-Parameter hinzufügen, indem Sie auf den Button "Add Query Parameter" klicken.

Mit Kopfzeilenoptionen können Sie Abfrageheader angeben. Sie können einen neuen Header-Parameter hinzufügen, indem Sie seinen Namen und seinen Wert in die entsprechenden Felder eingeben. Sie können auch mehrere Header-Optionen hinzufügen, indem Sie auf die Schaltfläche "Add Header" klicken.

Mit den Abfragetextparametern können Sie angeben, welche Daten zusammen mit der Abfrage gesendet werden sollen. Sie können verschiedene Datenformate wie JSON, XML, Formulardaten und andere auswählen. Wählen Sie dazu das gewünschte Datenformat im Dropdown-Menü "Body" aus und geben Sie dann die entsprechenden Daten in das Eingabefeld ein.

Nachdem Sie alle Abfrageparameter konfiguriert haben, können Sie die Anfrage senden, indem Sie auf die Schaltfläche "Senden" klicken. Der Postman führt die Anforderung mit den angegebenen Parametern aus und zeigt die Antwort auf der Registerkarte "Antwort" an.

Durch das Anpassen von Abfrageparametern in Postman können Sie die Abfrageausführung genauer steuern und deren Ergebnisse überprüfen.

Abfragen überprüfen

Wenn Sie eine Sammlung in Postman erstellt und die erforderlichen Anforderungen hinzugefügt haben, ist es an der Zeit, ihre Funktionsfähigkeit zu überprüfen.

Postman bietet leistungsstarke Tools zum Überprüfen und Debuggen von Abfragen. Sie können Anfragen senden und Antworten vom Server in Echtzeit erhalten. Auf diese Weise können Sie schnell sicherstellen, dass Ihr Code ordnungsgemäß funktioniert oder Fehler schnell behoben werden.

Die Überprüfung von Anforderungen in Postman erfolgt wie folgt:

  1. Öffnen Sie die Sammlung in Postman.
  2. Wählen Sie die zu überprüfende Abfrage aus der Liste der Abfragen in der Sammlung aus.
  3. Klicken Sie neben der ausgewählten Anfrage auf die Schaltfläche "Senden".
  4. Der Postman sendet die Anfrage an den Server und erhält eine Antwort. Sie können die Antwort im Abschnitt "Antwort" am unteren Rand des Postman-Bildschirms sehen.
  5. Analysieren Sie die resultierende Antwort, um sicherzustellen, dass die Abfrage erfolgreich ausgeführt wurde, und geben Sie das erwartete Ergebnis zurück.

Wenn die Anforderung erfolgreich war, sehen Sie den Statuscode 200 und die empfangenen Daten in tabellarischer Form oder im JSON-Format im Abschnitt "Antwort". Wenn die Anforderung nicht erfolgreich war, sehen Sie einen entsprechenden Statuscode (z. B. 404 für die Seite nicht gefunden) und eine Meldung mit einer Beschreibung des Fehlers.

Wenn Sie Fehler in der Abfrage feststellen oder das erwartete Ergebnis nicht erhalten, können Sie die Abfrageparameter ändern, Header hinzufügen, die Autorisierung konfigurieren usw., um die Abfrage zu verbessern und sie erneut auszuführen.

Außerdem bietet Postman hervorragende Tools zum Debuggen von Abfragen. Sie können den Debug-Modus verwenden, um die Abfrage schrittweise zu überprüfen und zur Laufzeit zu überprüfen. Sie können bei Bedarf Haltepunkte hinzufügen und Variablen und Werte anzeigen.

Die Überprüfung von Abfragen ist ein wichtiger Teil der Entwicklung und Prüfung von APIs. Mit Postman können Sie Ihre Anfragen schnell und einfach überprüfen und sicherstellen, dass sie ordnungsgemäß funktionieren.

Erstellen von Umgebungsvariablen

Mit Umgebungsvariablen in Postman können Sie Werte speichern und verwenden, die sich je nach Umgebung ändern können, in der Ihre Abfrage ausgeführt wird. Sie sind praktisch zum Verwalten verschiedener Konfigurationen und zum Speichern sensibler Daten wie Tokens und Passwörter.

Befolgen Sie diese Schritte, um Umgebungsvariablen in Postman zu erstellen:

  1. Öffnen Sie Postman und wählen Sie oben im Fenster die Registerkarte "Manage Environments".
  2. Klicken Sie auf "Add", um eine neue Umgebung zu erstellen.
  3. Geben Sie den Namen Ihrer Umgebung in das Feld "Name" ein. Zum Beispiel "Development" oder "Production".
  4. Klicken Sie auf "Add", um Ihrer Umgebung Variablen hinzuzufügen.
  5. Geben Sie den Namen der Variablen in das Feld "Key" und den Wert der Variablen in das Feld "Initial Value" ein.
  6. Klicken Sie auf "Save", um die Variable zu speichern.

Jetzt können Sie diese Variablen in Abfragen verwenden, indem Sie sie als > angeben. Postman ersetzt automatisch den entsprechenden Wert, wenn die Abfrage ausgeführt wird.

Um den Wert einer Umgebungsvariablen zu ändern, klicken Sie einfach auf die Registerkarte "Manage Environments", wählen Sie die gewünschte Umgebung aus und ändern Sie den Wert der Variablen.

Das Erstellen von Umgebungsvariablen hilft Ihnen, den Testprozess in Postman zu vereinfachen und zu beschleunigen, sodass Sie effizienter an Ihrem Projekt arbeiten können.

Autorisierung festlegen

Mit der Autorisierung können Sie Anforderungen mit Authentifizierungsdaten wie Zugriffstoken oder API-Schlüsseln senden. Postman bietet mehrere Autorisierungsoptionen, einschließlich der grundlegenden Authentifizierung, OAuth 2.0 und Bearer-Token.

1. Um die Autorisierung festzulegen, müssen Sie die Registerkarte öffnen Authorization im Fenster Abfrage bearbeiten.

2. Im Feld Type wählen Sie eine Authentifizierungsmethode aus, die Ihrem Fall entspricht. Wenn Sie beispielsweise ein Zugriffstoken verwenden, wählen Sie Bearer Token.

3. Füllen Sie die erforderlichen Felder je nach gewählter Methode aus. Wenn Sie beispielsweise OAuth 2.0 gewählt haben, müssen Sie Folgendes angeben Token Name und Access Token.

4. Falls erforderlich, können Sie der Anforderung Autorisierungsoptionen über die Registerkarte hinzufügen Headers oder Params.

5. Nachdem Sie die Autorisierung eingerichtet haben, können Sie eine Anfrage senden und sicherstellen, dass sie mit den übergebenen Autorisierungsdaten erfolgreich verläuft.

Wenn Sie die Autorisierung in Postman festlegen, können Sie über die Authentifizierungsdaten, die Sie benötigen, auf sichere APIs zugreifen und mit ihnen interagieren.

Sammlungen exportieren und importieren

Postman bietet die Möglichkeit, Sammlungen zu exportieren und zu importieren, um Daten auszutauschen oder eine Sicherungskopie zu erstellen. Dies ist eine nützliche Funktion, mit der Sie Ihre Arbeit speichern und einfach mit anderen teilen können.

Führen Sie die folgenden Schritte aus, um eine Sammlung zu exportieren:

  1. Geben Sie einen Namen für die Sammlung in das Suchfeld ein oder wählen Sie sie aus der Liste der Sammlungen aus.
  2. Klicken Sie mit der rechten Maustaste auf Sammlungen und wählen Sie Exportieren.
  3. Wählen Sie ein Exportformat (z. B. JSON oder CSV) aus und geben Sie den Pfad zum Speichern der Datei an.
  4. Klicken Sie auf Exportieren, um eine Exportdatei zu erstellen.

Führen Sie die folgenden Schritte aus, um eine Sammlung zu importieren:

  1. Klicken Sie in der oberen Navigationsleiste auf die Schaltfläche "Importieren".
  2. Wählen Sie die Datei mit der Sammlung aus, die Sie importieren möchten.
  3. Wählen Sie die Zielsammlung aus, oder erstellen Sie eine neue Sammlung zum Importieren.
  4. Klicken Sie auf Importieren, um die Importdatei herunterzuladen und sie Ihrer Sammlung hinzuzufügen.

Beim Exportieren und Importieren von Sammlungen speichert Postman alle Anforderungen, Variablen, Authentifizierung und andere Einstellungen, die Sie in der Sammlung definiert haben.

Verwenden Sie die Export- und Importfunktion von Postman, um eine bessere Zusammenarbeit mit anderen Entwicklern zu ermöglichen und Ihre Sammlungen zu verwalten.