Kas yra užklausos parametrai (query)?

Užklausos parametrai (query parameters) — tai raktas-verčio poros, kurios pridedamos prie URL po ženklo ?. Jie naudojami papildomos informacijos perdavimui serveriui HTTP užklausų metu (dažniausiai GET).

Pavyzdinis URL su užklausos parametrais: https://example.com/api/items?category=electronics&sort=price_asc

Čia:

• category=electronics — pirmas parametras, raktas category, vertė electronics.
• sort=price_asc — antras parametras, raktas sort, vertė price_asc.
• Parametrai atskiriami ampersandu (&).

Užklausos parametrų paskirtis:

• Duomenų filtravimas: Duomenų atranka pagal tam tikrus kriterijus.
• Duomenų rūšiavimas: Nustatyti gautų duomenų tvarką.
• Puslapių naršymas (pagination): Nurodyti puslapio numerį ir elementų skaičių puslapyje.
• Identifikatorių perdavimas: Resurso ar naudotojo identifikavimas.
• Papildomos instrukcijos serveriui: Pavyzdžiui, kokius laukus grąžinti atsakyme.

Serverio pusėje programėlė išskaido šiuos parametrus ir naudoja juos atsakymo formavimui.

Testavimo automatizacijoje užklausos parametrai dažnai naudojami:

• Testinių duomenų generavimui su įvairiomis sąlygomis.
• API logikos tikrinimui su skirtingais įėjimo duomenimis.
• Filtravimo, rūšiavimo ir puslapiavimo testavimui backend'e.

Pavyzdys, kaip naudoti užklausos parametrus Python su requests biblioteka:

# GET užklausos siuntimas su parametrais
import requests

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

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

# Statuso kodo patikra
print(f"Statuso kodas: {response.status_code}")

# Gautų parametrų išvedimas
print(f"Gauti parametrai: {response.json().get('args')}")