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 მართავს მდიდარ ტიპებს: enum-ები (შემზღუდველი დაშვებული მნიშვნელობებით), datetime (ISO სტრიქონების ანალიზი), HttpUrl/EmailStr (ფორმატის ვალიდაცია), და typed dict-ები/ტუპლები — ყველა ავტომატურად ვალიდირდება.
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 }
ნამდვილი სამყაროს API-ები იშვიათად ეხმიანებიან ბრტყელ მონაცემებს — ისინი მართავენ რთულ, ჯგუფურ სტრუქტურებს (მომხმარებელი ადრესით და შეკვეთების სიით, შეკვეთა პოზიციის ელემენტებით, კონფიგურაციის ობიექტები), და Pydantic-ის უნარი მოდელების ჯგუფირებისთვის ამ ღრმად სტრუქტურირებული request body-ების ვალიდაციას უტანჯელს ხდის.
ისმის, რომ მოდელის ველი შეიძლება იყოს სხვა მოდელი, მოდელების სია, ან მდიდარი ტიპი — და რომ FastAPI მთელი ჯგუფური სტრუქტურის რეკურსიული გზით და ავტომატურად ვალიდაციას უკეთებს — მნიშვნელოვანია API-ების ასაგებად, რომლებიც რეალისტური, რთული შეყვანის უსაფრთხოდ მიღებას ღებულობენ.
მდიდარი ტიპის მხარდამჭერი (enum სიმიტირებული მნიშვნელობებისთვის, datetime ანალიზი, HttpUrl/EmailStr ფორმატის ვალიდაცია, ტიპიზირებული კოლექციები) გარდა ამისა უზრუნველყოფს რთული მონაცემების სისწორეს ხელით შემოწმებების გარეშე.
ჯგუფური და რთული body-ების მოდელირების ცოდნა (და გამოყენებადი ზოგადი დამხმარეები რამეთიმე გვერდების გაყოფისთვის) პრაქტიკული ცოდნაა API-ების აშენებისთვის, რომლებიც ხელმძღვანელობენ სტრუქტურირებულ მონაცემებს რეალური აპლიკაციები მოითხოვს, სრული ვალიდაციით უზრუნველყოფილი ავტომატურად — FastAPI-ის Pydantic-ზე დაფუძნებული დიზაინის მთავარი ძალა.