読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
キーの記録には、要求の内容から計算した値 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))
200 と、1回目と同じ R-ac248ad3 の予約が返ります。予約は増えません。409 と、code が idempotency_key_reused のエラーが返ります。内容を変えた予約は、新しいキーで送ります。7 / 20