---
title: "Idempotency key کیا ہے؟ API پر محفوظ دوبارہ کوشش | BroadRouter"
description: "Idempotency key کلائنٹ کی بنائی ایک منفرد ID ہے جو درخواست کے ساتھ جاتی ہے، تاکہ دوبارہ کوشش اس کا اثر، جیسے دوسرا چارج، نہ دہرائے۔ طریقہ کار اور IETF ہیڈر۔"
url: https://broadrouter.com/ur/glossary/idempotency-key/
lang: ur
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 (آئیڈیمپوٹینسی کلید)

اپ ڈیٹ 2026-11-14

Idempotency key ایک منفرد قدر ہے، عموماً UUID جیسی رینڈم ID، جسے کلائنٹ اسٹیٹ بدلنے والی درخواست، جیسے ادائیگی یا خریداری، کے ساتھ لگاتا ہے۔ اگر وہی درخواست اسی کلید کے ساتھ دوبارہ آئے تو سرور کام دو بار کرنے کے بجائے پہلا نتیجہ لوٹاتا ہے۔

دوسرے نام: آئیڈیمپوٹینسی کلید، آئیڈیمپوٹینٹ درخواست، محفوظ دوبارہ کوشش، idempotency key kya hai، idempotent ka matlab، idempotency key، Idempotency-Key header، idempotency token، idempotent request، idempotent retry

نیٹ ورک سب سے بری جگہ پر ناکام ہوتے ہیں: سرور کے کام کر لینے کے بعد، لیکن آپ کو جواب ملنے سے پہلے۔ Idempotency key دوبارہ کوشش کو محفوظ بناتی ہے۔

## یہ کیسے کام کرتی ہے

کلائنٹ ایک مطلوبہ کام کے لیے ایک منفرد کلید بناتا ہے اور اسے درخواست کے ساتھ بھیجتا ہے۔ سرور کلید کو نتیجے کے ساتھ محفوظ کر لیتا ہے۔ اگر وہی کلید دوبارہ آئے تو سرور دوبارہ کام کرنے کے بجائے محفوظ نتیجہ لوٹا دیتا ہے۔

IETF HTTPAPI ورکنگ گروپ اسے `Idempotency-Key` request ہیڈر کے طور پر معیاری بنا رہا ہے (ڈرافٹ 08، اکتوبر 2026، ابھی RFC نہیں)۔ یہ کلید کو “a unique value generated by the client which the resource uses to recognize subsequent retries of the same request” (ترجمہ: کلائنٹ کی بنائی ایک منفرد قدر، جس سے ریسورس اسی درخواست کی بعد والی کوششیں پہچانتا ہے) بیان کرتا ہے اور UUID یا اسی طرح کی رینڈم ID کا مشورہ دیتا ہے۔ ڈرافٹ کے ایرر کیسز:

| صورتحال | اسٹیٹس |
| --- | --- |
| ضرورت کے باوجود کلید موجود نہیں | 400 Bad Request |
| اصل درخواست ابھی جاری ہے | 409 Conflict |
| کلید کسی مختلف body کے ساتھ دوبارہ استعمال ہوئی | 422 Unprocessable Content |

AWS کی Builders’ Library کلائنٹ کی طرف سے یہی بات کہتی ہے: “APIs with side effects aren’t safe to retry unless they provide idempotency.” (ترجمہ: side effects والے APIs پر دوبارہ کوشش تب تک محفوظ نہیں جب تک وہ idempotency فراہم نہ کریں۔)

## یہ کیوں اہم ہے

