ویب ہُک ایک HTTP درخواست ہے جو ایک سروس آپ کے رجسٹر کردہ URL پر بھیجتی ہے جب بھی کوئی مخصوص واقعہ پیش آتا ہے۔ یہ آپ کے نظام کو یہ اجازت دیتا ہے کہ وہ ڈیٹا کو اس وقت وصول کرے جب یہ واقعہ پیش آتا ہے، بجائے اس کے کہ آپ ایک API کو بار بار کال کرکے یہ دیکھیں کہ آیا کچھ نیا دستیاب ہے۔ ایک ڈیٹا پائپ لائن میں، اس کا مطلب یہ ہے کہ ایک کام واقعے کا جواب دے سکتا ہے جیسے ہی ماخذ اسے رپورٹ کرتا ہے۔

ادائیگی کی پلیٹ فارم Stripe، مثال کے طور پر، آپ کے اینڈپوائنٹ پر HTTPS کے ذریعے JSON پیلوڈ کے طور پر ویب ہُک کے واقعات بھیجتا ہے۔ آپ کا اینڈپوائنٹ POST درخواستیں قبول کرنا چاہیے اور موصول ہونے والے واقعے کے ڈیٹا کو پروسیس کرنا چاہیے۔

ویب ہُک کی ترسیل کیسے کام کرتی ہے

Stripe کی دستاویزات بنیادی میکانکس کو ظاہر کرتی ہیں:

  • رجسٹریشن: آپ ایک اینڈپوائنٹ URL رجسٹر کرتے ہیں۔ لائیو موڈ میں، Stripe کو ایک عوامی طور پر قابل رسائی HTTPS URL کی ضرورت ہوتی ہے۔
  • تیز تصدیق: اینڈپوائنٹ کو جلدی سے 2xx اسٹیٹس کوڈ واپس کرنا چاہیے، کسی بھی پیچیدہ منطق سے پہلے جو ٹائم آؤٹ کا باعث بن سکتی ہے۔
  • دوبارہ کوششیں: اگر ترسیل ناکام ہو جاتی ہے، تو Stripe لائیو موڈ میں تین دن تک ایکسپوننشل بیک آف کے ساتھ دوبارہ کوشش کرتا ہے۔
  • ترتیب: Stripe یہ ضمانت نہیں دیتا کہ واقعات اس ترتیب میں پہنچیں گے جس میں انہیں تخلیق کیا گیا تھا۔

ویب ہُک اینڈپوائنٹ کی سیکیورٹی

  • دستخط کی تصدیق کریں: Stripe ہر واقعے پر HMAC کے ساتھ SHA-256 کا استعمال کرتے ہوئے دستخط کرتا ہے اور دستخط کو Stripe-Signature ہیڈر میں رکھتا ہے۔
  • دوبارہ پلے کو بلاک کریں: دستخط شدہ پیلوڈ میں ایک ٹائم اسٹیمپ شامل ہوتا ہے، لہذا آپ بہت پرانے واقعات کو مسترد کر سکتے ہیں۔
  • نقل کو سنبھالیں: ایک اینڈپوائنٹ ایک ہی واقعے کو ایک سے زیادہ بار وصول کر سکتا ہے۔ پروسیس کردہ واقعے کی IDs کو لاگ کریں اور تکرار کو چھوڑ دیں۔
  • بھیجنے والوں کی اجازت کی فہرست: Stripe ایک شائع کردہ IP ایڈریس کی فہرست سے ویب ہُک بھیجتا ہے جسے آپ اپنے فائر وال کو محدود کر سکتے ہیں۔

عام ویب ہُک کے استعمال

  • کوڈ اور تعیناتی: GitHub آپ کے URL پر HTTP POST پیلوڈ بھیجتا ہے جن کے لیے آپ نے سبسکرائب کیا ہے۔ اس کی دستاویزات ایسے استعمال کی فہرست دیتی ہیں جیسے CI بلڈز شروع کرنا، ایک بیرونی مسئلہ ٹریکر کو اپ ڈیٹ کرنا، ایک بیک اپ آئینے کو تازہ کرنا اور پروڈکشن سرور پر تعینات کرنا۔
  • ادائیگیاں: Stripe کے ویب ہُک آپ کو غیر متوقع واقعات کا جواب دینے کی اجازت دیتے ہیں، جیسے کہ ایک بینک کی ادائیگی کی تصدیق کرنا، ایک صارف کی چارج پر تنازعہ کرنا یا ایک بار بار کی ادائیگی کامیاب ہونا۔
  • صرف وہی سبسکرائب کریں جس کی آپ کو ضرورت ہے: Stripe اضافی یا تمام واقعات کے لیے سننے کی تجویز نہیں دیتا کیونکہ یہ آپ کے سرور پر غیر ضروری دباؤ ڈال دیتا ہے۔

متعلقہ اصطلاحات