Tür kontrolünün ötesinde, FastAPI Query, Path ve Field kullanarak yol/sorgu parametrelerine ve model alanlarına kısıtlamalar eklemenizi sağlar — uzunluk, aralık ve desenler gibi kuralları zorunlu kılar ve ihlal edildiğinde otomatik 422 hataları ve belgeler üretir.
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() ve Path() sorgu ve yol parametrelerine kısıtlamalar ekler. Yaygın olanları: min_length/max_length (dizeler), ge/gt/le/lt (sayılar), pattern (regex). İhlaller otomatik olarak açık bir 422 hatası üretir.
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")
Aynı kısıtlamalar model alanlarına Field() aracılığıyla uygulanır, istek gövdelerini doğrular. Özel türler (EmailStr, HttpUrl, UUID) formatları doğrular.
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
Deklare ettiğiniz her kısıtlama OpenAPI belgelerine de yansıtılır, bu nedenle tüketiciler kuralları görür.
Doğrulama kısıtlamaları eklemek hem güvenlik/sağlamlık hem de iyi API tasarımı açısından önemlidir — kuralları (uzunluk sınırları, sayısal aralıklar, regex desenleri, format türleri) tanımlamak, yanlış biçimlendirilmiş veya kötü amaçlı girişin mantığınıza ulaşmadan açık hatalarla reddedilmesini sağlar, bu da ham girişe asla güvenmemeniz gerektiğinden önemlidir.
FastAPI bunu deklaratif ve zahmetsiz kılar: Query/Path/Field kısıtlamaları otomatik olarak doğrulanır (yapılandırılmış 422 hataları üretir) ve aynı zamanda API belgelerinde belgelenir, bu nedenle kurallar tek bir deklarasyondan zorunlu kılınır ve iletişim kurulur.
Yaygın kısıtlamaları ve özel doğrulama türlerini bilmek güvenli, iyi tanımlanmış uç noktalar oluşturmak için günlük bilgidir — verilerinizin tatmin etmesi gereken gerçek iş kurallarını zorunlu kılmak için temel tür kontrolünün ötesine nasıl gideceğinizdir.