Tyypin tarkistamisen lisäksi FastAPI mahdollistaa rajoitusten lisäämisen polku-/kyselyparametreihin ja mallin kenttiin käyttämällä Query, Path ja Field — pituus-, alue- ja kuviokaltaiset säännöt, joissa on automaattiset 422-virheet ja dokumentaatio rikkomuuksien yhteydessä.
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() ja Path() lisäävät rajoituksia kyselyyn ja polkuparametreihin. Yleiset: min_length/max_length (merkkijonot), ge/gt/le/lt (numerot), pattern (regex). Rikkomukset tuottavat automaattisesti selkeän 422-virheen.
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")
Samat rajoitukset koskevat mallin kenttiä Field():n kautta, pyyntöjen tekstiosien validointi. Erikoistuneet tyypit (EmailStr, HttpUrl, UUID) vahvistavat muotoja.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Jokainen rajoitus, jonka ilmoitat, heijastuu myös OpenAPI-dokumentaatioon, joten kuluttajat näkevät säännöt.
Validointirajoitusten lisääminen on tärkeää sekä turvallisuuden/kestävyyden että hyvän API-suunnittelun kannalta — sääntöjen ilmoittaminen (pituusrajat, numeeriset alueet, regex-kuviot, muototyypit) varmistaa, että vääristynyt tai haitallinen tulo hylätään selkeillä virheillä ennen kuin se saavuttaa logiikkasi, mikä on välttämätöntä, koska et saa koskaan luottaa raakatietoihin.
FastAPI tekee tämän deklaratiiviseksi ja vaivattomaksi: Query/Path/Field-rajoitukset vahvistetaan automaattisesti (tuottaen jäsennettyjä 422-virheitä) ja dokumentoidaan samanaikaisesti API-asiakirjoissa, joten säännöt sovelletaan ja viestitään yksittäisestä ilmoituksesta.
Yleisten rajoitusten ja erikoistuneiden validointityyppien tunteminen on jokapäiväistä tietoa turvallisten ja hyvin määriteltyjen päätepisteien rakentamiseen — tämä on, miten menet perustyypintarkistuksen yli pakottaaksesi todelliset liiketoimintasäännöt, jotka datasi on täytettävä.