Kaj so Pydantic modeli v FastAPI?

Question

Accepted Answer

**Pydantic modeli** so razredi (dedovanje od `BaseModel`), ki definirajo **strukturo, tipe in pravila validacije** za podatke. FastAPI jih uporablja povsod — za telesa zahtevkov, oblike odgovorov in nastavitve — kar jih naredi jedro njegovega tipsko usmerjenega načrta.

## Definiranje modela

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

Vsako polje deklarira tip in izbirne omejitve/privzete vrednosti. Pydantic validira podatke glede na to definicijo in pretvori tipe tam, kjer je to smiselno.

## Avtomatska validacija in razčlenitev

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

Ko se uporablja kot tip parametra, FastAPI razčleni telo zahtevka JSON v model, **validira** vsako polje in vrne strukturirano napako 422, ki natančno naveduje, kaj je narobe — vse avtomatsko.

## Kaj vam Pydantic daje

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

## Enoten vir resnice

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

## Zakaj je to pomembno

Pydantic modeli so temeljni kamen FastAPI — to je način, kako definirate in validirate podatke, ki jih vaš API sprejema in vrača, in skoraj vsaka funkcija FastAPI poteka skozi njih.

Razumevanje je bistveno, ker zagotavljajo avtomatsko **validacijo** (kritično za varnost in robustnost — nikoli ne zaupanje neobdelanim vhodom), razčlenjevanje/prisilno pretvorbo, serializacijo in podporo urejevalnika, vse iz ene deklarativne razrede.

Služijo kot **enoten vir resnice**: en model poganja validacijo zahtevka, obliko odgovora in avtomatsko generirano dokumentacijo.

Ta tipsko usmerjen pristop, preveriti po privzeti nastavki — pridobitev robustne validacije vnosa in jasnih sporočil o napakah praktično brezplačno — je glavni razlog, da je FastAPI tako produktiven in varen, kar naredi Pydantic modele temeljno, nujno znanje.