Poza sprawdzeniem typów, FastAPI pozwala dodać ograniczenia do parametrów ścieżki/zapytania i pól modelu za pomocą Query, Path i Field — wymuszając reguły takie jak długość, zakresy i wzorce, z automatycznymi błędami 422 i dokumentacją w przypadku naruszenia.
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() dodają ograniczenia do parametrów zapytania i ścieżki. Najczęstsze: min_length/max_length (ciągi znaków), ge/gt/le/lt (liczby), pattern (regex). Naruszenia automatycznie generują wyraźny błąd 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")
Te same ograniczenia dotyczą pól modelu poprzez Field(), walidując treść żądania. Specjalizowane typy (EmailStr, HttpUrl, UUID) walidują formaty.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Każde zadeklarowane ograniczenie jest również odzwierciedlone w dokumentacji OpenAPI, dzięki czemu konsumenci widzą reguły.
Dodawanie ograniczeń walidacji jest ważne zarówno dla bezpieczeństwa/niezawodności jak i dobrego projektowania API — deklarowanie reguł (limity długości, zakresy liczbowe, wzorce regex, typy formatów) zapewnia, że zniekształcone lub złośliwe dane wejściowe są odrzucane z jasnymi błędami zanim dotrą do Twojej logiki, co jest niezbędne, ponieważ nigdy nie możesz ufać surowym danym wejściowym.
FastAPI czyni to deklaratywnym i bez wysiłku: ograniczenia Query/Path/Field są walidowane automatycznie (generując strukturalne błędy 422) i jednocześnie dokumentowane w dokumentacji API, więc reguły są wymuszane i komunikowane z jednej deklaracji.
Znajomość najczęstszych ograniczeń i specjalizowanych typów walidacji to wiedza na co dzień podczas budowania bezpiecznych, dobrze zdefiniowanych punktów końcowych — to sposób na wyjście poza podstawowe sprawdzenie typów i wymuszenie rzeczywistych reguł biznesowych, które muszą spełniać Twoje dane.