Kako prejmeš telo JSON zahteve?

Question

Accepted Answer

Če želiš prejeti telo JSON zahteve v FastAPI, deklariraj parameter funkcije tipa **Pydantičnega modela**. FastAPI prebere telo, razčleni JSON, ga preveri glede na model in ti posreči tip objekta — avtomatično.

## Vzorec

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

Deklaracija `item: Item` pove FastAPI, da prebere telo zahteve kot JSON, ga razčleni v `Item` in ga **validira** — tvoja funkcija prejme tip-validen objekt. Slaba vhodna podatka se avtomatično zavrneta:

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

## Telo + pot + poizvedovanje skupaj

```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 pametno usmerja parametre: označevalec poti → parameter poti, Pydantični model → telo zahteve, parameter preprostega tipa → parameter poizvedovanja.

## Več parametrov telesa / delne posodobitve

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

## Zakaj je to pomembno

Prejemanje in validacija telesa zahteve je bistvena — skoraj vsak API, ki ustvari ali posodabi podatke, jo potrebuje, in FastAPI jo naredi izjemno preprosto: deklaracija Pydantičnega-modelnega parametra ti da avtomatično razčlenjevanje JSON, popolno **validacijo** (s jasnimi napakami na ravni polja 422) in tip objekt, kar izbriše dolgočasno, napako-nagnjeno ročno razčlenjevanje in validacijo, ki jo zahtevajo drugi okviri.

Validacija je tudi ključna prednost za **varnost/robustnost** — napačno oblikovan vhod se zavrne, preden doseže tvojo logiko.

Razumevanje, kako definirati model telesa, kako FastAPI avtomatično razlikuje telo od parametrov poti/poizvedovanja in vzorce, kot je `exclude_unset` za delne posodobitve, je temeljno vsakodnevno znanje za gradnjo katerega koli končnega točka pisanja.