Pydantic मॉडेल्स नेस्ट केले जाऊ शकतात — एक मॉडेल फील्ड स्वतः दुसरे मॉडेल, मॉडेल्सची यादी, किंवा जटिल प्रकार असू शकते — FastAPI ला खोलवर संरचित JSON (ऑब्जेक्ट्स ऑब्जेक्ट्सच्या अंदर, ऑब्जेक्ट्सची अॅरे) स्वयंचलितपणे प्रमाणित करण्यास सक्षम करते।
pydantic BaseModel
():
street:
city:
:
():
name:
address: Address
tags: [] = []
addresses: [Address] = []
():
user
// FastAPI validates this entire structure, including the nested address:
{ "name": "Ann",
"address": { "street": "1 Main", "city": "NY", "zip": "10001" },
"tags": ["vip"] }
एक मॉडेल फील्ड जो दुसऱ्या मॉडेल म्हणून टाइप केला जातो (किंवा list[Model]) पुनरावृत्तीने प्रमाणित केला जातो — नेस्टेड ऑब्जेक्ट्स आणि ऑब्जेक्ट्सची अॅरे सर्व त्यांच्या स्कीमाच्या विरूद्ध स्वयंचलितपणे तपासली जातात।
from pydantic import BaseModel, HttpUrl, EmailStr
from datetime import datetime
from enum import Enum
class Status(str, Enum): # enums constrain to allowed values
active = "active"
inactive = "inactive"
class Item(BaseModel):
url: HttpUrl # validates URL format
email: EmailStr # validates email format
created: datetime # parses ISO 8601 strings → datetime
status: Status # must be one of the enum values
metadata: dict[str, int] # typed dict
coordinates: tuple[float, float] # typed tuple
Pydantic समृद्ध प्रकारांचे हाताळणी करते: enums (अनुमत मूल्यांपर्यंत प्रतिबंधित), datetime (ISO स्ट्रिंग्स पार्स करते), HttpUrl/EmailStr (प्रारूप प्रमाणन), आणि टाइप्ड dicts/tuples — सर्व स्वयंचलितपणे प्रमाणित केले जातात।
from typing import Generic, TypeVar
T = TypeVar("T")
class Paginated(BaseModel, Generic[T]): # a reusable generic response wrapper
items: list[T]
total: int
# Paginated[User] → { items: [User...], total: N }
वास्तविक-जगत APIs ने फ्लॅट डेटा हाताळत नाहीत — ते जटिल, नेस्टेड संरचनाहरू हाताळतात (अॅड्रेस आणि ऑर्डर्सची यादी असलेला वापरकर्ता, लाइन आयटम्स असलेला ऑर्डर, कॉन्फिगरेशन ऑब्जेक्ट्स), आणि Pydantic ची मॉडेल्सचे नेस्टिंग करण्याची क्षमता या खोलवर संरचित रिक्वेस्ट बॉडीज प्रमाणित करणे सहज करते।
ही समजूती की एक मॉडेल फील्ड दुसरे मॉडेल, मॉडेल्सची यादी, किंवा समृद्ध प्रकार असू शकते — आणि FastAPI संपूर्ण नेस्टेड संरचनाला पुनरावृत्तीने आणि स्वयंचलितपणे प्रमाणित करते — APIs तयार करण्यासाठी महत्त्वाचे आहे जे वास्तविक, जटिल इनपुट सुरक्षितपणे स्वीकारतात।
समृद्ध प्रकार समर्थन (मर्यादित मूल्यांसाठी enums, datetime पार्सिंग, HttpUrl/EmailStr प्रारूप प्रमाणन, टाइप्ड कलेक्शन्स) पुढे जटिल डेटा हाताळणीशिवाय अचूक आहे हे सुनिश्चित करते।
नेस्टेड आणि जटिल बॉडीज कसे मॉडेल करायचे हे जाणून घेणे (आणि पेजिनेशन सारख्या गोष्टীसाठी पुन: वापरयोग्य सामान्य रॅपर्स) APIs तयार करण्यासाठी व्यावहारिक ज्ञान आहे जे वास्तविक अनुप्रयोगांना आवश्यक असलेल्या संरचित डेटा हाताळते, स्वयंचलितपणे प्रदान केलेल्या संपूर्ण प्रमाणनसह — FastAPI च्या Pydantic-आधारित डिজाइनचा मुख्य शक्ती।