Ud over typekontrol giver FastAPI dig mulighed for at tilføje begrænsninger til sti-/forespørgselsparametre og modelfelter ved hjælp af Query, Path og Field — håndhæve regler som længde, områder og mønstre, med automatiske 422-fejl og dokumentation ved overtrædelse.
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() og Path() tilføjer begrænsninger til forespørgsels- og stiparametre. Almindelige: min_length/max_length (strenge), ge/gt/le/lt (tal), pattern (regex). Overtrædelser producerer automatisk en klar 422-fejl.
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")
De samme begrænsninger gælder for modelfelter via Field(), validering af anmodningskroppe. Specialiserede typer (EmailStr, HttpUrl, UUID) validerer formater.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Hver begrænsning, du erklærer, afspejles også i OpenAPI-dokumentationen, så forbrugere ser reglerne.
Tilføjelse af valideringsbegrænsninger er vigtig for både sikkerhed/robusthed og god API-design — erklæring af regler (længdegrænser, numeriske områder, regex-mønstre, formattyper) sikrer, at deformeret eller ondsindet input afvises med klare fejl før det når din logik, hvilket er vigtig, fordi du aldrig må stole på råinput.
FastAPI gør dette deklarativt og ubesværet: Query/Path/Field-begrænsninger valideres automatisk (producerer strukturerede 422-fejl) og dokumenteres samtidig i API-dokumenterne, så reglerne håndhæves og kommunikeres fra en enkelt erklæring.
At kende almindelige begrænsninger og specialiserede valideringstyper er daglig viden for at bygge sikre, veldefinererede endepunkter — det er sådan, du går ud over grundlæggende typekontrol for at håndhæve de faktiske forretningsregler, som dine data skal opfylde.