API انوائس ہفتہ: آئیڈیمپوٹنسی کے خلا جو ڈپلیکیٹ ڈیبٹ کا سبب بنتے ہیں

انوائس ہفتے کے تصفیے کے طریقہ کار

زیادہ والیوم والے انوائس ہفتے کے دوران، تیز رفتاری باریک آئیڈیمپوٹنسی کے خلا کو بے نقاب کر سکتی ہے۔ جب بلنگ انجن بڑی تعداد میں SMS اور وائس کا استعمال پروسیس کرتے ہیں، تو غائب یا کمزور کیز کی وجہ سے ڈپلیکیٹ ڈیبٹ ہو سکتا ہے۔ دقیق لیجر کی سالمیت کو برقرار رکھنے کے لیے گاہک کے بیلنس پر کوئی بھی چارج پوسٹ کرنے سے پہلے سخت کیئز کی توثیق ضروری ہے۔ پیسے کے محفوظ آپریشنز کے بنیادی نمونوں کے لیے «آئیڈیمپوٹنسی، دوبارہ کوشش اور پیسہ» کا جائزہ لیں۔

ریٹرائی طوفان اور نیٹ ورک ٹائم آؤٹس

نیٹ ورک کی خرابیاں اکثر API کلائنٹس کو بلنگ کی بندش کے لیے POST درخواستیں دوبارہ بھیجنے پر مجبور کرتی ہیں۔ اگر آپ کے بیک اینڈ میں درخواستوں کی دوہری سے بچاؤ کی کمی ہے، تو ایک ڈراپ شدہ TCP ACK کے نتیجے میں دوہری پروسیسنگ ہوتی ہے۔ پری پیڈ بیلنس کا استعمال کرنے والا ہر پلیٹ فارم مائیکرو سپائیکس کے دوران منفی ایکویٹی کو روکنے کے لیے USD 20 پری پیڈ فلور کو نافذ کرتا ہے۔ جب ٹرانزیکشن کا حجم ماہانہ USD 1,000 کے قریب سافٹ ریویو تک پہنچتا ہے، تو ہمارے خودکار رسک کنٹرولز اس بات کی تصدیق کرتے ہیں کہ ریٹرائی لوپس کبھی بھی بنیادی لیجر کی حالت کو تبدیل نہیں کرتے۔

کلید کا دائرہ کار اور درخواست کی لائف سائیکل

ایک آئیڈیمپوٹنسی کی کو ایک مخصوص کاروباری مقصد کی منفرد شناخت کرنی چاہیے، نہ کہ صرف کنیکشن کی کوشش کی۔ مخصوص انوائس ادوار تک کیز کو محدود کرنا ہفتہ وار تصفیوں اور ایڈ ہاک ٹاپ اپس کے درمیان مداخلت کو روکتا ہے۔ ڈویلپرز کو کلائنٹ سائیڈ UUIDv4 ٹوکن بنانا ہوں گے اور انہیں ہیڈر فیلڈز کے ساتھ منسلک کرنا ہوگا۔ بھاری لوڈ پروفائلز کے تحت کارکردگی کی جانچ کے لیے «API والیوم جائزہ: لوڈ پر ایڈیمپوٹینسی» میں بینچمارکس سے مشورہ کریں۔

ہم وقت لیجر تحریروں کو سنبھالنا

ریس کی شرائط اس وقت ہوتی ہیں جب متعدد ورکرز ایک ہی DLR یا JIT نمبر کی تخصیص کے لیے رقم منہا کرنے کی کوشش کرتے ہیں۔ ڈسٹریبیوٹڈ ڈیٹا بیس لاکس کا استعمال چوٹی کے ٹریفک کے اوقات میں ڈبل سپینڈ کو روکتا ہے۔ نمبرز فوری طور پر JIT پروویژننگ کے ذریعے فراہم کیے جاتے ہیں، اس بات کو یقینی بناتے ہوئے کہ دستیاب کریڈٹ اور فعال اثاثوں کے درمیان کوئی فرق نہ ہو۔

ہم وقت درخواستوں کو سنبھالنے کے لیے لیجر میں اٹامک ٹرانزیکشنز کا استعمال کیا جاتا ہے۔ اس کا مطلب ہے کہ تمام متعلقہ آپریشنز یا تو مکمل طور پر کامیاب ہوں گے یا مکمل طور پر منسوخ ہو جائیں گے۔ اس سے بیلنس کی درستگی ہمیشہ برقرار رہتی ہے۔.

سینڈ باکس ماحول میں خلا کی جانچ

خرابی کی ہینڈلنگ کی تصدیق کے لیے غیر پروڈکشن سیٹنگ میں نیٹ ورک پارٹیشنز اور تاخیر کا شکار Webhook کا تخمینہ لگانا ضروری ہے۔ ٹرائل سیٹ اپ سے لائیو آپریشنز میں محفوظ طریقے سے منتقل ہونے کے لیے کریڈنشیلز کی دیکھ بھال کی ضرورت ہوتی ہے، جیسا کہ «سینڈ باکس سے پروڈکشن منتقل» میں تفصيل سے بتایا گیا ہے۔ ہمیشہ HTTP 409 تنازعہ کے جوابات کی جانچ کریں تاکہ تصدیق ہو سکے کہ آپ کا کلائنٹ ڈپلیکیٹ سبمیشن کے انکار کو قبول کرتا ہے۔

IOSOR API آرکیٹیکچر کے ساتھ شروعات کریں

گزشتہ ہفتے کا انوائس prepaid ledger کے ساتھ کھولیں۔ ہر ڈیبٹ قطار پر وہ Idempotency-Key تلاش کریں جس نے اسے ڈھالا۔ بے کنجی قطار — یا ایک ہی کنجی دو رقوم پر — تصفیے کا خلا ہے۔ فرق کو نئی مانگ سمجھ کر ادا کرنے سے پہلے ان قطاریں اصل ارادے سے ملائیں۔

IOSOR خلاصہ

کریں: انوائس ہفتہ کو کنجی-قطار جوڑ کے طور پر بند کریں۔ وہی ارادہ دوبارہ چھاپنے والا ریٹرائی طوفان ایک ڈیبٹ ہے، نئی انوائس قطار نہیں۔

نہ کریں: مالیات نے ارسال کنسول سے زیادہ قطاریں دیکھیں اس لیے خلا کو تازہ حجم مان کر ادا نہ کریں۔ بے کنجی زائد قطاریں دوہرا تصفیہ ہیں، نمو نہیں۔