Πώς ορίζετε τις διαδρομές (λειτουργίες διαδρομής);

Question

Accepted Answer

Στο FastAPI, μια **λειτουργία διαδρομής** είναι μια διαδρομή — μια συνάρτηση διακοσμημένη με έναν διακοσμητή HTTP method (`@app.get`, `@app.post` κ.λπ.) που χειρίζεται αιτήματα σε μια διαδρομή. Η τιμή επιστροφής της συνάρτησης σειριοποιείται αυτόματα σε JSON.

## Ορισμός διαδρομών για κάθε HTTP method

```python
from fastapi import FastAPI
app = FastAPI()

@app.get("/items")                # GET /items
def list_items():
    return [{"id": 1}, {"id": 2}]  # dict/list → automatically JSON-serialized

@app.get("/items/{item_id}")      # GET /items/5 — path parameter
def get_item(item_id: int):        # type hint converts "5" → int (and validates)
    return {"id": item_id}

@app.post("/items")               # POST /items
def create_item(item: Item):
    return item

@app.put("/items/{item_id}")      # PUT, PATCH, DELETE work the same way
@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    return {"deleted": item_id}
```

Κάθε διακοσμητής αντιστοιχίζει μια HTTP method + διαδρομή σε έναν χειριστή. Το όνομα της συνάρτησης είναι δικό σας· ο διακοσμητής ορίζει τη διαδρομή. Τα επιστρεφόμενα dicts/lists/Pydantic models σειριοποιούνται αυτόματα σε JSON — χωρίς χειروκίνητο `json.dumps`.

## Η σειρά έχει σημασία για τις επικαλυπτόμενες διαδρομές

```python
@app.get("/users/me")            # ✅ specific route FIRST
def read_me(): ...
@app.get("/users/{user_id}")     # dynamic AFTER — else "me" matches {user_id}
def read_user(user_id: int): ...
```

Το FastAPI ταιριάζει με τις διαδρομές στη σειρά δήλωσης, οπότε τοποθετήστε τις στατικές διαδρομές πριν από τις δυναμικές.

## Μεταδεδομένα λειτουργίας (οδηγεί τα έγγραφα)

```python
@app.get("/items", tags=["items"], summary="List items", status_code=200)
def list_items(): ...
```

Οι παράμετροι διακοσμητή (`tags`, `summary`, `status_code`, `response_model`) διαμορφώνουν τη συμπεριφορά και εμπλουτίζουν την αυτόματα δημιουργημένη τεκμηρίωση.

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

Οι λειτουργίες διαδρομής είναι το θεμέλιο κάθε εφαρμογής FastAPI — ορίζουν τα τελικά σημεία του API σας και τον τρόπο χειρισμού των αιτημάτων.

Η κατανόηση του μοτίβου διακοσμητή-ανά-HTTP-method, ότι οι τιμές επιστροφής σειριοποιούνται αυτόματα σε JSON (χωρίς boilerplate), ότι οι τύποι υπαινιγμών στις παραμέτρους οδηγούν τη μετατροπή και την επικύρωση, και ότι η σειρά διαδρομής έχει σημασία για τις επικαλυπτόμενες διαδρομές είναι ουσιαστική καθημερινή γνώση για την κατασκευή οποιουδήποτε τελικού σημείου.

Τα μεταδεδομένα διακοσμητή τροφοδοτούν επίσης την αυτόματη τεκμηρίωση του FastAPI, συνδέοντας τις διαδρομές απευθείας με τα έγγραφα.

Αυτό είναι το πρώτο και πιο θεμελιακό πράγμα που πρέπει να κατακτήσετε στο FastAPI.