Pydantic મોડલ્સ નેસ્ટેડ હોઈ શકે છે — એક મોડેલ ફીલ્ડ અન્ય મોડેલ, મોડલ્સની સૂચી અથવા જટિલ પ્રકાર હોઈ શકે છે — FastAPI ને deeply structured JSON (objects within objects, arrays of objects) આપોઆપ validate કરવા દે છે।
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] તરીકે) ટાઈપ કરવામાં આવે છે તે આપોઆપ validate થાય છે — નેસ્ટેડ objects અને objects ની arrays બધી તેમની સ્કીમાની વિરુદ્ધ ચેક કરવામાં આવે છે।
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 strings parse કરે છે), HttpUrl/EmailStr (ફોર્મેટ validation), અને typed dicts/tuples — બધું આપોઆપ validate થાય છે।
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 ભાગ્યે જ સપાટ ડેટા સાથે કામ કરે છે — તેઓ જટિલ, nested structures (એક વપરાશકર્તા સાથે સરનામું અને orders ની સૂચી, ઓર્ડર line items સાથે, configuration objects) સંભાળે છે, અને Pydantic ની models nest કરવાની ક્ષમતા આ deeply structured request bodies ને validate કરવાને સરળ બનાવે છે।
વધુ તે સમજવું કે મોડેલ ફીલ્ડ બીજો મોડેલ, મોડલ્સની સૂચી અથવા સમૃદ્ધ પ્રકાર હોઈ શકે છે — અને FastAPI **સમગ્ર nested structure **આપોઆપ અને વારંવાર validate કરે છે — એવી APIयों બનાવવા માટે મહત્વપૂર્ણ છે જે વાસ્તવિક, જટિલ ઇનપુટ સુરક્ષિતપણે સ્વીકારે છે।
સમૃદ્ધ પ્રકાર સહાયતા (constrained મૂલ્યોણ enums, datetime parsing, HttpUrl/EmailStr format validation, typed collections) વધુ સુનિશ્ચિત કરે છે કે જટિલ ડેટા મેનુઅલ તપાસ વિના સાચો છે।
જાણવું કે nested અને complex bodies (અને pagination જેવી વસ્તુઓ માટે reusable generic wrappers) કેવી રીતે મોડેલ કરવું તે structured data ને સંભાળતી APIयों બનાવવા માટે વ્યવહારિક જ્ઞાન છે જે વાસ્તવિક એપ્લીકેશનો આવશ્યક છે, આપોઆપ સંપૂર્ણ validation સાથે — FastAPI ની Pydantic-આધારિત ડિઝાઇનની મુખ્ય શક્તિ।