คุณกำหนด routes (path operations) อย่างไร?

Question

Accepted Answer

ใน FastAPI **path operation** คือ route — ฟังก์ชันที่ตกแต่งด้วย HTTP method decorator (`@app.get`, `@app.post` เป็นต้น) ที่จัดการคำขอไปยังเส้นทาง ค่าที่ส่งคืนของฟังก์ชันจะถูกแปลงเป็น JSON โดยอัตโนมัติ

## กำหนด routes สำหรับแต่ละ HTTP method

```python
from fastapi import FastAPI
app = FastAPI()

@app.get("/items")                # GET /items
def list_items():
    return [{"id": 1}, {"id": 2}]  # dict/list → automatically JSON-serialized

@app.get("/items/{item_id}")      # GET /items/5 — path parameter
def get_item(item_id: int):        # type hint converts "5" → int (and validates)
    return {"id": item_id}

@app.post("/items")               # POST /items
def create_item(item: Item):
    return item

@app.put("/items/{item_id}")      # PUT, PATCH, DELETE work the same way
@app.delete("/items/{item_id}")
def delete_item(item_id: int):
    return {"deleted": item_id}
```

ตัวอลังการแต่ละตัวจะแมป HTTP method + path ไปยัง handler ชื่อฟังก์ชันคือของคุณ ตัวอลังการกำหนด route ค่าที่ส่งคืนของ dicts/lists/Pydantic models จะถูกแปลงเป็น JSON โดยอัตโนมัติ — ไม่ต้องใช้ `json.dumps` ด้วยตนเอง

## ลำดับมีความสำคัญสำหรับเส้นทางที่ทับซ้อนกัน

```python
@app.get("/users/me")            # ✅ specific route FIRST
def read_me(): ...
@app.get("/users/{user_id}")     # dynamic AFTER — else "me" matches {user_id}
def read_user(user_id: int): ...
```

FastAPI จับคู่ routes ตามลำดับการประกาศ ดังนั้นให้วางเส้นทาง static ก่อนเส้นทาง dynamic

## Operation metadata (ขับเคลื่อน docs)

```python
@app.get("/items", tags=["items"], summary="List items", status_code=200)
def list_items(): ...
```

พารามิเตอร์ของตัวอลังการ (`tags`, `summary`, `status_code`, `response_model`) กำหนดค่าพฤติกรรมและเสริมเอกสารที่สร้างขึ้นโดยอัตโนมัติ

## ทำไมจึงสำคัญ

Path operations เป็นรากฐานของแอปพลิเคชัน FastAPI ทุกตัว — พวกเขากำหนด endpoints ของ API ของคุณและวิธีการจัดการคำขอ

การเข้าใจรูปแบบ decorator-per-HTTP-method ว่าค่าที่ส่งคืนจะถูกแปลงเป็น JSON โดยอัตโนมัติ (ไม่มี boilerplate) ว่า type hints บนพารามิเตอร์ขับเคลื่อนการแปลงและการตรวจสอบ และว่าลำดับ route มีความสำคัญสำหรับเส้นทางที่ทับซ้อนกัน คือความรู้ประจำวันที่จำเป็นสำหรับการสร้าง endpoint ใด ๆ

Metadata ของตัวอลังการยังให้อาหารเอกสารอัตโนมัติของ FastAPI โดยเชื่อมต่อ routes โดยตรงไปยัง docs

นี่คือสิ่งแรกและสำคัญที่สุดที่ต้องเรียนรู้ใน FastAPI