Anfragekonfiguration

Was ist die Anfragekonfiguration?

In der Anfragekonfiguration legen Sie die Details des API-Endpunkts fest, den Sie testen möchten. Dazu gehören die URL, die HTTP-Methode und alle zusätzlichen Parameter oder Header, die die Anfrage braucht.

Die Anfrage konfigurieren

1. URL-Endpunkt: Legen Sie die URL des API-Endpunkts fest, den Sie testen möchten. Das ist die Adresse, an die die Prüfung Anfragen sendet.
2. HTTP-Methoden: Wählen Sie aus den folgenden erlaubten HTTP-Methoden die, die Ihr API-Endpunkt unterstützt:

• GET: Daten vom Server abrufen.
• POST: Daten an den Server senden, um eine Ressource zu erstellen/zu aktualisieren.
• PUT: Eine bestehende Ressource auf dem Server aktualisieren.
• PATCH: Eine bestehende Ressource auf dem Server teilweise aktualisieren.
• DELETE: Eine Ressource vom Server entfernen.

Zusätzliche Anfragekonfigurationen

Sie können Ihre API-Prüfung mit den folgenden Optionen weiter anpassen:

• Abfrageparameter (Tab Parameter, Abfrageparameter hinzufügen): Fügen Sie Schlüssel-Wert-Paare hinzu, um zusätzliche Daten über die URL zu übergeben. URL-Feld und Liste bleiben synchron: Ein hinzugefügtes Paar erscheint in der URL, und ein in die URL getippter Parameter erscheint in der Liste.

  • Beispiel: https://api.example.com/resource?key1=value1&key2=value2

• Header (Tab Header, Header hinzufügen): Fügen Sie Ihrer Anfrage eigene Header hinzu. Mit Headern können Sie Metadaten senden und steuern, wie die Anfrage verarbeitet wird.

  • Beispiel: Content-Type: application/json

• POST-Body (Tab Body): Wählen Sie einen Body-Typ (none, JSON, form-data, GraphQL oder raw) und geben Sie den Body ein. Das ist nützlich, um Daten zum Erstellen oder Aktualisieren von Ressourcen zu senden.

  • Beispiel: {"name": "example", "value": "data"}

• Basis-Authentifizierung (Tab Authentifizierung, Basis-Authentifizierung konfigurieren): Geben Sie Benutzername und Passwort ein. Damit wird die Anfrage gegenüber dem Server authentifiziert.

  • Beispiel: Username: user, Password: pass

• SSL überspringen (Tab Einstellungen): Option, die SSL-Prüfung zu überspringen. Das kann beim Testen von Endpunkten mit selbstsignierten Zertifikaten nützlich sein.

• Weiterleitungen folgen (Tab Einstellungen): Option, HTTP-Weiterleitungen zu folgen. So folgt die Prüfung allen Weiterleitungsantworten des Servers.

Aus cURL importieren

Statt die Anfrage von Hand auszufüllen, können Sie einen cURL-Befehl einfügen. Klicken Sie direkt unter dem URL-Feld auf Aus cURL importieren, fügen Sie den Befehl ein (zum Beispiel aus den Entwicklerwerkzeugen Ihres Browsers über "Als cURL kopieren" oder aus Ihrer API-Dokumentation) und klicken Sie auf Importieren. LoadFocus füllt URL, HTTP-Methode, Abfrageparameter, Header, den Body (JSON, URL-kodiert oder raw, mit seinem Content-Type-Header) und die Basic-Authentifizierung aus -u aus und schaltet SSL überspringen für -k und Weiterleitungen folgen für -L ein. Ein Befehl mit Body, aber ohne Methode wird als POST importiert, so wie curl ihn senden würde.

Gespeichert wird erst, wenn Sie auf Speichern klicken: Der Bereich zeigt "Anfrage importiert. Prüfen Sie Header und Body unten vor dem Speichern.", damit Sie das Ergebnis zuerst kontrollieren können.

Einiges wird gemeldet statt importiert: Multipart-Formularfelder (-F), aus einer Datei gelesene Bodys (@file), Optionen, die die Prüfung nicht abbilden kann (der Import wird trotzdem abgeschlossen, und der Bereich listet jede davon auf), eine zweite URL (nur die erste wird verwendet) sowie ein Header ohne Doppelpunkt oder mit Zeilenumbruch. Nur http- und https-URLs können importiert werden, und ein Befehl darf höchstens 100 KB groß sein.

Praktische Anwendungsfälle

• GET-Anfragen testen: Prüfen Sie, ob Ihre API Daten korrekt abruft.
• POST-Anfragen testen: Stellen Sie sicher, dass Ihre API das Erstellen oder Aktualisieren von Daten verarbeiten kann.
• Header zur Authentifizierung nutzen: Übergeben Sie Authentifizierungs-Tokens in Headern, um auf geschützte Ressourcen zuzugreifen.
• Komplexe Abfrageparameter senden: Testen Sie, wie Ihre API mit komplexen Abfragen umgeht.

Mit diesen Einstellungen können Sie Ihre API-Prüfungen genau auf die Anforderungen Ihres API-Endpunkts zuschneiden und so umfassend testen und überwachen.