Πέρα από τον έλεγχο τύπου, το FastAPI σας επιτρέπει να προσθέσετε περιορισμούς σε παραμέτρους διαδρομής/ερωτήματος και πεδία μοντέλου χρησιμοποιώντας Query, Path και Field — επιβολή κανόνων όπως μήκος, εύρη και μοτίβα, με αυτόματα σφάλματα 422 και τεκμηρίωση κατά την παραβίαση.
from fastapi import Query, Path
@app.get("/items")
def search(
q: str = Query(min_length=3, max_length=50), # string length bounds
page: int = Query(default=1, ge=1), # >= 1
limit: int = Query(default=10, ge=1, le=100), # 1 <= limit <= 100
code: str = Query(pattern=r"^[A-Z]{3}$"), # regex pattern
):
...
@app.get("/items/{item_id}")
def get(item_id: int = Path(ge=1)): # path param must be >= 1
...
Query() και Path() προσθέτουν περιορισμούς σε παραμέτρους ερωτήματος και διαδρομής. Κοινοί: min_length/max_length (συμβολοσειρές), ge/gt/le/lt (αριθμοί), pattern (regex). Οι παραβιάσεις δημιουργούν αυτόματα ένα σαφές σφάλμα 422.
from pydantic import BaseModel, Field, EmailStr
class User(BaseModel):
name: str = Field(min_length=1, max_length=100)
age: int = Field(ge=0, le=120)
email: EmailStr # format validation via a type
bio: str = Field(default="", max_length=500, description="User bio")
Οι ίδιοι περιορισμοί ισχύουν για πεδία μοντέλου μέσω Field(), επικύρωση σωμάτων αιτημάτων. Εξειδικευμένοι τύποι (EmailStr, HttpUrl, UUID) επικυρώνουν μορφές.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Κάθε περιορισμός που δηλώνετε αντικατοπτρίζεται επίσης στην τεκμηρίωση OpenAPI, ώστε οι καταναλωτές να δουν τους κανόνες.
Η προσθήκη περιορισμών επικύρωσης είναι σημαντική τόσο για ασφάλεια/ευρωστία όσο και για καλό σχεδιασμό API — η δήλωση κανόνων (όρια μήκους, αριθμητικά εύρη, μοτίβα regex, τύποι μορφής) διασφαλίζει ότι η παραμορφωμένη ή κακόβουλη είσοδος απορρίπτεται με σαφή σφάλματα πριν φτάσει στη λογική σας, κάτι που είναι απαραίτητο καθώς δεν πρέπει ποτέ να εμπιστεύεστε την ακατέργαστη είσοδο.
Το FastAPI το κάνει δηλωτικό και χωρίς προσπάθεια: οι περιορισμοί Query/Path/Field επικυρώνονται αυτόματα (παράγουν δομημένα σφάλματα 422) και τεκμηριώνονται ταυτόχρονα στα έγγραφα API, επομένως οι κανόνες επιβάλλονται και επικοινωνούνται από μια μόνο δήλωση.
Η γνώση των κοινών περιορισμών και εξειδικευμένων τύπων επικύρωσης είναι καθημερινή γνώση για την κατασκευή ασφαλών, καλά καθορισμένων τελικών σημείων — είναι ο τρόπος με τον οποίο ξεπερνάτε τον βασικό έλεγχο τύπου για να επιβάλετε τους πραγματικούς κανόνες επιχειρήσεων που πρέπει να ικανοποιούν τα δεδομένα σας.