Τι είναι τα μοντέλα Pydantic στο FastAPI;

Question

Accepted Answer

**Τα μοντέλα Pydantic** είναι κλάσεις (που κληρονομούν από `BaseModel`) που ορίζουν τη **δομή, τους τύπους και τους κανόνες επικύρωσης** για τα δεδομένα. Το FastAPI τα χρησιμοποιεί παντού — για σώματα αιτημάτων, σχήματα απαντήσεων και ρυθμίσεις — κάνοντάς τα την καρδιά του σχεδιασμού του που κατευθύνεται από τύπους.

## Ορισμός ενός μοντέλου

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

Κάθε πεδίο δηλώνει έναν τύπο και προαιρετικούς περιορισμούς/προεπιλογές. Το Pydantic επικυρώνει τα δεδομένα σύμφωνα με αυτόν τον ορισμό και μετατρέπει τύπους όπου είναι λογικό.

## Αυτόματη επικύρωση και ανάλυση

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

Όταν χρησιμοποιείται ως τύπος παραμέτρου, το FastAPI αναλύει το σώμα του αιτήματος JSON στο μοντέλο, **επικυρώνοντας** κάθε πεδίο και επιστρέφοντας ένα δομημένο σφάλμα 422 που παραθέτει ακριβώς τι είναι λάθος — όλα αυτόματα.

## Τι σας δίνει το 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
```

## Μία μοναδική πηγή αλήθειας

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

## Γιατί έχει σημασία

Τα μοντέλα Pydantic είναι ο ακρογωνιαίος λίθος του FastAPI — αυτός είναι ο τρόπος με τον οποίο ορίζετε και επικυρώνετε τα δεδομένα που δέχεται και επιστρέφει το API σας, και σχεδόν κάθε δυνατότητα του FastAPI διαρρέει μέσα από αυτά.

Ο κατανόησή τους είναι απαραίτητη επειδή παρέχουν αυτόματη **επικύρωση** (κρίσιμη για την ασφάλεια και την ευρωστία — ποτέ μην εμπιστεύεστε ανεπεξέργαστες εισόδους), ανάλυση/καναλοποίηση, σειριοποίηση και υποστήριξη συντάκτη, όλα από μία μόνο δηλωτική κλάση.

Λειτουργούν ως **μοναδική πηγή αλήθειας**: ένα μοντέλο οδηγεί την επικύρωση αιτήματος, το σχήμα απάντησης και την αυτόματα παραγόμενη τεκμηρίωση.

Αυτή η προσέγγιση που κατευθύνεται από τύπους και επικυρώνει ως προεπιλογή — λήψη ισχυρής επικύρωσης εισόδου και σαφών μηνυμάτων σφάλματος ουσιαστικά δωρεάν — είναι ένας σημαντικός λόγος για τον οποίο το FastAPI είναι τόσο παραγωγικό και ασφαλές, κάνοντας τα μοντέλα Pydantic θεμελιώδες, αναγκαίο-κύρια γνώση.