Përtej kontrollimit të tipeve, FastAPI ju lejon të shtoni kufizimet në parametrat e rrugës/pyetjeve dhe fushat e modelit duke përdorur Query, Path, dhe Field — duke zbatuar rregulla si gjatësia, intervalet dhe modelet, me gabime automatike 422 dhe dokumentacionin kur shkelen.
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() dhe Path() shtojnë kufizimet në parametrat e pyetjeve dhe rrugës. Ato të zakonshme: min_length/max_length (vargjet), ge/gt/le/lt (numrat), pattern (regex). Shkeljet prodhojnë një gabim të qartë 422 automatikisht.
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")
I njëjtat kufizimet zbatohen në fushat e modelit përmes Field(), duke validuar trupin e kërkesës. Tipet e specializuara (EmailStr, HttpUrl, UUID) validojnë formate.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Çdo kufizim që deklaroni pasqyrohet edhe në dokumentacionin OpenAPI, kështu që konsumatorët shohin rregullat.
Eshtë i rëndësishëm të shtoni kufizimet e validimit si për sigurinë/qëndrueshmërinë ashtu edhe për dizajnin e mirë të API-t — deklarimi i rregullave (limitet e gjatësisë, intervalet numerike, modelet regex, tipet e formatit) sigurohet që hyrja e keqformuar ose e keqintencionale refuzohet me gabime të qarta përpara se të arrijn logjikën tuaj, që është thelbësore sepse nuk duhet të besoni kurrë në hyrjen e papërpunuar.
FastAPI e bën këtë të deklarueshme dhe pa përpjekje: kufizimet Query/Path/Field validijohen automatikisht (duke prodhuar gabime të strukturuara 422) dhe në të njëjtën kohë dokumentohen në dokumentacionin e API-t, kështu që rregullat zbatohen dhe komunikohen nga një deklaratë e vetme.
Ezja e kufizimeve të zakonshme dhe tipeve të validimit të specializuar është njohuri e përditshme për ndërtimin e pikave përvojë të sigurta dhe të përcaktuara mirë — kjo është se si e tejkaloni kontrollin bazik të tipit për të zbatuar rregullat aktuale të biznesit që të dhënat tuaja duhet të plotësojnë.