Apa itu model Pydantic di FastAPI?

Question

Accepted Answer

**Model Pydantic** adalah kelas (yang mewarisi `BaseModel`) yang mendefinisikan **struktur, tipe, dan aturan validasi** untuk data. FastAPI menggunakannya di mana-mana — untuk badan permintaan, bentuk respons, dan pengaturan — menjadikannya jantung dari desainnya yang digerakkan tipe.

## Mendefinisikan model

```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
```

Setiap bidang mendeklarasikan tipe dan batasan/nilai default opsional. Pydantic memvalidasi data terhadap definisi ini dan mengonversi tipe di mana masuk akal.

## Validasi dan parsing otomatis

```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
```

Ketika digunakan sebagai tipe parameter, FastAPI mengurai badan permintaan JSON ke dalam model, **memvalidasi** setiap bidang dan mengembalikan kesalahan 422 terstruktur yang mencantumkan dengan tepat apa yang salah — semuanya otomatis.

## Apa yang Pydantic berikan kepada Anda

```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
```

## Sumber kebenaran tunggal

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

## Mengapa ini penting

Model Pydantic adalah fondasi FastAPI — ini adalah cara Anda mendefinisikan dan memvalidasi data yang diterima dan dikembalikan oleh API Anda, dan hampir setiap fitur FastAPI mengalir melaluinya.

Penting untuk memahaminya karena mereka memberikan **validasi** otomatis (penting untuk keamanan dan keandalan — jangan pernah mempercayai input mentah), parsing/paksaan, serialisasi, dan dukungan editor, semuanya dari satu kelas deklaratif.

Mereka berfungsi sebagai **sumber kebenaran tunggal**: satu model mendorong validasi permintaan, bentuk respons, dan dokumentasi yang dihasilkan secara otomatis.

Pendekatan berbasis tipe, validasi secara default ini — mendapatkan validasi input yang kuat dan pesan kesalahan yang jelas pada dasarnya gratis — adalah alasan utama mengapa FastAPI sangat produktif dan aman, menjadikan model Pydantic pengetahuan mendasar yang wajib dikuasai.