Kaj je idempotentnost in kako idempotency keys naredijo ponovne poskuse varne?

Question

IT Interview Practice · Accepted Answer

**Idempotentnost (idempotency)** pomeni, da ima izvedba operacije **večkrat enak učinek kot izvedba enkrat**. Pomembna je, ker so omrežja nezanesljiva: ko odjemalec pošlje zahtevo, odgovor pa nikoli ne prispe, ne more vedeti, ali jo je strežnik obdelal. Če jo ponovi, se neidempotentna operacija lahko izvede dvakrat.

## Težava

```text
Client ──POST /payments {$100}──▶ Server   (charges $100 ✓)
Client ◀────────X (timeout)────── Server   (response lost)
Client ──POST /payments {$100}──▶ Server   (charges $100 AGAIN ✗ → $200!)
```

`GET`, `PUT` in `DELETE` so naravno idempotentni, zato je njihova ponovitev varna. `POST` **ni** — prav od tod izvirajo podvojene bremenitve in podvojena naročila.

## Rešitev: idempotency keys

Odjemalec za logično operacijo ustvari **enoličen ključ** (običajno UUID) in ga pošlje v glavi. Strežnik ključ shrani skupaj z rezultatom; če isti ključ prispe znova, vrne **shranjeni** rezultat, namesto da bi ponovno izvedel.

```http
POST /payments HTTP/1.1
Idempotency-Key: 5f2b8c1e-3a4d-4e6f-9c0b-1a2b3c4d5e6f
Content-Type: application/json

{ "amount": 100, "currency": "usd" }
```

```text
Server logic on receiving a request with an Idempotency-Key:
  1. Look up the key in a store (e.g. Redis/DB).
  2. If found → return the saved response (no re-charge).      ← the retry case
  3. If not  → process, save (key → response), then return.
  (Wrap 3 in a transaction / lock so concurrent retries don't double-execute.)
```

**Isti ključ** ob ponovitvi da isti `200` in isto plačilo — stranka je bremenjena enkrat. Točno tako deluje Stripov API.

## Zakaj je to pomembno

To vprašanje loči inženirje, ki načrtujejo za srečno pot, od tistih, ki načrtujejo za **odpoved**, kar je bistvo zanesljivosti v produkciji. Porazdeljeni sistemi zagotavljajo, da se prekinitve (timeouts) in delne odpovedi *bodo* zgodile, zato vsak endpoint s stranskimi učinki — plačila, naročila, pošiljanje denarja — potrebuje zgodbo o ponovnem poskusu, in "kar ponovi" je za `POST` nevarno. Spraševalec želi slišati dvodelni uvid: prvič, da je idempotentnost lastnost, ki jo lahko *vgradite v zasnovo* (`PUT`/`DELETE` naredite naravno varne, `POST` pa dobi **idempotency key**, kadar ne more biti), in drugič, tanek podatek o sočasnosti — dve hkrati prispeli ponovitvi se ne smeta obe izvesti, zato preverjanje ključa in pisanje potrebujeta lock ali unique constraint. Če to naredite prav, je to razlika med enkratno in dvakratno bremenitvijo stranke, zato to implementira vsak resen plačilni in trgovinski API.

Težava

Rešitev: idempotency keys

Zakaj je to pomembno

Povezana vprašanja