Apakah itu idempotency, dan bagaimana idempotency key menjadikan retry selamat?

Question

IT Interview Practice · Accepted Answer

**Idempotency** bermaksud melaksanakan operasi **berbilang kali mempunyai kesan sama seperti melaksanakannya sekali**. Ia penting kerana rangkaian tidak boleh dipercayai: apabila client menghantar request dan response tidak pernah tiba, ia tidak boleh mengetahui sama ada server telah memprosesnya. Jika ia retry, operasi bukan-idempotent mungkin berjalan dua kali.

## Masalah

```text
Client ──POST /payments {$100}──▶ Server   (caj $100 ✓)
Client ◀────────X (timeout)────── Server   (response hilang)
Client ──POST /payments {$100}──▶ Server   (caj $100 SEKALI LAGI ✗ → $200!)
```

`GET`, `PUT`, dan `DELETE` secara semula jadi idempotent, jadi me-retry-nya selamat. `POST` **tidak** — inilah tepatnya punca caj berganda dan order berganda.

## Penyelesaian: idempotency key

Client menjana **key unik** (lazimnya UUID) untuk operasi logik itu dan menghantarnya dalam header. Server menyimpan key bersama hasil; jika key yang sama tiba semula, ia memulangkan hasil **yang disimpan** dan bukannya melaksana semula.

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

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

```text
Logik server apabila menerima request dengan Idempotency-Key:
  1. Cari key dalam store (cth. Redis/DB).
  2. Jika jumpa → pulangkan response yang disimpan (tiada caj semula).      ← kes retry
  3. Jika tiada → proses, simpan (key → response), kemudian pulangkan.
  (Balut langkah 3 dalam transaction / lock supaya retry serentak tidak melaksana dua kali.)
```

**Key yang sama** ketika retry menghasilkan `200` yang sama dan payment yang sama — pelanggan dicaj sekali. Inilah tepatnya cara API Stripe berfungsi.

## Mengapa ia penting

Soalan ini memisahkan jurutera yang mereka bentuk untuk laluan gembira daripada mereka yang mereka bentuk untuk **kegagalan**, yang merupakan intipati kebolehpercayaan production. Sistem teragih menjamin bahawa timeout dan kegagalan separa *akan* berlaku, jadi mana-mana endpoint dengan kesan sampingan — pembayaran, order, menghantar wang — memerlukan cerita retry, dan "retry sahaja" adalah berbahaya untuk `POST`. Penemu duga mahu mendengar cerapan dua bahagian: pertama, bahawa idempotency ialah sifat yang boleh anda *reka bentuk masuk* (menjadikan `PUT`/`DELETE` selamat secara semula jadi, dan memberi `POST` satu **idempotency key** apabila ia tidak boleh); dan kedua, butiran concurrency yang halus — dua retry yang tiba serentak tidak boleh kedua-duanya melaksana, jadi semakan key dan penulisan memerlukan lock atau unique constraint. Membuatnya betul ialah perbezaan antara mengecaj pelanggan sekali dan mengecajnya dua kali, sebab itulah setiap API pembayaran dan perdagangan yang serius melaksanakannya.

Masalah

Penyelesaian: idempotency key

Mengapa ia penting

Soalan berkaitan