Πώς λαμβάνετε ένα σώμα αιτήματος JSON;

Question

Accepted Answer

Για να λάβετε ένα σώμα αιτήματος JSON στο FastAPI, δηλώνετε μια παράμετρο συνάρτησης που πληκτρολογείται ως **μοντέλο Pydantic**. Το FastAPI διαβάζει το σώμα, αναλύει το JSON, το επικυρώνει έναντι του μοντέλου και σας μεταφέρει ένα δακτυλογραφημένο αντικείμενο — αυτόματα.

## Το μοτίβο

```python
from pydantic import BaseModel

class Item(BaseModel):
    name: str
    price: float
    description: str | None = None      # optional field

@app.post("/items")
def create_item(item: Item):             # `item: Item` → read & validate the JSON body
    # `item` is a fully-validated Item object here
    return {"name": item.name, "total": item.price * 1.1}
```

```json
// request body the client sends:
{ "name": "Phone", "price": 999.0 }
```

Η δήλωση `item: Item` λέει στο FastAPI να διαβάσει το σώμα του αιτήματος ως JSON, να το αναλύσει σε ένα `Item` και να το **επικυρώσει** — η συνάρτησή σας λαμβάνει ένα δακτυλογραφημένο, έγκυρο αντικείμενο. Η κακή είσοδος απορρίπτεται αυτόματα:

```json
// POST { "name": "Phone" }  (missing price) → automatic 422:
{ "detail": [{ "loc": ["body", "price"], "msg": "field required" }] }
```

## Σώμα + διαδρομή + ερώτημα μαζί

```python
@app.put("/items/{item_id}")
def update(item_id: int, item: Item, notify: bool = False):
    # item_id = path param, item = JSON body (Pydantic model), notify = query param
    # FastAPI distinguishes them by type/location automatically
```

Το FastAPI δρομολογεί ευφυώς τις παραμέτρους: ένας κράτηση θέσης διαδρομής → παράμετρος διαδρομής, ένα μοντέλο Pydantic → σώμα αιτήματος, μια απλή παράμετρος με τύπο → παράμετρος ερωτήματος.

## Πολλές παράμετροι σώματος / μερικές ενημερώσεις

```python
@app.patch("/items/{id}")
def patch(id: int, item: ItemUpdate):       # use a model with all-optional fields for PATCH
    update_data = item.model_dump(exclude_unset=True)   # only fields the client sent
```

## Γιατί σημαίνει

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

Η επικύρωση είναι επίσης ένα βασικό όφελος **ασφάλειας/ευρωστίας** — η κακώς διαμορφωμένη είσοδος απορρίπτεται πριν φτάσει στη λογική σας.

Η κατανόηση του τρόπου ορισμού ενός μοντέλου σώματος, του τρόπου με τον οποίο το FastAPI διακρίνει αυτόματα το σώμα από τις παραμέτρους διαδρομής/ερωτήματος και τα μοτίβα όπως `exclude_unset` για μερικές ενημερώσεις είναι θεμελιώδης καθημερινή γνώση για την κατασκευή οποιουδήποτε τελικού σημείου εγγραφής.