Sorğu parametrləri (query) nədir?

Sorğu parametrləri (query parameters) — bu, ? işarəsindən sonra URL-ə əlavə olunan açar-dəyər cütləridir. Onlar HTTP sorğuları zamanı (ən çox GET) serverə əlavə məlumat ötürmək üçün istifadə olunur.

Sorğu parametrləri ilə URL nümunəsi: https://example.com/api/items?category=electronics&sort=price_asc

Burada:

• category=electronics — ilk parametr, açar category, dəyər electronics.
• sort=price_asc — ikinci parametr, açar sort, dəyər price_asc.
• Parametrlər & ilə ayrılır.

Sorğu parametrlərinin məqsədləri:

• Məlumatların filtrlənməsi: Məlumatların müəyyən meyarlara görə seçilməsi.
• Məlumatların sıralanması: Alınan məlumatların sıralama qaydasını müəyyən etmək.
• Səhifələmə: Səhifə nömrəsini və elementlərin sayını göstərmək.
• İdentifikasiya məlumatlarının ötürülməsi: Resurs və ya istifadəçi identifikasiyası.
• Server üçün əlavə göstərişlər: Məsələn, cavabda hansı sahələrin göstəriləcəyini.

Server tərəfində, tətbiq bu parametrləri analiz edir və cavabı formalaşdırmaq üçün istifadə edir.

Test avtomatlaşdırmasında, sorğu parametrləri tez-tez istifadə olunur:

• Test məlumatlarının müxtəlif şərtlərlə yaradılması üçün.
• API-nin məntiqini müxtəlif girişlərlə yoxlamaq üçün.
• Backend-də filtrləmə, sıralama və səhifələməni test etmək üçün.

Python-da requests kitabxanası ilə sorğu parametrlərinin istifadəsi nümunəsi:

# Parametrlərlə GET sorğusu göndərmək
import requests

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

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

# Status kodunu yoxlamaq
print(f"Status kodu: {response.status_code}")

# Alınan parametrləri göstərmək
print(f"Alınan parametrlər: {response.json().get('args')}")