Jak otrzymujesz treść żądania JSON?

Question

Accepted Answer

Aby otrzymać treść żądania JSON w FastAPI, deklarujesz parametr funkcji wpisany jako **model Pydantic**. FastAPI odczytuje treść, analizuje JSON, weryfikuje go na podstawie modelu i przekazuje Ci typowany obiekt — automatycznie.

## Wzór

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

Deklaracja `item: Item` mówi FastAPI, aby odczytał treść żądania jako JSON, przeanalizował ją do `Item` i **weryfikował** — Twoja funkcja otrzymuje typowany, ważny obiekt. Zła wejście jest automatycznie odrzucane:

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

## Treść + ścieżka + zapytanie razem

```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 inteligentnie kieruje parametry: symbol zastępczy ścieżki → parametr ścieżki, model Pydantic → treść żądania, parametr o prostym typie → parametr zapytania.

## Wiele parametrów treści / aktualizacje częściowe

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

## Dlaczego to ważne

Otrzymywanie i walidacja treści żądań jest niezbędne — prawie każdy API, który tworzy lub aktualizuje dane, go potrzebuje, a FastAPI czyni to niezwykle czysto: deklaracja parametru modelu Pydantic daje Ci automatyczne parsowanie JSON, pełną **walidację** (z jasnymi błędami na poziomie pola 422) i typowany obiekt, eliminując żmudne, podatne na błędy ręczne parsowanie i walidację, które wymagają inne frameworki.

Walidacja jest również kluczową zaletą **bezpieczeństwa/niezawodności** — źle sformułowane dane wejściowe są odrzucane zanim dotrą do Twojej logiki.

Zrozumienie, jak zdefiniować model treści, jak FastAPI automatycznie rozróżnia treść od parametrów ścieżki/zapytania i wzorów takich jak `exclude_unset` dla aktualizacji częściowych, to fundamentalna codzienна wiedza do tworzenia dowolnego punktu końcowego zapisu.