---
title: "Idempotency key क्या है? API रीट्राई को सुरक्षित बनाना"
description: "Idempotency key क्लाइंट की बनाई एक यूनिक ID है जो अनुरोध के साथ जाती है, ताकि रीट्राई उसका असर, जैसे दूसरा चार्ज, न दोहराए। यह कैसे काम करती है, और IETF हेडर।"
url: https://broadrouter.com/hi/glossary/idempotency-key/
lang: hi
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

यह पेज अंग्रेज़ी से AI की मदद से अनुवाद किया गया है। [अंग्रेज़ी मूल पढ़ें](https://broadrouter.com/glossary/idempotency-key/) (2026-11-14 को अपडेट किया गया).

# Idempotency key (आइडेम्पोटेंसी key)

अपडेट किया गया 2026-11-14

Idempotency key एक यूनिक वैल्यू है, आम तौर पर UUID जैसी रैंडम ID, जिसे क्लाइंट स्टेट बदलने वाले अनुरोध, जैसे पेमेंट या ख़रीद, के साथ जोड़ता है। अगर वही अनुरोध उसी key के साथ दोबारा आए, तो सर्वर काम दो बार करने के बजाय पहला नतीजा लौटाता है।

अन्य नाम: आइडेम्पोटेंसी key, आइडेम्पोटेंट अनुरोध, सुरक्षित रीट्राई, idempotency key kya hai, idempotent kya hota hai, idempotency key, Idempotency-Key header, idempotency token, idempotent request, idempotent retry

नेटवर्क सबसे बुरी जगह पर फ़ेल होते हैं: सर्वर के काम कर लेने के बाद, लेकिन आपको जवाब मिलने से पहले। Idempotency key रीट्राई को सुरक्षित बनाती है।

## यह कैसे काम करती है

क्लाइंट एक इच्छित काम के लिए एक यूनिक key बनाता है और उसे अनुरोध के साथ भेजता है। सर्वर key को नतीजे के साथ सहेज लेता है। अगर वही key फिर आए, तो सर्वर दोबारा काम करने के बजाय सहेजा हुआ नतीजा लौटा देता है।

IETF HTTPAPI वर्किंग ग्रुप इसे `Idempotency-Key` request हेडर के रूप में मानक बना रहा है (ड्राफ़्ट 08, अक्टूबर 2026, अभी RFC नहीं)। यह key को “a unique value generated by the client which the resource uses to recognize subsequent retries of the same request” (अनुवाद: क्लाइंट की बनाई एक यूनिक वैल्यू, जिससे रिसोर्स उसी अनुरोध के बाद के रीट्राई पहचानता है) बताता है और UUID या वैसी ही रैंडम ID की सलाह देता है। ड्राफ़्ट के एरर केस:

| स्थिति | स्टेटस |
| --- | --- |
| ज़रूरी होने पर भी key नहीं है | 400 Bad Request |
| पहला अनुरोध अभी चल रहा है | 409 Conflict |
| key किसी अलग body के साथ दोबारा इस्तेमाल हुई | 422 Unprocessable Content |

AWS की Builders’ Library क्लाइंट की तरफ़ से यही बात कहती है: “APIs with side effects aren’t safe to retry unless they provide idempotency.” (अनुवाद: side effect वाले API तब तक रीट्राई के लिए सुरक्षित नहीं, जब तक वे idempotency न दें।)

## यह क्यों मायने रखती है

[Exponential backoff](https://broadrouter.com/hi/glossary/exponential-backoff/) के साथ रीट्राई आम चलन है, और कई SDK अपने-आप रीट्राई करते हैं। idempotency के बिना, timeout के बाद का रीट्राई दो ऑर्डर या दो चार्ज बना सकता है। key के साथ, पहली कोशिश ने चाहे जो किया हो, रीट्राई सुरक्षित है। इसलिए यह उन agents और स्क्रिप्ट के लिए एक बुनियादी औज़ार है जो बिना किसी इंसान की निगरानी के कुछ ख़रीदते, बुक करते या बनाते हैं।

## BroadNet Inference पर

BroadNet यह पैटर्न [hourly key](https://broadrouter.com/hi/blog/hourly-llm-api-key-explained/) ख़रीदने के लिए इस्तेमाल करता है। `POST /portal/keys/hourly` JSON body में एक `request_id` लेता है, और डॉक्स कहते हैं कि “Idempotency is required for money safety” (अनुवाद: पैसों की सुरक्षा के लिए idempotency ज़रूरी है):

```bash
curl -X POST https://inference.broadnet.ai/portal/keys/hourly \
  -H "Authorization: Bearer <portal-credential>" \
  -H "Content-Type: application/json" \
  -d '{"request_id":"order-20260920-001","label":"kiosk-1"}'
```

किसी `request_id` को दोबारा इस्तेमाल करने से न कोई और key बनती है, न कोई और चार्ज लगता है। timeout, टूटे कनेक्शन, 409 `mint_in_progress` या 5xx के बाद उसी `request_id` के साथ रीट्राई करें। दोहराया गया अनुरोध `already_issued: true` और key का alias लौटाता है; असली key सिर्फ़ पहले सफल जवाब में होती है। डॉक्स कहते हैं: “Never generate a replacement id until the original result is known.” (अनुवाद: जब तक मूल नतीजा पता न हो, कभी बदले में नई id न बनाएँ।)

BroadNet `/v1/chat/completions` या transcriptions के लिए कोई idempotency key दर्ज नहीं करता। वहाँ किसे रीट्राई करना है, इसके लिए [एरर कोड और रीट्राई](https://broadrouter.com/hi/guides/errors-and-retries/) देखें, और यह समझने के लिए कि अंधाधुंध रीट्राई 429 को और ख़राब क्यों कर सकते हैं, [रेट लिमिट](https://broadrouter.com/hi/glossary/rate-limit/) देखें।

## अक्सर पूछे जाने वाले सवाल

### नई idempotency key कब बनानी चाहिए?

सिर्फ़ किसी नए इच्छित काम के लिए। एक काम के हर रीट्राई में वही key दोबारा इस्तेमाल करें, और जब तक पहली कोशिश का नतीजा पता न चल जाए, नई key न बनाएँ।

### क्या LLM chat completion अनुरोधों को idempotency key चाहिए?

टेक्स्ट जनरेट करने का कोई स्थायी side effect नहीं होता, इसलिए दोहराया गया चैट अनुरोध आम तौर पर बस दोबारा टोकन का ख़र्च करता है। key उन कॉल के लिए मायने रखती है जो पैसे काटती हैं या रिसोर्स बनाती हैं। BroadNet इसे सिर्फ़ hourly key की ख़रीद के लिए दर्ज करता है, chat completions के लिए नहीं।

### अगर मैं वही key किसी अलग request body के साथ दोबारा भेजूँ तो क्या होगा?

IETF ड्राफ़्ट कहता है कि सर्वर को उसे 422 Unprocessable Content के साथ ठुकरा देना चाहिए, क्योंकि वह key पहले से किसी दूसरे अनुरोध से जुड़ी है।

## यह भी देखें

-   [एक्सपोनेंशियल बैकऑफ़ (exponential backoff)](https://broadrouter.com/hi/glossary/exponential-backoff/) (शब्द)
-   [रेट लिमिट (rate limit)](https://broadrouter.com/hi/glossary/rate-limit/) (शब्द)
-   [API key](https://broadrouter.com/hi/glossary/api-key/) (शब्द)
-   [कॉन्करेंसी (concurrency)](https://broadrouter.com/hi/glossary/concurrency/) (शब्द)
-   [BroadNet Inference के एरर कोड और रीट्राई कब करें](https://broadrouter.com/hi/guides/errors-and-retries/) (गाइड)
-   [IP allow-list से API key को अपने सर्वर तक सीमित करें](https://broadrouter.com/hi/guides/api-keys-ip-allow-lists/) (गाइड)
-   [लंबे चलने वाले एजेंट: टिकाऊ timeout, retry और checkpoint](https://broadrouter.com/hi/blog/long-running-agents-timeouts-retries/) (लेख)
-   [घंटे वाली LLM API key: प्रति घंटा तय कीमत, आसान भाषा में](https://broadrouter.com/hi/blog/hourly-llm-api-key-explained/) (लेख)

इसे अपने असली वर्कलोड पर आज़माएँ। नए अकाउंट Gemma और ट्रांसक्रिप्शन के लिए US$5 के क्रेडिट से शुरू होते हैं। DeepSeek, GLM, और Qwen3.8 के लिए टॉप-अप ज़रूरी है।

[शुरू करें](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=hi-glossary-idempotency-key&utm_content=page-cta) ·

**स्रोत**

-   [IETF HTTPAPI, The Idempotency-Key HTTP Header Field (Internet-Draft)](https://datatracker.ietf.org/doc/draft-ietf-httpapi-idempotency-key-header/)
-   [AWS Builders' Library, Timeouts, retries and backoff with jitter (idempotency tokens)](https://builder.aws.com/content/3EumjoZascWd1oZiEgL8ORlv3qE/timeouts-retries-and-backoff-with-jitter)
-   [BroadNet Inference API रेफ़रंस, hourly key (request\_id idempotency) (अंग्रेज़ी में)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=hi-glossary-idempotency-key&utm_content=sources#hourly-keys)
