Query-Parameter

Query-Parameter verwenden

Sie können Query-Parameter zu Ihrer Anfrage entweder in der URL oder im Feld Query-Parameter hinzufügen:

https://www.example.com?query1=value1&query2=value2
https://www.example.com?query1=value1&query2=value2#hash1
https://api.example.com/v2/resources/1?query1=value1&query2=value2

Beide Methoden sind gültig. Wenn Sie Query-Parameter sowohl in der URL als auch im Feld Query-Parameter hinzufügen, werden sie verkettet, und es werden alle Query-Parameter verwendet.

Hinweis: Sie können einen Query-Parameter nicht global machen (z. B. einen API-Schlüssel) und ihn bei allen Anfragen verwenden. Sie müssen den Query-String-Parameter jeder Anfrage einzeln hinzufügen, in der URL oder im Feld Query-Parameter.

Warum das Feld Query-Parameter statt der URL verwenden

Beide Ansätze funktionieren und landen als dieselbe verkettete Anfrage, eignen sich aber für unterschiedliche Situationen. Parameter direkt in die URL zu tippen ist am schnellsten, wenn sie statisch und kurz sind, wie eine Seiten-ID oder ein Locale-Flag. Das Feld Query-Parameter, das Sie unter den erweiterten Optionen einer Anfrage neben Headern, POST-Body und Cookies finden, ist leichter zu lesen und zu bearbeiten, sobald Sie mehrere Parameter haben, und hält die Basis-URL sauber, was wichtig ist, wenn Sie Anfragen vergleichen oder Testergebnisse auf einen Blick lesen.

Häufige Fallstricke

• Sonderzeichen müssen codiert werden. Leerzeichen, & und andere reservierte Zeichen innerhalb eines Werts müssen URL-codiert werden (ein Leerzeichen als %20 oder +, ein & als %26), sonst wird die Anfrage als zusätzliche, nicht beabsichtigte Parameter oder als fehlerhafte URL geparst.
• Keine globalen oder gemeinsam genutzten Parameter. Wie oben erwähnt, erlaubt LoadFocus es nicht, einen Query-Parameter einmal zu definieren und auf jede Anfrage im Test anzuwenden. Wenn jede Anfrage denselben API-Schlüssel oder dasselbe Token als Query-Parameter benötigt, müssen Sie ihn jeder Anfrage einzeln hinzufügen, in der URL oder im Feld Query-Parameter.
• Doppelte Schlüssel an beiden Stellen. Wenn Sie query1=value1 in die URL setzen und zusätzlich einen Eintrag query1 im Feld Query-Parameter hinzufügen, werden beide gesendet, da die beiden Quellen verkettet statt zusammengeführt oder dedupliziert werden. Achten Sie darauf, wenn Sie eine URL kopieren, die bereits Parameter enthält, und dann weitere über das Feld hinzufügen.
• Die Reihenfolge muss nicht zwingend eine Rolle spielen, prüfen Sie aber Ihre API. Die meisten APIs behandeln Query-Parameter als ungeordnete Menge, aber wenn Ihre API sie positionsabhängig parst oder Eigenheiten bei wiederholten Schlüsseln hat, testen Sie genau die Anfragestruktur, die Sie in der Produktion erwarten.

Ein praktisches Beispiel

Das Testen eines paginierten Such-Endpunkts könnte in der URL so aussehen:

https://api.example.com/v2/search?q=laptop&page=1&sort=price_asc

Wenn Sie Varianten derselben Anfrage mit unterschiedlichen Seitenzahlen über einen Testplan hinweg ausführen, macht es das Verschieben von page in das Feld Query-Parameter auf einen Blick deutlich, welcher Wert sich zwischen den Anfragen ändert, ohne dass Sie jedes Mal den gesamten URL-String durchsuchen müssen.