Što je idempotentnost i kako idempotency ključevi čine ponavljanja sigurnima?

Question

IT Interview Practice · Accepted Answer

**Idempotentnost** znači da izvođenje operacije **više puta ima isti učinak kao izvođenje jednom**. Važna je jer su mreže nepouzdane: kad klijent pošalje zahtjev, a odgovor nikad ne stigne, ne može znati je li ga server obradio. Ako ponovi, neidempotentna operacija mogla bi se izvršiti dvaput.

## Problem

```text
Client ──POST /payments {$100}──▶ Server   (naplaćuje $100 ✓)
Client ◀────────X (timeout)────── Server   (odgovor izgubljen)
Client ──POST /payments {$100}──▶ Server   (naplaćuje $100 PONOVNO ✗ → $200!)
```

`GET`, `PUT` i `DELETE` prirodno su idempotentni, pa je njihovo ponavljanje sigurno. `POST` **nije** — upravo odatle dolaze dvostruke naplate i dvostruke narudžbe.

## Rješenje: idempotency ključevi

Klijent generira **jedinstveni ključ** (obično UUID) za logičku operaciju i šalje ga u headeru. Server pohranjuje ključ s rezultatom; ako isti ključ ponovno stigne, vraća **pohranjeni** rezultat umjesto ponovnog izvršavanja.

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

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

```text
Logika servera pri primanju zahtjeva s Idempotency-Key:
  1. Potraži ključ u pohrani (npr. Redis/DB).
  2. Ako je pronađen → vrati spremljeni odgovor (bez ponovne naplate).   ← slučaj ponavljanja
  3. Ako nije      → obradi, spremi (ključ → odgovor), zatim vrati.
  (Omotaj korak 3 u transakciju / lock kako istovremena ponavljanja ne bi izvršila dvaput.)
```

**Isti ključ** pri ponavljanju daje isti `200` i istu uplatu — kupac je naplaćen jednom. Upravo tako radi Stripeov API.

## Zašto je to važno

Ovo pitanje razdvaja inženjere koji dizajniraju za sretni put od onih koji dizajniraju za **kvar**, što je bit produkcijske pouzdanosti. Distribuirani sustavi jamče da će se timeoutovi i djelomični kvarovi *dogoditi*, pa svaki endpoint s nuspojavama — plaćanja, narudžbe, slanje novca — treba priču o ponavljanju, a "samo ponovi" opasno je za `POST`. Ispitivač želi čuti dvodijelni uvid: prvo, da je idempotentnost svojstvo koje možete *ugraditi u dizajn* (čineći `PUT`/`DELETE` prirodno sigurnima i dajući `POST`-u **idempotency ključ** kad ne može biti), i drugo, suptilni detalj konkurentnosti — dva ponavljanja koja stignu istovremeno ne smiju se oba izvršiti, pa provjera ključa i pisanje trebaju lock ili unique constraint. Ispravno rješavanje ovoga razlika je između jednokratne i dvostruke naplate kupca, zbog čega ga svaki ozbiljan API za plaćanja i trgovinu implementira.

Problem

Rješenje: idempotency ključevi

Zašto je to važno

Povezana pitanja