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