🚀 FastAPI

FastAPI 是一個高性能的網絡應用框架，基於 Python 3.5+ 和 Pydantic v1.x 構建。它融合了現代 Web 開發的最佳實踐與快速開發理念，能助力開發者高效構建 RESTful API 和即時 Web 應用。

🚀 快速開始

FastAPI 是一個基於 Python 3.5+ 和 Pydantic v1.x 構建的高性能網絡應用框架。它結合了現代 Web 開發的最佳實踐和快速開發的理念，幫助開發者高效地構建 RESTful API 和即時 Web 應用。

✨ 主要特性

高性能：FastAPI 使用 async/await 異步編程模型，可輕鬆處理高併發請求。
簡單易用：藉助 Pydantic 模型和 Python 類型提示，能快速定義 API 的請求和響應結構。
自動文檔：內置 Swagger UI 和 ReDoc，無需額外配置即可生成交互式 API 文檔。
可擴展性：支持中間件、自定義路由和插件，便於進行功能擴展。

📦 安裝指南

要開始使用 FastAPI，首先需要安裝必要的依賴：

pip install fastapi[all]

這會安裝 FastAPI 以及其所有依賴項，包括 Pydantic 和 Starlette。

💻 使用示例

基礎用法

創建一個簡單的 FastAPI 應用：

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
async def root():
    return {"message": "Hello World"}

運行應用：

uvicorn main:app --reload

然後在瀏覽器中訪問 http://localhost:8000，可以看到自動生成的 Swagger UI。

高級用法

路徑參數

@app.get("/items/{item_id}")
async def read_item(item_id: str):
    return {"item_id": item_id}

訪問 http://localhost:8000/items/5 會返回 {"item_id": "5"}。

查詢參數

@app.get("/items")
async def read_items(q: str = None):
    if q:
        return {"q": q}
    else:
        return {"message": "No query string received"}

訪問 http://localhost:8000/items?q=hello 會返回 {"q": "hello"}。

請求體參數

from typing import Optional
import json

@app.post("/items")
async def create_item(data: dict):
    return data

發送一個 POST 請求到 /items，請求體為：

{
    "name": "item1",
    "price": 10.5
}

會返回相同的 JSON 數據。

中間件

FastAPI 允許添加中間件來擴展功能。例如，可以添加日誌記錄中間件：

@app.middleware("http")
async def log_request(request, call_next):
    print(f"Request received: {request.url}")
    response = await call_next(request)
    print(f"Response sent: {response.status_code}")
    return response