Mis on päringupäringud (query)?

Päringutingimused (query parameters) on võtme-väärtuse paarid, mis lisatakse URL-ile pärast märki ?. Need kasutatakse täiendava teabe edastamiseks serverile HTTP-päringute ajal (enamasti GET).

Näide URL-ist päringutingimustega: https://example.com/api/items?category=electronics&sort=price_asc

Siin:

• category=electronics — esimene parameeter, võti category, väärtus electronics.
• sort=price_asc — teine parameeter, võti sort, väärtus price_asc.
• Parameetrid eraldatakse ampersandiga (&).

Päringutingimuste eesmärk:

• Andmete filtreerimine: Andmete valimine teatud kriteeriumide järgi.
• Andmete sorteerimine: Määrata saadavate andmete järjestus.
• Leheküljevaikimine (pagination): Näidata lehekülje number ja elementide arv lehel.
• Identifikaatorite edastamine: Ressursi või kasutaja identifitseerimine.
• Täiendavad juhised serverile: Näiteks, milliseid välju tagastada vastuses.

Serveri poolel parsivad rakendused need parameetrid ja kasutavad neid vastuse koostamiseks.

Automatiseeritud testimisel kasutatakse päringutingimusi sageli:

• Testandmete genereerimiseks erinevate tingimustega.
• API loogika kontrollimiseks erinevate sisendandmetega.
• Filtreerimise, sorteerimise ja leheküljevaikimise testimiseks backendis.

Näide päringutingimuste kasutamisest Pythonis requests raamatukoguga:

# GET-päringu saatmine parameetritega
import requests

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

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

# Staatuskoodi kontroll
print(f"Staatuskood: {response.status_code}")

# Saadud parameetrite väljastamine
print(f"Saadud parameetrid: {response.json().get('args')}")