FastAPI'de Pydantic Modelleri Nedir?

Question

Accepted Answer

**Pydantic Modelleri**, veriler için **yapı, türler ve doğrulama kurallarını** tanımlayan sınıflardır (`BaseModel`'den türetilir). FastAPI bunları her yerde kullanır — istek gövdeleri, yanıt şekilleri ve ayarlar için — bunları tip odaklı tasarımının kalbi haline getirir.

## Bir Model Tanımlama

```python
from pydantic import BaseModel, EmailStr, Field

class User(BaseModel):
    name: str
    email: EmailStr                          # validates email format
    age: int = Field(ge=0, le=120)            # constraint: 0 <= age <= 120
    is_active: bool = True                    # default value
    tags: list[str] = []                      # typed list with a default
```

Her alan bir tür ve isteğe bağlı kısıtlamalar/varsayılanlar bildirir. Pydantic, verileri bu tanıma karşı doğrular ve türleri uygun yerlerde dönüştürür.

## Otomatik Doğrulama ve Ayrıştırma

```python
@app.post("/users")
def create_user(user: User):                  # FastAPI builds & validates a User from the body
    return user                               # already validated here
# valid JSON → a typed User object; invalid → automatic 422 with field-level errors
```

Parametre türü olarak kullanıldığında, FastAPI JSON istek gövdesini modele ayrıştırır, **her alanı doğrular** ve tam olarak neyin yanlış olduğunu listeleyen yapılandırılmış bir 422 hatası döndürür — hepsi otomatik.

## Pydantic Size Neler Sağlar

```text
✓ Validation — type checks + constraints (lengths, ranges, formats), clear errors
✓ Parsing/coercion — "5" → 5, ISO string → datetime, etc.
✓ Serialization — model.model_dump() / model_dump_json() → dict/JSON
✓ Editor support — full autocomplete & type checking on model attributes
✓ Self-documenting — the model defines the schema used in the auto-generated docs
```

## Tek Bir Gerçek Kaynağı

```text
One Pydantic model drives: request validation, the response schema, the OpenAPI docs,
and typed access in your code → define the data shape ONCE.
```

## Neden önemli

Pydantic Modelleri FastAPI'nin temel taşıdır — API'nizin kabul ettiği ve döndürdüğü verileri nasıl tanımlayıp doğrulayacağınız ve neredeyse her FastAPI özelliği bunların aracılığıyla akar.

Bunları anlamak gereklidir çünkü otomatik **doğrulama** (güvenlik ve sağlamlık için kritik — ham girdiyi asla güvenmeyin), ayrıştırma/zorlama, serileştirme ve editör desteği sağlarlar; hepsi tek bir bildirimsel sınıftan.

Bunlar **tek bir gerçek kaynağı** olarak işlev görür: bir model istek doğrulamasını, yanıt şeklini ve otomatik olarak oluşturulan belgeleri yönetir.

Bu tür odaklı, varsayılan olarak doğrula yaklaşımı — sağlam giriş doğrulaması ve net hata mesajları temelde ücretsiz alın — FastAPI'nin neden bu kadar üretken ve güvenli olduğunun ana nedenidir, bu da Pydantic Modellerini temel, mutlaka öğrenilmesi gereken bilgi haline getirir.