Co jsou modely Pydantic v FastAPI?

Question

Accepted Answer

**Modely Pydantic** jsou třídy (podtřídící `BaseModel`), které definují **strukturu, typy a pravidla ověřování** pro data. FastAPI je používá všude — pro těla požadavků, tvary odpovědí a nastavení — což je činí jádrem jeho návrhu řízeného typy.

## Definování modelu

```python
from pydantic import BaseModel, EmailStr, Field

class User(BaseModel):
    name: str
    email: EmailStr                          # validates email format
    age: int = Field(ge=0, le=120)            # constraint: 0 <= age <= 120
    is_active: bool = True                    # default value
    tags: list[str] = []                      # typed list with a default
```

Každé pole deklaruje typ a volitelné omezení/výchozí hodnoty. Pydantic ověřuje data proti této definici a konvertuje typy tam, kde je to rozumné.

## Automatické ověřování a parsování

```python
@app.post("/users")
def create_user(user: User):                  # FastAPI builds & validates a User from the body
    return user                               # already validated here
# valid JSON → a typed User object; invalid → automatic 422 with field-level errors
```

Pokud je použit jako typ parametru, FastAPI analyzuje tělo požadavku JSON do modelu, **ověřuje** každé pole a vrací strukturovanou chybu 422 s přesným výčtem, co je špatně — vše automaticky.

## Co vám Pydantic dává

```text
✓ Validation — type checks + constraints (lengths, ranges, formats), clear errors
✓ Parsing/coercion — "5" → 5, ISO string → datetime, etc.
✓ Serialization — model.model_dump() / model_dump_json() → dict/JSON
✓ Editor support — full autocomplete & type checking on model attributes
✓ Self-documenting — the model defines the schema used in the auto-generated docs
```

## Jediný zdroj pravdy

```text
One Pydantic model drives: request validation, the response schema, the OpenAPI docs,
and typed access in your code → define the data shape ONCE.
```

## Proč je to důležité

Modely Pydantic jsou základním kamenem FastAPI — tímto způsobem definujete a ověřujete data, která vaše API přijímá a vrací, a téměř všechny funkce FastAPI jimi procházejí.

Rozumět jim je nezbytné, protože poskytují automatické **ověřování** (kritické pro bezpečnost a robustnost — nikdy nedůvěřovat nezpracovanému vstupu), parsování/konverzi, serializaci a podporu editoru, vše z jedné deklarativní třídy.

Slouží jako **jediný zdroj pravdy**: jeden model řídí ověřování požadavku, tvar odpovědi a automaticky generovanou dokumentaci.

Tento přístup řízený typy a ověřovaný ve výchozím nastavení — získání robustního ověřování vstupu a jasných chybových zpráv v zásadě zdarma — je hlavní důvod, proč je FastAPI tak produktivní a bezpečné, což činí modely Pydantic základními, nezbytně ovládanými znalostmi.