Chcete-li obdržet tělo JSON požadavku v FastAPI, deklarujete parametr funkce typizovaný jako model Pydantic. FastAPI přečte tělo, parsuje JSON, ověří jej podle modelu a předá vám typizovaný objekt — automaticky.
pydantic BaseModel
():
name:
price:
description: | =
():
{: item.name, : item.price * }
// request body the client sends:
{ "name": "Phone", "price": 999.0 }
Deklarace item: Item říká FastAPI, aby přečetlo tělo požadavku jako JSON, parsovalo je na Item a ověřilo je — vaše funkce obdrží typizovaný, platný objekt. Špatný vstup je automaticky odmítnut:
// POST { "name": "Phone" } (missing price) → automatic 422:
{ "detail": [{ "loc": ["body", "price"], "msg": "field required" }] }
@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 inteligentně směruje parametry: zástupný symbol cesty → parametr cesty, model Pydantic → tělo požadavku, jednoduchý typizovaný parametr → parametr dotazu.
@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
Příjímání a ověřování těl požadavků je nezbytné — téměř každé API, které vytváří nebo aktualizuje data, jej potřebuje, a FastAPI to činí pozoruhodně čistým: deklarace parametru modelu Pydantic vám dává automatické parsování JSON, úplné ověřování (s jasnými chybami 422 na úrovni pole) a typizovaný objekt, což eliminuje únavné, chybovné ruční parsování a ověřování, které vyžadují ostatní frameworky.
Ověřování je také klíčovou výhodou bezpečnosti/robustnosti — poškozený vstup je odmítnut dříve, než dosáhne vaší logiky.
Pochopení toho, jak definovat model těla, jak FastAPI automaticky rozlišuje tělo od parametrů cesty/dotazu a vzory jako exclude_unset pro částečné aktualizace, je základní každodenní znalostí pro vytváření jakéhokoli koncového bodu zápisu.