Poleg preverjanja tipov vam FastAPI omogoča dodajanje omejitev potnim/poizvedovalnim parametrom in poljem modela z uporabo Query, Path in Field — uveljavljanje pravil, kot so dolžina, obsegi in vzorci, s samodejnimi napakami 422 in dokumentacijo v primeru kršitve.
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() in Path() dodajata omejitve poizvedovalnim in potnim parametrom. Pogostos: min_length/max_length (nizi), ge/gt/le/lt (števila), pattern (regex). Kršitve samodejno ustvarijo jasno napako 422.
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")
Iste omejitve se nanašajo na polja modela prek Field(), ki validira zahtevane telese. Posebni tipi (EmailStr, HttpUrl, UUID) validirajo formate.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Vsaka omejitev, ki jo deklarirate, se odraža tudi v OpenAPI dokumentaciji, zato potrošniki vidijo pravila.
Dodajanje omejitev validacije je pomembno za varnost/robustnost in dobro oblikovanje API-ja — deklariranje pravil (omejitve dolžine, številski obsegi, regex vzorci, tipi formatov) zagotavlja, da se slabo oblikovani ali zlomysljeni vnos zavrne s jasnimi napakami preden doseže vašo logiko, kar je bistvenega pomena, ker nikoli ne smete zaupati neobdelanemu vnosu.
FastAPI to naredi deklarativno in brez napora: omejitve Query/Path/Field se validirajo samodejno (proizvajajo strukturirane napake 422) in hkrati dokumentirajo v dokumentaciji API-ja, zato se pravila uveljavljajo in sporočajo iz ene same deklaracije.
Znanje pogostih omejitev in posebnih vrst validacije je vsakodnevno znanje za gradnjo varnih in dobro definirani končnih točk — tako presežete osnovno preverjanje tipov in uveljavite dejanska poslovna pravila, ki jih morajo izpolnjevati vaši podatki.