Što su Pydantic modeli u FastAPI?

Question

Accepted Answer

**Pydantic modeli** su klase (koje naslijeđuju `BaseModel`) koje definiraju **strukturu, tipove i pravila validacije** za podatke. FastAPI ih koristi posvuda — za tijela zahtjeva, oblike odgovora i postavke — čineći ih srcem svog tipo-usmjeravanog dizajna.

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

Svako polje deklarira tip i opcionalna ograničenja/zadane vrijednosti. Pydantic validira podatke prema toj definiciji i pretvara tipove gdje je to prikladno.

## Automatska validacija i parsiranje

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

Kad se koristi kao vrsta parametra, FastAPI parsira JSON tijelo zahtjeva u model, **validirajući** svako polje i vraćajući strukturiranu grešku 422 koja točno nabraja što ne valja — sve automatski.

## Što 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
```

## Jedan jedini izvor istine

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

## Zašto je to važno

Pydantic modeli su temeljac FastAPl-a — to je način na koji definirate i validirate podatke koje vaš API prihvaća i vraća, a gotovo svaka FastAPI funkcionalnost teče kroz njih.

Neophodno ih razumjeti jer pružaju automatsku **validaciju** (kritična za sigurnost i robusnost — nikad ne vjerujte sirovih unosa), parsiranje/prisilu, serijalizaciju i podršku uregivača, sve iz jedne deklarativne klase.

Služu kao **jedan jedini izvor istine**: jedan model upravlja validacijom zahtjeva, oblikom odgovora i samogenerirane dokumentacije.

Ovaj tipo-usmjeravan, po zadanoj vrijednosti validiran pristup — dobivanje robusne validacije unosa i jasnih poruka o greškama u biti besplatno — veliki je razlog zašto je FastAPI tako produktivan i siguran, čineći Pydantic modele temeljnim znanjem koje je obavezno овладати.