1.Routing.md

last update: 2025-06-07

在 Web 開發中，路由 (Routing)指的是將使用者輸入的網址路徑，對應到後端系統中的特定功能或資料處理邏輯。

路由的基本概念

路由通常定義一組 URL 模式與對應的處理函數（或稱處理器、controller）。例如：

@app.get("/")
def home():
    return {"message": "這是首頁"}

靜態路由是 URL 結構固定、不可變的路徑。

範例：

@app.get("/about")
def about():
    return {"info": "這是關於我們的頁面"}

呼叫：http://localhost:8000/about

動態路由允許路徑中包含變數部分，可對應不同參數內容。

@app.get("/users/{user}")
def get_user(user: str):
    return {"user": user}

呼叫：http://localhost:8000/users/42 → 回傳 {"user_id": 42}

@app.get("/books/{category}/{book_id}")
def book_detail(category: str, book_id: int):
    return {"category": category, "id": book_id}

FastAPI 支援明確的型別註記與驗證，例如：

@app.get("/item/{id}")
def get_item(id: int):
    return {"result": id * 2}

如果使用者輸入非整數（如 /item/abc），將自動回傳錯誤訊息。

@app.get("/search")
def search(q: str, page: int = 1):
    return {"q": q, "page": page}

呼叫：/search?q=fastapi&page=2

類型

範例 URL

使用說明

靜態路由

/about

對應固定功能，如首頁、關於頁面

動態路由

/user/{user_id}

使用者變數輸入、依參數動態處理

查詢參數

/search?q=python&page=2

用於傳遞篩選、查詢、分頁等條件

理解靜態與動態路由的使用方式，能幫助你設計清晰、有彈性的 API 系統。

Last updated 2 months ago