読み方のヒント

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

第5節 応答の項目を決める

5.1 受け付けた予約を返す

受け付けた予約を、リストに保存し、IDと状態を付けて返します。応答の形も、モデルで定義します。

from datetime import datetime

reservations = []


class ReservationItemOut(BaseModel):
    product_id: str = Field(serialization_alias="productId")
    quantity: int


class ReservationOut(BaseModel):
    id: str
    status: str
    name: str
    pickup_at: datetime = Field(serialization_alias="pickupAt")
    items: list[ReservationItemOut]


@app.post("/reservations", status_code=201, response_model=ReservationOut)
def create_reservation(reservation: ReservationIn):
    saved = {
        "id": f"R-{len(reservations) + 1:04d}",
        "status": "reserved",
        "name": reservation.name,
        "pickup_at": reservation.pickup_at,
        "items": [
            {"product_id": item.product_id, "quantity": item.quantity}
            for item in reservation.items
        ],
    }
    reservations.append(saved)
    return saved
INFO:     127.0.0.1:58450 - "POST /reservations HTTP/1.1" 201 Created
{"id": "R-0001", "status": "reserved", "name": "田中", "pickupAt": "2026-11-02T08:00:00+09:00", "items": [{"productId": "p001", "quantity": 1}, {"productId": "p002", "quantity": 2}]}
指定意味
status_code=201成功したときの状態コードを 201 Created(作成した)にする
response_model=ReservationOut応答を ReservationOut の形に合わせて返す
serialization_alias="pickupAt"応答のJSONでは pickupAt という名前で出す

"items" の [ … for item in reservation.items] は、明細を1つずつ取り出して辞書に直し、新しいリストを作る書き方です。f"R-{… :04d}" は、数を4桁にそろえて R-0001 の形にします。IDの数字は、保存した順に増えます。

reservations はメモリ上のリストなので、サーバーを止めると中身は消えます。データを残す方法は、データベースを使うときに扱います。

18 / 20