読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 Pydanticで項目を定義する

2.1 本文の形をクラスで書く

第1節の body: dict は、どんな形の辞書でも受け取ります。items がなくても、quantity が文字でも、関数の中まで届いてしまいます。

本文の形を、Pydanticというパッケージのクラスで定義します。PydanticはFastAPIと一緒に入っています。

from fastapi import FastAPI
from pydantic import AwareDatetime, BaseModel, Field

app = FastAPI()


class ReservationItemIn(BaseModel):
    product_id: str = Field(alias="productId")
    quantity: int


class ReservationIn(BaseModel):
    name: str
    pickup_at: AwareDatetime = Field(alias="pickupAt")
    items: list[ReservationItemIn]


@app.post("/reservations")
def create_reservation(reservation: ReservationIn):
    return {"name": reservation.name, "count": len(reservation.items)}

class 名前(BaseModel): の下に、項目名: 型 を並べます。このような、データの形を定義したクラスをモデルと呼びます。

6 / 20