読み方のヒント
矢印ボタン(または ← → キー)でページを移動できます。
画面の側は、1回の予約の操作ごとに、新しい文字列を1つ作ります。送り直すときは、同じ文字列を付けます。この文字列を、要求の Idempotency-Key ヘッダーに入れて送ります。
POST /reservations HTTP/1.1
content-type: application/json
Idempotency-Key: k-20261101-0001
{"name": "田中", "pickupAt": "2026-11-02T08:00:00+09:00", "items": [...]}
ヘッダーは、要求の本文とは別に付ける、名前と値の組です。Idempotency-Key は、「同じキーの要求は、何回届いても1回分として扱ってほしい」という意味で使われる名前です。
FastAPIでは、Header で受け取ります。
@app.post("/reservations", status_code=201, response_model=ReservationDetail)
def create_reservation(
body: ReservationIn,
session: SessionDep,
response: Response,
idempotency_key: Annotated[str, Header(min_length=8, max_length=100)],
):
引数名の idempotency_key は、ヘッダーの Idempotency-Key に対応します。ヘッダーがない要求は、422 の "loc": ["header", "idempotency-key"] で断られます。
キーを記録する表は、Alembicの変更ファイルで加えます。
def upgrade() -> None:
op.create_table(
"reservation_requests",
sa.Column("user_id", sa.Integer(), sa.ForeignKey("users.id"), nullable=False),
sa.Column("idempotency_key", sa.Text(), nullable=False),
sa.Column("request_hash", sa.Text(), nullable=False),
sa.Column("reservation_id", sa.Text(), sa.ForeignKey("reservations.id"), nullable=False),
sa.PrimaryKeyConstraint("user_id", "idempotency_key"),
)
alembic upgrade head で適用し、models.py に対応する ReservationRequest のクラスを加えます。
6 / 20