読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
受け付けた予約を、リストに保存し、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