Помимо проверки типов, FastAPI позволяет добавлять ограничения к параметрам пути/запроса и полям модели, используя Query, Path и Field — обеспечивая правила, такие как длина, диапазоны и шаблоны, с автоматическими ошибками 422 и документацией при нарушении.
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() и Path() добавляют ограничения к параметрам запроса и пути. Распространённые: min_length/max_length (строки), ge/gt/le/lt (числа), pattern (регулярные выражения). Нарушения автоматически производят чёткую ошибку 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")
Те же ограничения применяются к полям модели через Field(), валидируя тела запросов. Специализированные типы (EmailStr, HttpUrl, UUID) валидируют форматы.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Каждое объявленное ограничение также отражается в документации OpenAPI, поэтому потребители видят правила.
Добавление ограничений валидации важно как для безопасности/надёжности, так и для хорошего проектирования API — объявление правил (ограничения длины, диапазоны чисел, регулярные выражения, типы форматов) гарантирует, что некорректный или вредоносный ввод будет отклонён с чёткими ошибками до достижения вашей логики, что критично, так как вы никогда не должны доверять сырому вводу.
FastAPI делает это декларативным и простым: ограничения Query/Path/Field автоматически валидируются (производя структурированные ошибки 422) и одновременно документируются в документации API, поэтому правила применяются и передаются из одного объявления.
Знание распространённых ограничений и специализированных типов валидации — повседневные знания для построения безопасных, чётко определённых endpoint'ов — это то, как вы выходите за пределы базовой проверки типов, чтобы применять фактические бизнес-правила, которым должны удовлетворять ваши данные.