読み方のヒント

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

第4節 状態変更の競合

4.1 予約済みのときだけキャンセルする

キャンセルの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回目のキャンセルreserved200、status は cancelled
2回目のキャンセルcancelled409、status_conflict

教材の完成例には、自分の予約の一覧を返す GET /reservations(固定の利用者の予約を受け取りの日時の順に返す)と、画面から呼ぶためのCORSの設定も加えてあります。画面とつなぐときに使います。

14 / 20