[Exponential backoff](https://broadrouter.com/ur/glossary/exponential-backoff/) کے ساتھ دوبارہ کوشش عام طریقہ ہے، اور کئی SDKs خود بخود دوبارہ کوشش کرتے ہیں۔ idempotency کے بغیر، timeout کے بعد کی دوبارہ کوشش دو آرڈر یا دو چارج بنا سکتی ہے۔ کلید کے ساتھ، پہلی کوشش نے جو بھی کیا ہو، دوبارہ کوشش محفوظ ہے۔ اسی لیے یہ ان agents اور اسکرپٹس کے لیے ایک بنیادی آلہ ہے جو کسی انسان کی نگرانی کے بغیر کچھ خریدتے، بُک کرتے یا بناتے ہیں۔

## BroadNet Inference پر

BroadNet یہ پیٹرن [گھنٹے والی کلیدیں](https://broadrouter.com/ur/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` کو دوبارہ استعمال کرنے سے نہ کوئی اور کلید بنتی ہے، نہ کوئی اور چارج لگتا ہے۔ timeout، ٹوٹے کنکشن، 409 `mint_in_progress` یا 5xx کے بعد اسی `request_id` کے ساتھ دوبارہ کوشش کریں۔ دہرائی گئی درخواست `already_issued: true` اور کلید کا alias لوٹاتی ہے؛ اصل کلید صرف پہلے کامیاب جواب میں ہوتی ہے۔ دستاویزات کہتی ہیں: “Never generate a replacement id until the original result is known.” (ترجمہ: جب تک اصل نتیجہ معلوم نہ ہو، کبھی متبادل id نہ بنائیں۔)

BroadNet `/v1/chat/completions` یا transcriptions کے لیے کوئی idempotency key درج نہیں کرتا۔ وہاں کس پر دوبارہ کوشش کرنی ہے، اس کے لیے [ایرر کوڈز اور دوبارہ کوشش](https://broadrouter.com/ur/guides/errors-and-retries/) دیکھیں، اور یہ سمجھنے کے لیے کہ اندھا دھند دوبارہ کوششیں 429 کو مزید کیوں بگاڑ سکتی ہیں، [ریٹ لمٹ](https://broadrouter.com/ur/glossary/rate-limit/) دیکھیں۔

## عام سوالات

### نئی idempotency key کب بنانی چاہیے؟

صرف کسی نئے مطلوبہ کام کے لیے۔ ایک کام کی ہر دوبارہ کوشش میں وہی کلید استعمال کریں، اور جب تک پہلی کوشش کا نتیجہ معلوم نہ ہو، نئی کلید نہ بنائیں۔

### کیا LLM chat completion درخواستوں کو idempotency key چاہیے؟

ٹیکسٹ جنریٹ کرنے کا کوئی دیرپا side effect نہیں ہوتا، اس لیے دہرائی گئی چیٹ درخواست عموماً بس دوبارہ ٹوکنز کا خرچ کرتی ہے۔ کلید ان کالز کے لیے اہم ہے جو پیسے کاٹتی ہیں یا ریسورس بناتی ہیں۔ BroadNet اسے صرف گھنٹے والی کلید کی خریداری کے لیے درج کرتا ہے، chat completions کے لیے نہیں۔

### اگر میں وہی کلید کسی مختلف request body کے ساتھ دوبارہ بھیجوں تو کیا ہو گا؟

IETF ڈرافٹ کہتا ہے کہ سرور کو اسے 422 Unprocessable Content کے ساتھ رد کر دینا چاہیے، کیونکہ وہ کلید پہلے سے کسی اور درخواست سے جڑی ہے۔

## یہ بھی دیکھیں

-   [ایکسپونینشل بیک آف (exponential backoff)](https://broadrouter.com/ur/glossary/exponential-backoff/) (اصطلاح)
-   [ریٹ لمٹ (rate limit)](https://broadrouter.com/ur/glossary/rate-limit/) (اصطلاح)
-   [API کلید (API key)](https://broadrouter.com/ur/glossary/api-key/) (اصطلاح)
-   [کنکرنسی (concurrency)](https://broadrouter.com/ur/glossary/concurrency/) (اصطلاح)
-   [BroadNet Inference کے ایرر کوڈز اور دوبارہ کوشش کب کریں](https://broadrouter.com/ur/guides/errors-and-retries/) (گائیڈ)
-   [IP allow-list سے API کلید کو اپنے سرورز تک محدود کریں](https://broadrouter.com/ur/guides/api-keys-ip-allow-lists/) (گائیڈ)
-   [لمبے چلنے والے ایجنٹس: پائیدار timeouts، retries اور checkpoints](https://broadrouter.com/ur/blog/long-running-agents-timeouts-retries/) (مضمون)
-   [گھنٹے والی LLM API کلید: فی گھنٹہ مقررہ قیمت کی وضاحت](https://broadrouter.com/ur/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=ur-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 ریفرنس، گھنٹے والی کلیدیں (request\_id idempotency) (انگریزی میں)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=ur-glossary-idempotency-key&utm_content=sources#hourly-keys)
