Izvan provjere tipa, FastAPI vam omogućava dodavanje ograničenja na parametre putanje/upita i polja modela koristeći Query, Path i Field — primjenjujući pravila kao što su duljina, rasponi i uzorci, s automatskim greškama 422 i dokumentacijom pri kršenju.
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() i Path() dodaju ograničenja parametrima upita i putanje. Česta: min_length/max_length (stringovi), ge/gt/le/lt (brojevi), pattern (regex). Kršenja automatski stvaraju jasnu grešku 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")
Ista ograničenja primjenjuju se na polja modela putem Field(), validirajući tijela zahtjeva. Specijalizirane vrste (EmailStr, HttpUrl, UUID) validirajú formate.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Svako ograničenje koje deklarirate odražava se i u OpenAPI dokumentaciji, pa potrošači vide pravila.
Dodavanje ograničenja provjere valjanosti važno je za sigurnost/robusnost i dobar API dizajn — deklariranje pravila (ograničenja duljine, brojčanih raspona, regex uzoraka, vrsta formata) osigurava da se malformatizirani ili zlonamjerni unos odbija s jasnim greškama prije nego što dosegne vašu logiku, što je bitno jer nikada ne smijete vjerovati sirovom unosu.
FastAPI to čini deklarativnim i bez napora: Query/Path/Field ograničenja se validirajú automatski (proizvodeći strukturirane greške 422) i istovremeno se dokumentiraju u API dokumentaciji, tako da se pravila primjenjuju i komuniciraju iz jedne deklaracije.
Poznavanja čestih ograničenja i specijaliziranih vrsta provjere valjanosti je svakodnevno znanje za izgradnju sigurnih, dobro definiranih krajnjih točaka — to je kako se krećete dalje od osnovne provjere tipa kako biste primijenjili stvarna poslovna pravila koja moraju zadovoljiti vaši podaci.