قسم کی جانچ سے آگے، FastAPI آپ کو Query، Path، اور Field استعمال کرتے ہوئے path/query پیرامیٹرز اور ماڈل فیلڈز میں constraints شامل کرنے دیتا ہے — لمبائی، رینجز، اور patterns جیسے اصول نافذ کرتے ہوئے، خلاف ورزی ہوئے تو خودکار طور پر 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() query اور path پیرامیٹرز میں constraints شامل کرتے ہیں۔ عام لوگ: min_length/max_length (strings)، ge/gt/le/lt (نمبرز)، pattern (regex)۔ خلاف ورزیاں خودکار طور پر واضح 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")
یہی constraints Field() کے ذریعے ماڈل فیلڈز پر لاگو ہوتے ہیں، درخواست کے bodies کی تصدیق کرتے ہوئے۔ خصوصی اقسام (EmailStr، HttpUrl، UUID) formats کی تصدیق کرتے ہیں۔
q: str = Query(min_length=3, description="Search query", example="phone")
# the constraints + description + example appear in the auto-generated API docs
ہر constraint جو آپ declare کرتے ہیں وہ OpenAPI دستاویزات میں بھی منعکس ہوتا ہے، اس لیے صارفین اصول دیکھتے ہیں۔
توثیق کی پابندیوں کو شامل کرنا سیکیورٹی/مضبوطی اور اچھے API ڈیزائن دونوں کے لیے اہم ہے — اصول declare کرنا (لمبائی کی حدود، عددی رینجز، regex patterns، format اقسام) یقینی بناتا ہے کہ غلط یا بدنیتی والا input آپ کی منطق تک پہنچنے سے پہلے واضح غلطیوں کے ساتھ مسترد کر دیا جائے، جو ضروری ہے کیونکہ آپ کو کبھی خام input پر اعتماد نہیں کرنا چاہیے۔
FastAPI یہ declarative اور لاتعلق بناتا ہے: Query/Path/Field constraints خودکار طور پر validate ہوتی ہیں (structured 422 غلطیاں پیدا کرتے ہوئے) اور بیک وقت API docs میں دستاویز کی جاتی ہیں، اس لیے اصول ایک declaration سے نافذ اور منتقل ہوتے ہیں۔
عام constraints اور خصوصی validation اقسام جاننا روز مرہ کی معلومات ہے محفوظ، اچھی طرح سے متعین endpoints بنانے کے لیے — یہ ہے آپ بنیادی قسم کی جانچ سے آگے بڑھتے ہوئے اپنے ڈیٹا کو پورا کرنے والے اصل کاروباری اصول نافذ کرنے کے لیے۔