読み方のヒント

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

第2節 一意制約と再送用のキー

2.2 同じ内容か、違う内容か

キーの記録には、要求の内容から計算した値 request_hash も残します。

def request_hash(name: str, pickup_at: datetime, items: list[dict]) -> str:
    content = {
        "name": name,
        "pickupAt": pickup_at.isoformat(),
        "items": sorted(items, key=lambda item: item["product_id"]),
    }
    text = json.dumps(content, ensure_ascii=False, sort_keys=True)
    return hashlib.sha256(text.encode("utf-8")).hexdigest()

hashlib.sha256 は、文字列から64文字の値を計算します。同じ文字列からは必ず同じ値になり、少しでも違えば別の値になります。

計算の前に、内容をそろえます。明細は商品IDの順に並べ、日時は日本時間に直した表し方にします。明細の順番が違うだけの要求や、2026-11-01T23:00:00Z と 2026-11-02T08:00:00+09:00 のように同じ瞬間の別の書き方は、同じ内容として扱われます。

create_reservation は、最初にキーの記録を探します。

    saved = find_request(session, idempotency_key)
    if saved is not None:
        return replay(session, saved, hash_value, response)
def replay(session: Session, saved: ReservationRequest, hash_value: str, response: Response):
    if saved.request_hash != hash_value:
        raise error(409, "idempotency_key_reused", "同じ再送用のキーで、違う内容が送られました")
    response.status_code = 200
    return to_detail(session.get(Reservation, saved.reservation_id))
要求応答
新しいキー予約を作り、201
同じキー、同じ内容1回目の予約を、200 で返す
同じキー、違う内容409 Conflict で断る

409 は、要求がサーバーの今の状態と食い違うことを表す状態コードです。

予約を作るときは、予約、明細、キーの記録を、同じ commit で確定します。

    session.add(reservation)
    session.add(ReservationRequest(user_id=FIXED_USER_ID, idempotency_key=idempotency_key,
                                   request_hash=hash_value, reservation_id=reservation.id))
解答
  1. 200 と、1回目と同じ R-ac248ad3 の予約が返ります。予約は増えません。
  2. 409 と、code が idempotency_key_reused のエラーが返ります。内容を変えた予約は、新しいキーで送ります。

7 / 20