Kas yra Pydantic modeliai FastAPI?

Question

Accepted Answer

**Pydantic modeliai** yra klasės (paveldinčios `BaseModel`), kurios apibrėžia duomenų **struktūrą, tipus ir validavimo taisykles**. FastAPI juos naudoja visur — užklausos kūnams, atsakymų formoms ir nustatymams — todėl jie yra jo tipo-nukreipto dizaino širdis.

## Modelio apibrėžimas

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

Kiekvienas laukas deklaruoja tipą ir pasirinktinius apribojimus/numatytas reikšmes. Pydantic validuoja duomenis pagal šį apibrėžimą ir konvertuoja tipus kur tai prasminga.

## Automatinis validavimas ir apdorojimas

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

Kai naudojama kaip parametro tipas, FastAPI analizuoja JSON užklausos kūną į modelį, **validuodamas** kiekvieną lauką ir grąžindamas struktūruotą 422 klaidą, kurioje išvardijama tiksliai kas negerai — viskas automatiškai.

## Ką Pydantic suteikia

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

## Vienas tiesos šaltinis

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

## Kodėl tai svarbu

Pydantic modeliai yra FastAPI pamatas — jie yra tas būdas, kuriuo apibrėžiate ir validuojate duomenis, kuriuos jūsų API priima ir grąžina, o beveik kiekviena FastAPI funkcija per juos veikia.

Jų supratimas yra būtinas, nes jie teikia automatinį **validavimą** (kritišką saugumui ir patikimumui — niekada nepasitikint neapdorotomis duomenimis), apdorojimą/konversiją, serializavimą ir redaktoriaus palaikymą — visa tai iš vienos deklaratyvios klasės.

Jie tarnauja kaip **vienas tiesos šaltinis**: vienas modelis valdo užklausos validavimą, atsakymo formą ir automatiškai sugeneruotą dokumentaciją.

Šis tipo-nukreiptas, pagal numatytuosius nustatymus validuojantis požiūris — iš esmės už velti gauti patikimą įvesties validavimą ir aiškias klaidos žinutes — yra vienas pagrindinių FastAPI produktyvumo ir saugumo priežasčių, todėl Pydantic modeliai yra pagrindiniai, būtini mokytis žinios.