Τι είναι οι παράμετροι ερωτήματος (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 με διαφορετικές εισόδους.
• Δοκιμές φιλτραρίσματος, ταξινόμησης και σελιδοποίησης στο backend.

Παράδειγμα χρήσης παραμέτρων ερωτήματος σε 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')}")