Πώς λειτουργούν οι παράμετροι διαδρομής και ερώτησης;

Question

Accepted Answer

Το FastAPI εξάγει **παράμετροι διαδρομής** (μέρος της διαδρομής URL) και **παράμετροι ερώτησης** (μετά το `?`) από τα ορίσματα συνάρτησης, χρησιμοποιώντας υποδείξεις τύπου για αυτόματη μετατροπή και επικύρωση.

## Παράμετροι διαδρομής — μέρος του URL

```python
@app.get("/items/{item_id}")        # {item_id} in the path
def get_item(item_id: int):          # matched by NAME; `int` converts & validates
    return {"item_id": item_id}
# GET /items/5 → item_id = 5 (int).  GET /items/abc → 422 error (not an int)
```

Μια παράμετρος συνάρτησης της οποίας το όνομα ταιριάζει ένα `{placeholder}` στη διαδρομή γίνεται **παράμετρος διαδρομής**. Η υπόδειξη τύπου (`int`) μετατρέπει αυτόματα τη συμβολοσειρά από το URL και επιστρέφει ένα ξεκάθαρο σφάλμα 422 εάν δεν ταιριάζει.

## Παράμετροι ερώτησης — όλα τα υπόλοιπα

```python
@app.get("/items")
def list_items(skip: int = 0, limit: int = 10, q: str | None = None):
    # parameters NOT in the path become QUERY parameters
    # GET /items?skip=20&limit=5&q=phone → skip=20, limit=5, q="phone"
    return {"skip": skip, "limit": limit, "q": q}
```

Οι παράμετροι συνάρτησης που **δεν** είναι στη διαδρομή γίνονται **παράμετροι ερώτησης**. Μια προεπιλεγμένη τιμή τις κάνει προαιρετικές (`skip: int = 0`); `str | None = None` κάνει μια ακυρώσιμη προαιρετική παράμετρο ερώτησης. Χωρίς προεπιλεγμένη τιμή, είναι υποχρεωτικές.

## Υποχρεωτικό vs προαιρετικό

```python
def search(q: str):              # REQUIRED query param (no default) → ?q=... must be present
def search(q: str = ""):          # optional, defaults to ""
def search(q: str | None = None): # optional, defaults to None
```

## Συνδυασμός και των δύο

```python
@app.get("/users/{user_id}/items")
def user_items(user_id: int, limit: int = 10):
    # user_id = path param, limit = query param — distinguished by the path
```

## Γιατί έχει σημασία

Οι παράμετροι διαδρομής και ερώτησης είναι το πώς τα τελικά σημεία λαμβάνουν είσοδο από το URL — θεμελιώδες για σχεδόν κάθε διαδρομή API (λήψη ενός πόρου με id, φιλτράρισμα, σελιδοποίηση, αναζήτηση).

Η προσέγγιση του FastAPI είναι κομψή και μια βασική αιτία της παραγωγικότητάς του: απλώς με την ανακοίνωση παραμέτρων συνάρτησης με τύπο σας δίνει αυτόματη εξαγωγή, **μετατροπή τύπου**, **επικύρωση** (με ξεκάθαρα σφάλματα 422 σε κακή είσοδο) και υποχρεωτική-έναντι-προαιρετική σημασιολογία (μέσω προεπιλεγμένων τιμών) — όλα προερχόμενα από τυπικές υποδείξεις τύπου Python, χωρίς χειροκίνητη ανάλυση.

Η κατανόηση της διάκρισης (οι παράμετροι διαδρομής προέρχονται από `{placeholders}`, όλα τα υπόλοιπα είναι παράμετρος ερώτησης) και πώς οι προεπιλεγμένες τιμές ελέγχουν την προαιρετικότητα είναι ουσιαστική καθημερινή γνώση για την κατασκευή τελικών σημείων FastAPI.