Pydantic model trong FastAPI là gì?

Question

Accepted Answer

**Pydantic model** là các class (kế thừa `BaseModel`) định nghĩa **cấu trúc, kiểu dữ liệu và quy tắc validation** cho dữ liệu. FastAPI dùng chúng ở khắp nơi — cho request body, hình dạng response, và settings — khiến chúng là trái tim của thiết kế điều khiển bằng type.

## Định nghĩa một model

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

class User(BaseModel):
    name: str
    email: EmailStr                          # validate định dạng email
    age: int = Field(ge=0, le=120)            # ràng buộc: 0 <= age <= 120
    is_active: bool = True                    # giá trị mặc định
    tags: list[str] = []                      # list có kiểu với giá trị mặc định
```

Mỗi field khai báo một kiểu và các ràng buộc/giá trị mặc định tùy chọn. Pydantic validate dữ liệu theo định nghĩa này và chuyển đổi kiểu khi hợp lý.

## Validation và parse tự động

```python
@app.post("/users")
def create_user(user: User):                  # FastAPI dựng & validate một User từ body
    return user                               # đã được validate tại đây
# JSON hợp lệ → một đối tượng User có kiểu; không hợp lệ → 422 tự động với lỗi theo field
```

Khi được dùng làm kiểu tham số, FastAPI parse JSON request body thành model, **validate** mọi field và trả về một lỗi 422 có cấu trúc liệt kê chính xác điều gì sai — tất cả tự động.

## Pydantic mang lại điều gì

```text
✓ Validation — kiểm tra kiểu + ràng buộc (độ dài, khoảng, định dạng), lỗi rõ ràng
✓ Parse/coerce — "5" → 5, chuỗi ISO → datetime, v.v.
✓ Serialization — model.model_dump() / model_dump_json() → dict/JSON
✓ Hỗ trợ editor — autocomplete đầy đủ & kiểm tra kiểu trên thuộc tính model
✓ Tự tài liệu hóa — model định nghĩa schema dùng trong tài liệu tự sinh
```

## Một nguồn chân lý duy nhất

```text
Một Pydantic model điều khiển: validate request, schema của response, tài liệu OpenAPI,
và truy cập có kiểu trong code của bạn → định nghĩa cấu trúc dữ liệu MỘT LẦN.
```

## Tại sao điều này quan trọng

Pydantic model là nền tảng của FastAPI — chúng là cách bạn định nghĩa và validate dữ liệu mà API chấp nhận và trả về, và gần như mọi tính năng FastAPI đều chảy qua chúng.

Hiểu chúng là thiết yếu vì chúng cung cấp **validation** tự động (then chốt cho bảo mật và độ bền vững — không bao giờ tin tưởng input thô), parse/coerce, serialization và hỗ trợ editor, tất cả từ một class khai báo duy nhất.

Chúng đóng vai trò **nguồn chân lý duy nhất**: một model điều khiển validate request, hình dạng response, và tài liệu tự sinh.

Cách tiếp cận điều khiển bằng type, validate-mặc-định này — nhận được validation input mạnh mẽ và thông báo lỗi rõ ràng gần như miễn phí — là lý do lớn khiến FastAPI năng suất và an toàn, biến Pydantic model thành kiến thức cơ bản, bắt buộc phải thành thạo.