اے پی آئی پائلٹ ہفتہ: لائیو ٹریفک پر کیز اور ویب ہুকس

اے پی آئی پائلٹ ہفتہ: لائیو ٹریفک پر کیز اور ویب ہুকس.

پروডাকশন ٹریفک پر API کیز کو پروموٹ کرنا

سٹیجنگ ٹیسٹس سے لائیو ٹریفک کی طرف منتقلی کے لیے آپریشنل ٹوکنز کو الگ تھلگ کرنے کی ضرورت ہوتی ہے۔ اپنے API پائلٹ ہفتے کے دوران، عارضی ٹیسٹنگ ٹوکنز کو محدود پروডাকشن کیز سے بدل دیں۔ پروডাকشن کیز میں واضح گنجائش ہونی چاہیے، جو عالمی انتظامی حقوق کے بغیر صرف آؤٹ باؤنڈ SMS ڈسپیچ یا ان باؤنڈ ویب ہک ان گیسشن کی اجازت دیں۔ یقینی بنائیں کہ لائیو API اسناد محفوظ والٹ اسٹورز میں موجود ہوں۔

اصلی اسٹریمز پر دستخط شدہ ویب ہুকਸ کی توثیق کرنا

رئیل ٹائم ڈیلیوری رپورٹس (DLR) اور ان باؤنڈ پیغامات وصول کرنے کے لیے کریپٹوگرافک تصدیق کی ضرورت ہوتی ہے۔ آپ کے کال بیک یو آر ایل پر بھیجے گئے ہر پے لوڈ میں آپ کی خفیہ کلید کے ساتھ حساب لگایا گیا ہیش دستخط شامل ہوتا ہے۔ کسی بھی ڈیلیوری اپ ڈیٹ کو قبول کرنے سے پہلے، جعلی ایونٹس کو مسدود کرنے کے لیے HTTP ہیڈر کے دستخط کی تصدیق کریں۔ ہمیشہ ٹائم اسٹیمپ رواداری کو [signature replay] کے خلاف چیک کریں۔

آئیڈیمپوٹنسی کیز اور بیلنس کٹوتیاں

پائلٹ ہفتے کے دوران نیٹ ورک کی خرابیاں آپ کی ایپلیکیشن سے ڈپلیکیٹ HTTP POST درخواستوں کا سبب بن سکتی ہیں۔ ہر ڈسپیچ کال کے ساتھ ایک منفرد Idempotency-Key ہیڈر فراہم کرنا اس بات کو یقینی بناتا ہے کہ ڈپلیکیٹ کوششیں کبھی بھی ڈبل بلنگ یا ڈپلیکیٹ SMS ترسیل کا سبب نہ بنیں۔ یہ سمجھنے کے لیے ہماری گائیڈ «آئیڈیمپوٹنسی، دوبارہ کوشش اور پیسہ» پر /learn/developers/api-idempotency-retries-and-money دیکھیں کہ آئیڈیمپوٹنسی آپ کے اکاؤنٹ کو کیسے محفوظ رکھتی ہے۔

ڈیلیوری رپورٹس اور ویب ہুক کی خرابیوں کو سنبھالنا

لائیو کیریئر نیٹ ورکس غیر متناسب DLR تاخیر پیدا کرتے ہیں۔ آپ کی ایپلیکیشن کو اندرونی ایونٹ کیو کا استعمال کرتے ہوئے غیر مطابقت پذیر طریقے سے ویب ہکس پروسیس کرنے چاہئیں۔ اگر آپ کا رسیور اینڈ پوائنٹ کنکشن منقطع کرتا ہے یا 5xx کی خرابی واپس کرتا ہے، تو پلیٹ فارم ایکسپوننشیل بیک آف کے ساتھ خودکار دوبارہ کوششیں شروع کرتا ہے۔ میسج UUID کا استعمال کرتے ہوئے آنے والے DLR پے لوڈز پر سخت آئیڈیمپوٹنسی برقرار رکھیں۔

اکاؤنٹ کی حدیں اور ٹریفک اسکیلنگ

پائلٹ ہفتہ قابل پیشگوئی مالیاتی حدود کے تحت حقیقی ٹریفک کی حرکیات متعارف کراتا ہے۔ اکاؤنٹ کی فعال کاری 20 USD پری پیڈ فلور سے شروع ہوتی ہے، اس بات کو یقینی بناتی ہے کہ بیلنس ریزرو کی حدود سے نیچے نہ جائے۔ جیسے جیسے پیغام کا حجم بڑھتا ہے اور آپ کا انٹیگریشن 1,000 USD فی مہینہ کے قریب پہنچتا ہے، API کنیکٹیویٹی کو توڑے بغیر آپریشنل حدود کو متحرک طور پر ایڈجسٹ کیا جاتا ہے۔

IOSOR کے ساتھ شروع کریں

production دائرے کی کنجی جاری کریں — sandbox ٹوکن نہیں — اور کال بیک اس دستخط شدہ webhook URL پر رکھیں جس کے آپ مالک ہیں۔ Idempotency-Key کے ساتھ ایک OTP یا الرٹ بھیجیں۔ تصدیق کریں کہ prepaid hold، ڈیبٹ اور DLR اسی ارادے پر بیٹھے۔ مخصوص کنجی اور تصدیق شدہ دستخط کے بغیر Live بیج ابھی setup ہے۔

آئیڈیمپوٹنسی، دوبارہ کوشش اور پیسہ API حادثہ ہفتہ: غائب آئیڈیمپوٹنسی ایک فریز ہے، ریٹرائی طوفان نہیں پہلی کٹوتی سے پہلے پری پیڈ رقم محفوظ کرنا.

IOSOR خلاصہ

کریں: پہلا زندہ ہفتہ production کنجی، دستخط شدہ webhook، اور ledger میں دکھائی دینے والے ایک prepaid hold پر چلائیں۔

نہ کریں: sandbox ٹوکن زندہ ٹریفک پر بانٹنا، یا بغیر دستخط کال بیک کو پائلٹ کے لیے کافی سمجھنا۔