Cilat janë modelet Pydantic në FastAPI?

Question

Accepted Answer

**Modelet Pydantic** janë klasa (që trashëgojnë nga `BaseModel`) të cilat përcaktojnë **strukturën, tipet dhe rregullat e validimit** për të dhënat. FastAPI i përdor ato kudo — për trupat e kërkesave, format e përgjigjeve dhe cilësimet — duke i bërë ato zemrën e dizajnit të tij të drejtuar nga tipi.

## Përcaktimi i një modeli

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

Çdo fushë deklarohet me një tip dhe kufizime/parazgjedhje opcionale. Pydantic validizon të dhënat kundrejt këtij përcaktimi dhe konverton tipet kur është e arsyeshme.

## Validim dhe analizim automatik

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

Kur përdoret si lloj parametri, FastAPI analizon trupin e kërkesës JSON në model, **validizon** çdo fushë dhe kthen një gabim të strukturuar 422 që liston saktësisht se çfarë është gabim — gjithçka automatike.

## Çfarë të jep Pydantic

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

## Një burim i vetëm i të vërtetës

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

## Pse është e rëndësishme

Modelet Pydantic janë themeli i FastAPI — ato janë mënyra se si përcaktoni dhe validizoni të dhënat që API juaj pranon dhe kthen, dhe pothuajse çdo veçori e FastAPI kalon përmes tyre.

Komprehensioni i tyre është thelbësor sepse ofrojnë validim automatik **(kritik për sigurinë dhe qëndrueshmërinë — kurrë të mos besohet në inputin e papërpunuar)**, analizim/koercim, serijalizim dhe suport redaktori, të gjitha nga një klasë deklarative.

Ata shërbejnë si **burim i vetëm i të vërtetës**: një model lëviz validimin e kërkesës, formën e përgjigjes dhe dokumentacionin e gjeneruar automatikisht.

Ky qasje e drejtuar nga tipi, validim-sipas-parazgjedhjes — marrja e validimit robust të inputit dhe mesazheve të qarta gabimi në thelb për të lira — është arsyeja kryesore pse FastAPI është kaq produktiv dhe i sigurt, duke bërë modelet Pydantic njohuritë themelore, të detyrueshme për të zotëruar.