Kako primate JSON tijelo zahtjeva?

Question

Accepted Answer

Za primanje JSON tijela zahtjeva u FastAPI-ju, deklarirte parametar funkcije tipiziran kao **Pydantic model**. FastAPI čita tijelo, parsira JSON, validira ga prema modelu i prosleđuje vam tipiziranu instancu — automatski.

## Obrazac

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

Deklariranje `item: Item` govori FastAPI-ju da pročita tijelo zahtjeva kao JSON, parsira ga u `Item`, i **validira** ga — vaša funkcija prima tipiziranu, validnu instancu. Pogrešan unos se automatski odbacuje:

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

## Tijelo + putanja + upit zajedno

```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 inteligentno usmjerava parametre: placeholder putanje → parametar putanje, Pydantic model → tijelo zahtjeva, jednostavno tipiziran parametar → parametar upita.

## Više parametara tijela / dijelomična ažuriranja

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

## Zašto je to važno

Primanje i validacija tijela zahtjeva je bitna — gotovo svaki API koji kreira ili ažurira podatke trebao bi je, a FastAPI to čini izvanredno čistim: deklariranje parametra Pydantic modela daje vam automatsku JSON analizu, potpunu **validaciju** (s jasnim greškama 422 na razini polja), i tipiziranu instancu, eliminirajući mukotrpnu, sklonu greškama ručnu analizu i validaciju koju zahtijevaju drugi okviri.

Validacija je također ključna pogodnost za **sigurnost/robusnost** — malformirani unos se odbacuje prije nego što dođe do vaše logike.

Razumijevanje kako definirati model tijela, kako FastAPI automatski razlikuje tijelo od parametara putanje/upita, i obrazce poput `exclude_unset` za dijelomična ažuriranja je temeljno svakodnevno znanje za građenje bilo koje krajnje točke upisa.