Pydantic Models ใน FastAPI คืออะไร

Question

Accepted Answer

**Pydantic Models** เป็นคลาส (สืบทอดจาก `BaseModel`) ที่กำหนด **โครงสร้าง ประเภท และกฎการตรวจสอบ** สำหรับข้อมูล FastAPI ใช้งานได้ทั่วทั้งระบบ — สำหรับ request body รูปแบบการตอบสนอง และการตั้งค่า — ทำให้พวกมันกลายเป็นหัวใจของการออกแบบที่ขับเคลื่อนด้วยประเภท

## การกำหนด 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
```

แต่ละฟิลด์ประกาศประเภทและข้อจำกัด/ค่าเริ่มต้นที่ไม่บังคับ Pydantic ตรวจสอบข้อมูลตามคำนิยามนี้และแปลงประเภทที่เหมาะสม

## การตรวจสอบและการแยกวิเคราะห์อัตโนมัติ

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

เมื่อใช้เป็นประเภทพารามิเตอร์ FastAPI จะแยกวิเคราะห์ JSON request body เป็น model **ตรวจสอบ** ทุกฟิลด์ และส่งคืนข้อผิดพลาด 422 ที่มีโครงสร้างซึ่งระบุว่าปัญหาคืออะไร — ทั้งหมดอัตโนมัติ

## สิ่งที่ Pydantic มอบให้คุณ

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

## แหล่งความจริงเดียว

```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 Models เป็นรากฐานของ FastAPI — นี่คือวิธีที่คุณกำหนดและตรวจสอบข้อมูลที่ API ของคุณยอมรับและส่งคืน และเกือบทุกคุณลักษณะของ FastAPI ไหลผ่านพวกมัน

การทำความเข้าใจพวกมันเป็นสิ่งจำเป็น เพราะพวกมันให้การตรวจสอบ **อัตโนมัติ** (สำคัญเพื่อความปลอดภัยและความแข็งแรง — ไม่เชื่อข้อมูลดิบ) การแยกวิเคราะห์/การบังคับใช้ การจัดลำดับ และการสนับสนุนตัวแก้ไข ทั้งหมดมาจากคลาส declarative เดียว

พวกมันทำหน้าที่เป็น **แหล่งความจริงเดียว**: model หนึ่งขับเคลื่อนการตรวจสอบ request รูปแบบการตอบสนอง และเอกสารที่สร้างอัตโนมัติ

แนวทางที่ขับเคลื่อนด้วยประเภทนี้ validate-by-default — การได้รับการตรวจสอบ input ที่มั่นคง และข้อความข้อผิดพลาดที่ชัดเจน โดยพื้นฐานแล้วให้ฟรี — เป็นเหตุผลหลักที่ทำให้ FastAPI มีประสิทธิภาพและปลอดภัย ทำให้ Pydantic Models เป็นความรู้พื้นฐาน ต้องเข้าใจ