Idempotency म्हणजे काय, आणि idempotency keys retries कशा सुरक्षित करतात?

Question

IT Interview Practice · Accepted Answer

**Idempotency** म्हणजे एखादी operation **अनेक वेळा केल्याने एकदा केल्यासारखाच परिणाम होतो**. हे महत्त्वाचे आहे कारण networks अविश्वासार्ह असतात: जेव्हा client request पाठवतो आणि response कधीच येत नाही, तेव्हा server ने त्यावर प्रक्रिया केली का हे त्याला सांगता येत नाही. जर तो retry करतो, तर non-idempotent operation दोनदा चालू शकते.

## समस्या

```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`, आणि `DELETE` नैसर्गिकरित्या idempotent आहेत, म्हणून त्यांना retry करणे सुरक्षित आहे. `POST` **नाही** — duplicate charges आणि duplicate orders नेमके इथूनच येतात.

## उपाय: idempotency keys

Client त्या logical operation साठी एक **unique key** (सहसा UUID) तयार करतो आणि तो एका header मध्ये पाठवतो. Server ती key निकालासह साठवतो; तीच key पुन्हा आल्यास, तो पुन्हा execute करण्याऐवजी **साठवलेला** निकाल परत करतो.

```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 वर **तीच key** तोच `200` आणि तेच payment देते — ग्राहकाकडून एकदाच शुल्क आकारले जाते. Stripe ची API नेमकी अशीच चालते.

## हे का महत्त्वाचे आहे

हा प्रश्न happy path साठी design करणाऱ्या engineers ना **failure** साठी design करणाऱ्यांपासून वेगळे करतो, आणि production reliability चा तोच गाभा आहे. Distributed systems हमी देतात की timeouts आणि आंशिक अपयश *होणारच*, म्हणून side effects असलेल्या कोणत्याही endpoint ला — payments, orders, पैसे पाठवणे — retry ची योजना लागते, आणि "फक्त retry" `POST` साठी धोकादायक आहे. Interviewer ला दोन-भागी अंतर्दृष्टी ऐकायची असते: पहिला, idempotency हा एक गुणधर्म आहे जो तुम्ही *design मध्ये आणू* शकता (`PUT`/`DELETE` नैसर्गिकरित्या सुरक्षित करणे, आणि `POST` सुरक्षित नसताना त्याला एक **idempotency key** देणे), आणि दुसरा, सूक्ष्म concurrency तपशील — एकाच वेळी येणाऱ्या दोन retries दोन्ही execute होता कामा नयेत, म्हणून key तपासणी आणि लेखनाला lock किंवा unique constraint लागते. हे बरोबर मिळवणे हाच ग्राहकाकडून एकदा शुल्क आकारणे आणि दोनदा आकारणे यातील फरक आहे, म्हणूनच प्रत्येक गंभीर payments आणि commerce API ते अंमलात आणते.

समस्या

उपाय: idempotency keys

हे का महत्त्वाचे आहे

संबंधित प्रश्न