Oltre al controllo dei tipi, FastAPI ti permette di aggiungere vincoli ai parametri path/query e ai campi del modello usando Query, Path e Field — applicando regole come lunghezza, intervalli e pattern, con errori 422 automatici e documentazione quando violati.
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() e Path() aggiungono vincoli ai parametri query e path. I più comuni: min_length/max_length (stringhe), ge/gt/le/lt (numeri), pattern (regex). Le violazioni producono automaticamente un errore 422 chiaro.
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")
Gli stessi vincoli si applicano ai campi del modello via Field(), validando i corpi delle richieste. Tipi specializzati (EmailStr, HttpUrl, UUID) validano i formati.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Ogni vincolo che dichiari si riflette anche nella documentazione OpenAPI, così i consumatori vedono le regole.
Aggiungere vincoli di validazione è importante sia per sicurezza/robustezza che per un buon design delle API — dichiarando regole (limiti di lunghezza, intervalli numerici, pattern regex, tipi di formato) assicuri che l'input malformato o malevolo sia rifiutato con errori chiari prima di raggiungere la tua logica, il che è essenziale poiché non devi mai fidarti dell'input grezzo.
FastAPI rende questo dichiarativo e senza sforzo: i vincoli Query/Path/Field sono validati automaticamente (producendo errori 422 strutturati) e simultaneamente documentati nella documentazione API, quindi le regole sono applicate e comunicate da una singola dichiarazione.
Conoscere i vincoli comuni e i tipi di validazione specializzati è conoscenza quotidiana per costruire endpoint sicuri e ben definiti — è il modo in cui vai oltre il controllo dei tipi di base per applicare le regole di business effettive che i tuoi dati devono soddisfare.