Verder dan typechecking biedt FastAPI je de mogelijkheid om beperkingen toe te voegen aan path/query-parameters en modelvelden met behulp van Query, Path en Field — het afdwingen van regels zoals lengte, bereiken en patronen, met automatische 422-fouten en documentatie bij schending.
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() en Path() voegen beperkingen toe aan query- en path-parameters. Veel voorkomende: min_length/max_length (strings), ge/gt/le/lt (nummers), pattern (regex). Schendingen produceren automatisch een duidelijke 422-fout.
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")
Dezelfde beperkingen gelden voor modelvelden via Field(), validatie van request bodies. Gespecialiseerde typen (EmailStr, HttpUrl, UUID) valideren formaten.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Elke beperking die je declareert, wordt ook weerspiegeld in de OpenAPI-documentatie, zodat consumenten de regels zien.
Het toevoegen van validatiebeperkingen is belangrijk voor zowel beveiliging/robuustheid als goed API-ontwerp — het declareren van regels (lengtebeperkingen, numerieke bereiken, regex-patronen, formaattypes) zorgt ervoor dat onwelgevormd of kwaadwillend invoer wordt afgewezen met duidelijke fouten voordat het je logica bereikt, wat essentieel is omdat je nooit rauwe invoer mag vertrouwen.
FastAPI maakt dit declaratief en moeiteloos: Query/Path/Field-beperkingen worden automatisch gevalideerd (waarbij gestructureerde 422-fouten ontstaan) en tegelijkertijd gedocumenteerd in de API-documenten, zodat de regels worden afgedwongen en gecommuniceerd vanaf één enkele declaratie.
Het kennen van de veel voorkomende beperkingen en gespecialiseerde validatietypen is alledaagse kennis voor het bouwen van veilige, goed gedefinieerde eindpunten — het is hoe je verder gaat dan basistype-controle om de werkelijke bedrijfsregels af te dwingen die je gegevens moeten satisfiëren.