読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
キャンセルのAPIは、POST /reservations/{id}/cancel です。
@app.post("/reservations/{reservation_id}/cancel", response_model=ReservationDetail)
def cancel_reservation(reservation_id: str, session: SessionDep):
reservation = session.get(Reservation, reservation_id)
if reservation is None or reservation.user_id != FIXED_USER_ID:
raise error(404, "reservation_not_found", "予約が見つかりません")
result = session.execute(
update(Reservation)
.where(Reservation.id == reservation_id, Reservation.status == "reserved")
.values(status="cancelled", cancelled_at=now_jst())
)
if result.rowcount == 0:
session.rollback()
raise error(409, "status_conflict", "この予約は、すでに受け取り済みかキャンセル済みです")
session.commit()
session.refresh(reservation)
return to_detail(reservation)
update(Reservation).where(…).values(…) は、次のSQLを組み立てます。
UPDATE reservations SET status = 'cancelled', cancelled_at = …
WHERE id = 'R-0001' AND status = 'reserved';
result.rowcount は、書き換えた行の数です。0なら、予約済みではなかったため、409 を返します。session.refresh(reservation) は、書き換えた後の値をデータベースから読み直します。
| 要求 | 予約の状態 | 応答 |
|---|---|---|
| 1回目のキャンセル | reserved | 200、status は cancelled |
| 2回目のキャンセル | cancelled | 409、status_conflict |
教材の完成例には、自分の予約の一覧を返す GET /reservations(固定の利用者の予約を受け取りの日時の順に返す)と、画面から呼ぶためのCORSの設定も加えてあります。画面とつなぐときに使います。
14 / 20