टाइप चेकिंगच्या पलीकडे, FastAPI तुम्हाला Query, Path, आणि Field वापरून path/query पॅरामीटर्स आणि मॉडेल फील्ड्सला कंस्ट्रेंट्स जोडण्याची परवानगी देते — लांबी, रेंज आणि पॅटर्न सारखे नियम लागू करते, आणि उल्लंघन झाल्यावर स्वयंचलित 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 पॅरामीटर्सला कंस्ट्रेंट्स जोडतात। सामान्य: min_length/max_length (स्ट्रिंग्स), 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")
समान कंस्ट्रेंट्स 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 डिজाइनसाठी महत्वाचे आहे — नियम घोषित करणे (लांबी मर्यादा, संख्यात्मक रेंज, regex पॅटर्न, फॉरमॅट प्रकार) विकृत किंवा दुर्भावनापूर्ण इनपुट स्पष्ट त्रुटींसह नाकारते आणि हे आपल्या लॉजिकपर्यंत पोहोचण्यापूर्वी घडते, जे आवश्यक आहे कारण आपण कधीही कच्च्या इनपुटवर विश्वास ठेवू शकत नाही।
FastAPI हे घोषणात्मक आणि सहज करते: Query/Path/Field कंस्ट्रेंट्स स्वयंचलितपणे व्हॅलिडेट केले जातात (संरचित 422 त्रुटी तयार करतात) आणि API डॉक्समध्ये एकाच घोषणेतून एकसारखे डॉक्युमेंट केले जातात।
सामान्य कंस्ट्रेंट्स आणि विशेष व्हॅलिडेशन प्रकार जाणून घेणे हे सुरक्षित, सुव्यवस्थित एंडपॉइंट्स तयार करण्यासाठी दैनिक ज्ञान आहे — ही मूलभूत टाइप चेकिंगच्या पलीकडे जाण्याची पद्धती आहे आणि आपल्या डेटाला संतुष्ट व्हावे असे वास्तविक व्यावसायिक नियम लागू करते।