Apa iku idempotency, lan kepiye idempotency key ndadekake retry aman?

Question

IT Interview Practice · Accepted Answer

**Idempotency** ateges nglakoni operasi **kaping bola-bali duwe efek sing padha karo nglakoni sepisan**. Iki penting amarga jaringan ora bisa dipercaya: nalika client ngirim request lan response ora tau teka, dheweke ora bisa ngerti apa server wis ngolah. Yen retry, operasi non-idempotent bisa mlaku kaping pindho.

## Masalahe

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

`GET`, `PUT`, lan `DELETE` sacara alami idempotent, mula nyoba maneh iku aman. `POST` iku **ora** — iki persis papan asale tagihan dobel lan order dobel.

## Solusine: idempotency key

Client nggawe **key unik** (biasane UUID) kanggo operasi logis kasebut lan ngirim ing header. Server nyimpen key kasebut karo asile; yen key sing padha teka maneh, dheweke mbalekake asil **sing kasimpen** tinimbang nglakoni maneh.

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

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

```text
Logika server nalika nampa request sing ana Idempotency-Key:
  1. Golek key ing store (contone Redis/DB).
  2. Yen ketemu → balekake response sing kasimpen (ora narik maneh).     ← kasus retry
  3. Yen ora  → proses, simpen (key → response), banjur balekake.
  (Bungkus langkah 3 ing transaksi / lock supaya retry bebarengan ora nglakoni kaping pindho.)
```

**Key sing padha** nalika retry ngasilake `200` sing padha lan pembayaran sing padha — pelanggan mung ditarik sepisan. Iki persis carane API Stripe mlaku.

## Kenapa iki penting

Pitakonan iki misahake insinyur sing ngrancang kanggo happy path saka sing ngrancang kanggo **kegagalan**, sing dadi inti keandalan produksi. Sistem terdistribusi njamin yen timeout lan kegagalan sebagian *bakal* kelakon, mula endpoint apa wae sing duwe efek samping — pembayaran, order, ngirim dhuwit — butuh crita retry, lan "cukup retry" iku mbebayani kanggo `POST`. Pewawancara pengin krungu wawasan rong bagian: kapisan, yen idempotency iku properti sing bisa kokrancang (ndadekake `PUT`/`DELETE` alami aman, lan menehi `POST` sawijining **idempotency key** nalika dheweke ora bisa), lan kapindho, detail concurrency sing alus — rong retry sing teka bebarengan ora kena loro-lorone mlaku, mula pamriksan key lan tulis butuh lock utawa unique constraint. Ndadekake iki bener iku bedane antara narik pelanggan sepisan lan narik dheweke kaping pindho, iki sebabe saben API pembayaran lan perdagangan sing serius ngetrapake.

Masalahe

Solusine: idempotency key

Kenapa iki penting

Pitakon sing gegandhengan