Utöver typkontroll låter FastAPI dig lägga till begränsningar till sökvägs-/frågeparametrar och modellfält med hjälp av Query, Path och Field — vilket tillämpar regler som längd, intervall och mönster, med automatiska 422-fel och dokumentation när de överträds.
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() och Path() lägger till begränsningar till sökvägs- och frågeparametrar. Vanliga: min_length/max_length (strängar), ge/gt/le/lt (tal), pattern (regex). Överträdelser producerar ett tydligt 422-fel automatiskt.
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 samma begränsningarna gäller modellfält via Field(), vilket validerar förfråningsorgan. Specialiserade typer (EmailStr, HttpUrl, UUID) validerar format.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Varje begränsning du deklarerar återspeglas också i OpenAPI-dokumentationen, så konsumenter ser reglerna.
Att lägga till valideringsbegränsningar är viktigt för både säkerhet/robusthet och bra API-design — att deklarera regler (längdbegränsningar, numeriska intervall, regex-mönster, formattyper) säkerställer att felaktig eller skadlig inmatning avvisas med tydliga fel innan den når din logik, vilket är väsentligt eftersom du aldrig får lita på rå inmatning.
FastAPI gör detta deklarativt och enkelt: Query/Path/Field-begränsningar valideras automatiskt (vilket producerar strukturerade 422-fel) och dokumenteras samtidigt i API-dokumentationen, så reglerna tillämpas och kommuniceras från en enda deklaration.
Att känna till de vanliga begränsningarna och specialiserade valideringstyper är vardagskunskap för att bygga säkra, väl-definierade slutpunkter — det är hur du går bortom grundläggande typkontroll för att tillämpa de faktiska affärsregler som dina data måste uppfylla.