Ի՞նչ են հարցման պարամետրերը (query):

Հարցման պարամետրերը (query parameters) այն զույգեր են, որոնք բանալին-արժեքի ձևով ավելացվում են URL- ից հետո ? նշանի։ Դրանք օգտագործվում են լրացուցիչ տեղեկատվություն փոխանցելու համար սերվերին HTTP-հայցերի ժամանակ (հաճախ GET)։

Հարցման պարամետրերով URL-ի օրինակ՝ https://example.com/api/items?category=electronics&sort=price_asc

Այստեղ՝

• category=electronics — առաջին պարամետր, բանալի category, արժեք electronics։
• sort=price_asc — երկրորդ պարամետր, բանալի sort, արժեք price_asc։
• Պարամետրերը բաժանվում են & նշանով։

Հարցման պարամետրերի նպատակները՝

• Տվյալների ֆիլտրում: Տվյալների ընտրություն որոշ չափանիշներով։
• Տվյալների դասավորում: Տվյալների ստացման կարգը որոշել։
• Էջավորում (pagination): Նշել էջի համարն ու տարրերի քանակը էջում։
• Նշանակման նույնականացուցիչների փոխանցում: Ռեսուրսի կամ օգտվողի նույնականացում։
• Լրացուցիչ ցուցումներ սերվերին: Օրինակ՝ որ դաշտերը վերադարձնել։

Սերվերի կողմում, հավելվածը վերլուծում է այս պարամետրերը և օգտագործում է դրանք պատասխան կազմելու համար։

Անհատականացման փորձարկումներում, հարցման պարամետրերը հաճախ օգտագործվում են՝

• Փորձնական տվյալներ տարբեր պայմաններով ստեղծելու համար։
• API-ի տրամաբանությունը ստուգելու համար տարբեր մուտքերով։
• Բեկենդում ֆիլտրում, դասավորում և էջավորում փորձարկելու համար։

Python-ում requests գրադարանի հետ հարցման պարամետրերի օգտագործման օրինակ՝

# GET հարցում պարամետրերով
import requests

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

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

# Կոդի ստատուսը ստուգել
print(f"Կոդը՝ {response.status_code}")

# Ստացված պարամետրերը ցույց տալ
print(f"Ստացված պարամետրեր՝ {response.json().get('args')}")