BroadRouter
شروع کریں

Idempotency key (آئیڈیمپوٹینسی کلید)

اپ ڈیٹ

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 کے ساتھ دوبارہ کوشش عام طریقہ ہے، اور کئی SDKs خود بخود دوبارہ کوشش کرتے ہیں۔ idempotency کے بغیر، timeout کے بعد کی دوبارہ کوشش دو آرڈر یا دو چارج بنا سکتی ہے۔ کلید کے ساتھ، پہلی کوشش نے جو بھی کیا ہو، دوبارہ کوشش محفوظ ہے۔ اسی لیے یہ ان agents اور اسکرپٹس کے لیے ایک بنیادی آلہ ہے جو کسی انسان کی نگرانی کے بغیر کچھ خریدتے، بُک کرتے یا بناتے ہیں۔

BroadNet Inference پر

BroadNet یہ پیٹرن گھنٹے والی کلیدیں خریدنے کے لیے استعمال کرتا ہے۔ POST /portal/keys/hourly JSON body میں ایک request_id لیتا ہے، اور دستاویزات کہتی ہیں کہ “Idempotency is required for money safety” (ترجمہ: پیسوں کے تحفظ کے لیے idempotency ضروری ہے):

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 درج نہیں کرتا۔ وہاں کس پر دوبارہ کوشش کرنی ہے، اس کے لیے ایرر کوڈز اور دوبارہ کوشش دیکھیں، اور یہ سمجھنے کے لیے کہ اندھا دھند دوبارہ کوششیں 429 کو مزید کیوں بگاڑ سکتی ہیں، ریٹ لمٹ دیکھیں۔

عام سوالات

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

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

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

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

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

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

Markdown میں پڑھیںChatGPT سے پوچھیںClaude سے پوچھیںPerplexity سے پوچھیں