Mitä ovat Pydantic-mallit FastAPI:ssa?

Question

Accepted Answer

**Pydantic-mallit** ovat luokkia (jotka periytyvät `BaseModel`:stä), jotka määrittelevät datan **rakenteen, tyypit ja validointisäännöt**. FastAPI käyttää niitä kaikkialla — pyynnön runkoon, vastauksen muotoihin ja asetuksiin — mikä tekee niistä sen tyyppiohjatun suunnittelun sydämen.

## Mallin määrittäminen

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

Jokainen kenttä ilmoittaa tyypin ja valinnaiset rajoitukset/oletusarvot. Pydantic validoi tiedot tätä määritystä vastaan ja muuntaa tyyppejä järkevissä tapauksissa.

## Automaattinen validointi ja jäsentäminen

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

Kun sitä käytetään parametrityyppinä, FastAPI jäsentää JSON-pyynnön rungon malliksi, **validoi** jokaisen kentän ja palauttaa strukturoidun 422-virheen, joka laskee tarkasti, mikä on vialla — kaikki automaattisesti.

## Mitä Pydantic antaa sinulle

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

## Yksi totuuden lähde

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

## Miksi se on tärkeää

Pydantic-mallit ovat FastAPI:n kulmakivi — ne ovat kuinka määrität ja validoit API:n hyväksymät ja palauttamat tiedot, ja lähes jokainen FastAPI-ominaisuus virtaa niiden läpi.

Niiden ymmärtäminen on olennaista, koska ne tarjoavat automaattisen **validoinnin** (kriittinen turvallisuudelle ja vahvuudelle — älä koskaan luota raakaan syötteeseen), jäsentämisen/pakottamisen, sarjoittamisen ja editorin tuen, kaikki yhdestä deklaratiivisesta luokasta.

Ne toimivat **yhtenä totuuden lähteenä**: yksi malli ohjaa pyyntöjen validointia, vastauksen muotoa ja automaattisesti luotua dokumentaatiota.

Tämä tyyppiohjattu, oletuksena validoiva lähestymistapa — vahvan syötteen validoinnin ja selkeiden virheilmoitusten saaminen pohjimmiltaan ilmaiseksi — on pääsyy siihen, miksi FastAPI on niin tuottava ja turvallinen, mikä tekee Pydantic-malleista keskeistä, pakollista osaamista.