Idempotency nedir ve idempotency key'ler retry'ları nasıl güvenli kılar?

Question

IT Interview Practice · Accepted Answer

**Idempotency**, bir işlemi **birden çok kez gerçekleştirmenin, bir kez gerçekleştirmekle aynı etkiye sahip olması** demektir. Önemlidir çünkü ağlar güvenilmezdir: bir client bir istek gönderdiğinde ve response asla gelmediğinde, server'ın onu işleyip işlemediğini anlayamaz. Yeniden denerse, idempotent olmayan bir işlem iki kez çalışabilir.

## Sorun

```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` ve `DELETE` doğal olarak idempotent'tir, bu yüzden onları yeniden denemek güvenlidir. `POST` **değildir** — yinelenen ücretlendirmeler ve yinelenen order'lar tam olarak buradan gelir.

## Çözüm: idempotency key'ler

Client, mantıksal işlem için **benzersiz bir key** (genellikle bir UUID) üretir ve onu bir header'da gönderir. Server, key'i sonuçla birlikte saklar; aynı key tekrar gelirse, yeniden çalıştırmak yerine **saklanan** sonucu döndürür.

```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.)
```

Retry'da **aynı key**, aynı `200`'ü ve aynı ödemeyi verir — müşteriden bir kez ücret alınır. Stripe'ın API'si tam olarak böyle çalışır.

## Neden önemli

Bu soru, happy path için tasarlayan mühendisleri **başarısızlık** için tasarlayanlardan ayırır; production güvenilirliği de tam olarak budur. Dağıtık sistemler timeout'ların ve kısmi başarısızlıkların *olacağını* garanti eder, bu yüzden yan etkisi olan herhangi bir endpoint — ödemeler, order'lar, para gönderme — bir retry stratejisine ihtiyaç duyar ve "sadece yeniden dene" `POST` için tehlikelidir. Mülakatçı iki parçalı içgörüyü duymak ister: birincisi, idempotency *tasarıma dahil edebileceğiniz* bir özelliktir (`PUT`/`DELETE`'i doğal olarak güvenli kılmak ve olamadığında `POST`'a bir **idempotency key** vermek); ikincisi, ince eşzamanlılık ayrıntısı — aynı anda gelen iki retry ikisi birden çalışmamalıdır, bu yüzden key kontrolü ve yazma bir lock ya da unique constraint gerektirir. Bunu doğru yapmak, bir müşteriden bir kez ücret almak ile iki kez almak arasındaki farktır; her ciddi ödeme ve ticaret API'sinin onu uygulamasının nedeni budur.

Sorun

Çözüm: idempotency key'ler

Neden önemli

İlgili sorular