Dincolo de verificarea tipului, FastAPI îți permite să adaugi constrângeri parametrilor path/query și câmpurilor modelului folosind Query, Path, și Field — impunând reguli cum ar fi lungime, domenii și modele, cu erori 422 automate și documentație atunci când sunt încălcate.
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() adaugă constrângeri parametrilor query și path. Cele comune: min_length/max_length (șiruri de caractere), ge/gt/le/lt (numere), pattern (regex). Încălcările produc automat o eroare 422 clară.
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")
Aceleași constrângeri se aplică câmpurilor modelului prin Field(), validând corpuri de cereri. Tipurile specializate (EmailStr, HttpUrl, UUID) validează formate.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Fiecare constrângere pe care o declari este reflectată și în documentația OpenAPI, deci consumatorii văd regulile.
Adăugarea constrângerilor de validare este importantă atât pentru securitate/robustețe cât și pentru bun design API — declararea regulilor (limite de lungime, domenii numerice, modele regex, tipuri de format) asigură că intrarea malformată sau rău intenționată este respingă cu erori clare înainte de a ajunge la logica ta, ceea ce este esențial deoarece nu trebuie niciodată să ai încredere în intrarea brută.
FastAPI face aceasta declarativă și fără efort: constrângerile Query/Path/Field sunt validate automat (producând erori structurate 422) și simultaneous documentate în documentația API, deci regulile sunt impuse și comunicate dintr-o singură declarație.
Cunoașterea constrângerilor comune și a tipurilor de validare specializate este cunoștință de zi cu zi pentru construirea de endpoints sigure și bine definite — aceasta este cum mergi dincolo de verificarea tipului de bază pentru a impune regulile de afaceri actuale pe care trebuie să le satisfacă datele tale.