Hogyan fogadja a JSON kérelem törzsét?

Question

Accepted Answer

Egy JSON kérelem törzse FastAPI-ban való fogadásához deklarál egy függvény paramétert, amely egy **Pydantic modellként** van típusozva. A FastAPI beolvassa a törzset, feldolgozza a JSON-t, validálja azt a modellel szemben, és átadja Önnek egy típusozott objektumot — automatikusan.

## A minta

```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 }
```

Az `item: Item` deklarálása azt mondja a FastAPI-nak, hogy olvassa be a kérelem törzsét JSON-ként, dolgozza fel egy `Item`-be, és **validálja** azt — a függvénye egy típusozott, érvényes objektumot kap. A rossz bemenet automatikusan elutasítódik:

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

## Törzs + útvonal + lekérdezés együtt

```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
```

A FastAPI intelligensen irányítja a paramétereket: útvonal helyőrzője → útvonal paraméter, Pydantic modell → kérelem törzse, egyszerűen típusozott paraméter → lekérdezési paraméter.

## Több törzs paraméter / részleges frissítések

```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
```

## Miért fontos ez

A kérelem törzse fogadása és validálása lényeges — szinte minden API, amely adatokat hoz létre vagy frissít, szüksége van rá, és a FastAPI meglepően tisztára készíti: egy Pydantic-modell paraméter deklarálása automatikus JSON feldolgozást, teljes **validálást** (egyértelmű mező szintű 422 hibákkal), és egy típusozott objektumot biztosít, kiküszöbölve a fáradságos, hibára hajlamos kézi feldolgozást és validálást, amelyet más keretrendszerek igényelnek.

A validálás a **biztonság/robusztusság** előnye is — a rosszul formázott bemenet visszautasítódik, mielőtt elérné a logikát.

Annak megértése, hogyan kell egy törzs modellt definiálni, hogyan különbözteti meg a FastAPI automatikusan a törzset az útvonal/lekérdezési paramétereiktől, és a `exclude_unset` módszerekhez hasonló minták a részleges frissítésekhez alapvető mindennapi tudás bármely írási végpont felépítéséhez.