Au-delà de la vérification de type, FastAPI vous permet d'ajouter des contraintes aux paramètres de chemin/requête et aux champs de modèle en utilisant Query, Path et Field — en appliquant des règles telles que la longueur, les plages et les motifs, avec des erreurs 422 automatiques et une documentation en cas de violation.
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() et Path() ajoutent des contraintes aux paramètres de requête et de chemin. Les contraintes courantes : min_length/max_length (chaînes), ge/gt/le/lt (nombres), pattern (regex). Les violations produisent automatiquement une erreur 422 claire.
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")
Les mêmes contraintes s'appliquent aux champs de modèle via Field(), validant les corps de requête. Les types spécialisés (EmailStr, HttpUrl, UUID) valident les formats.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Chaque contrainte que vous déclarez est également reflétée dans la documentation OpenAPI, de sorte que les consommateurs voient les règles.
Ajouter des contraintes de validation est important pour la sécurité/robustesse et une bonne conception d'API — déclarer des règles (limites de longueur, plages numériques, motifs regex, types de format) garantit que les entrées malformées ou malveillantes sont rejetées avec des erreurs claires avant d'atteindre votre logique, ce qui est essentiel puisque vous ne devez jamais faire confiance à l'entrée brute.
FastAPI rend cela déclaratif et sans effort : les contraintes Query/Path/Field sont validées automatiquement (produisant des erreurs 422 structurées) et simultanément documentées dans les docs de l'API, de sorte que les règles sont appliquées et communiquées à partir d'une seule déclaration.
Connaître les contraintes courantes et les types de validation spécialisés est une connaissance quotidienne pour construire des points de terminaison sûrs et bien définis — c'est ainsi que vous allez au-delà de la vérification de type basique pour appliquer les règles métier réelles que vos données doivent satisfaire.