Apakah itu model Pydantic dalam FastAPI?

Question

Accepted Answer

**Model Pydantic** ialah kelas (yang mensubkelas `BaseModel`) yang mentakrifkan **struktur, jenis, dan peraturan validasi** untuk data. FastAPI menggunakannya di mana-mana — untuk badan permintaan, bentuk respons, dan tetapan — menjadikannya teras kepada reka bentuk dipacu jenisnya.

## Mentakrifkan 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 medan mengisytiharkan jenis serta kekangan/nilai lalai pilihan. Pydantic mengesahkan data terhadap takrifan ini dan menukar jenis apabila munasabah.

## Validasi dan penghuraian automatik

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

Apabila digunakan sebagai jenis parameter, FastAPI menghurai badan permintaan JSON menjadi model, **mengesahkan** setiap medan dan mengembalikan ralat 422 berstruktur yang menyenaraikan dengan tepat apa yang salah — semuanya automatik.

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

## Satu 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 ia penting

Model Pydantic ialah batu asas FastAPI — ia adalah cara anda mentakrifkan dan mengesahkan data yang diterima dan dikembalikan oleh API anda, dan hampir setiap ciri FastAPI mengalir melaluinya.

Memahaminya adalah penting kerana ia menyediakan **validasi** automatik (kritikal untuk keselamatan dan keteguhan — jangan sekali-kali mempercayai input mentah), penghuraian/penukaran, serialisasi, dan sokongan editor, semuanya daripada satu kelas deklaratif tunggal.

Ia berfungsi sebagai **satu sumber kebenaran tunggal**: satu model memacu validasi permintaan, bentuk respons, dan dokumentasi yang dijana automatik.

Pendekatan dipacu jenis, validasi-secara-lalai ini — mendapatkan validasi input yang teguh dan mesej ralat yang jelas pada dasarnya secara percuma — ialah sebab utama FastAPI begitu produktif dan selamat, menjadikan model Pydantic sebagai pengetahuan asas yang wajib dikuasai.