Mi az a lekérdezési paraméter (query)?

A lekérdezési paraméterek (query parameters) kulcs-érték párok, amelyeket a ? jel után adunk hozzá az URL-hez. Ezeket arra használják, hogy további információkat továbbítsanak a szervernek HTTP-kérések során (leggyakrabban GET).

Példa URL-lekérdezési paraméterekkel: https://example.com/api/items?category=electronics&sort=price_asc

Itt:

• category=electronics — első paraméter, kulcs category, érték electronics.
• sort=price_asc — második paraméter, kulcs sort, érték price_asc.
• A paramétereket & választja el.

A lekérdezési paraméterek céljai:

• Adatok szűrése: Adatok kiválasztása bizonyos kritériumok szerint.
• Adatok rendezése: A kapott adatok sorrendjének meghatározása.
• Oldalazás (pagination): Oldalszám és elemek száma oldalanként.
• Azonosítók továbbítása: Erőforrás vagy felhasználó azonosítása.
• További utasítások a szerver számára: Például, mely mezőket adja vissza a válaszban.

A szerver oldalon az alkalmazás elemzi ezeket a paramétereket, és felhasználja őket a válasz összeállításához.

Automatizált tesztelés során a lekérdezési paramétereket gyakran használják:

• Tesztadatok generálására különböző feltételekkel.
• Az API logikájának ellenőrzésére különböző bemenetekkel.
• Szűrés, rendezés és oldalazás tesztelésére a backenden.

Példa a lekérdezési paraméterek használatára Pythonban a requests könyvtárral:

# GET kérés küldése paraméterekkel
import requests

url = "https://httpbin.org/get"
params = {
    "param1": "value1",
    "param2": "value2"
}

response = requests.get(url, params=params)

# Állapotkód ellenőrzése
print(f"Állapotkód: {response.status_code}")

# Kapott paraméterek megjelenítése
print(f"Kapott paraméterek: {response.json().get('args')}")