from fastapi import FastAPI
app = FastAPI()

@app.get("/items/")
async def read_items(skip: int = 0, limit: int = 10):
    # `skip`和`limit`就是查詢參數(shù)，如：/items/?skip=20&limit=5
    return {"skip": skip, "limit": limit}

@app.get("/items/{item_id}")
async def read_item(item_id: int):  # item_id 是路徑參數(shù)
    return {"item_id": item_id}

from fastapi import Body

@app.put("/items/{item_id}")
async def update_item(
    item_id: int,
    name: str = Body(...),  # Body(...) 表示必需項(xiàng)
    description: str = Body(None)  # Body(None) 表示可選項(xiàng)
):
    return {"item_id": item_id, "name": name, "description": description}

from fastapi import Form

@app.post("/login/")
async def login(username: str = Form(...), password: str = Form(...)):
    return {"username": username}

from fastapi import Path, Query, Body

@app.put("/mixed-items/{item_id}")
async def update_mixed_item(
    *,
    item_id: int = Path(..., title="商品ID", ge=1),  # 路徑參數(shù)，>=1
    q: str = Query(None, alias="query-string"),      # 可選查詢參數(shù)，別名
    item: dict = Body(...)                           # 必需的JSON請(qǐng)求體
):
    results = {"item_id": item_id}
    if q:
        results.update({"q": q})
    results.update({"item": item})
    return results

from pydantic import BaseModel, EmailStr
from typing import Optional, List

class UserCreate(BaseModel):
    # 必需字段
    username: str
    email: EmailStr  # 內(nèi)置郵箱格式驗(yàn)證
    # 可選字段，帶默認(rèn)值
    full_name: Optional[str] = None
    # 列表類(lèi)型
    tags: List[str] = []

@app.post("/users/")
async def create_user(user: UserCreate):  # 一個(gè)參數(shù)接管整個(gè)請(qǐng)求體
    # 直接訪問(wèn)已驗(yàn)證好的數(shù)據(jù)
    if user.full_name:
        greeting = f"Hello, {user.full_name}!"
    else:
        greeting = f"Hello, {user.username}!"
    return {"message": greeting, "user_info": user.dict()}

from fastapi import FastAPI, Path, Query, Body
from pydantic import BaseModel
from typing import Optional
from datetime import datetime

app = FastAPI(title="參數(shù)詳解示例")

class Item(BaseModel):
    name: str
    description: Optional[str] = None
    price: float = Body(..., gt=0)
    tax: Optional[float] = None
    tags: list = []

@app.post("/advanced-items/{category}")
async def create_advanced_item(
    category: str = Path(..., description="物品分類(lèi)"),
    item_id: int = Query(..., ge=1, description="物品ID"),
    q: Optional[str] = Query(None, max_length=50),
    urgent: bool = Query(False),
    item: Item = Body(..., example={  # 為文檔提供示例
        "name": "Foo",
        "price": 50.5,
        "tags": ["cool", "new"]
    })
):
    """創(chuàng)建新物品的復(fù)雜端點(diǎn)"""
    total = item.price + (item.tax if item.tax else 0)
    result = {
        "category": category,
        "item_id": item_id,
        "query_string": q,
        "urgent": urgent,
        "item_name": item.name,
        "total_price": total,
        "created_at": datetime.now().isoformat()
    }
    return result

if __name__ == "__main__":
    import uvicorn
    uvicorn.run(app, host="0.0.0.0", port=8000)