الموارد / Webhooks

إشعارات الأحداث في الوقت الفعلي

احصل على إشعارات فورية عند حدوث أحداث في حساب Laabam الخاص بك

الوقت الفعلي

احصل على إشعارات فورية عند حدوث الأحداث

موثوق

إعادة المحاولة التلقائية مع التراجع الأسي

مراقب

تتبع حالة التسليم وتصحيح المشاكل

الأحداث المتاحة

invoice.created

يتم تشغيله عند إنشاء فاتورة جديدة

مثال على البيانات:

{
  "invoice_id": "inv_123",
  "status": "draft",
  "amount": 50000
}
invoice.paid

يتم تشغيله عند تلقي دفعة فاتورة

مثال على البيانات:

{
  "invoice_id": "inv_123",
  "payment_id": "pay_456",
  "amount": 50000
}
customer.created

يتم تشغيله عند إضافة عميل جديد

مثال على البيانات:

{
  "customer_id": "cust_789",
  "name": "John Doe",
  "email": "john@example.com"
}
payment.failed

يتم تشغيله عند فشل محاولة الدفع

مثال على البيانات:

{
  "payment_id": "pay_456",
  "reason": "insufficient_funds"
}

مثال على التنفيذ

إليك كيفية التعامل مع webhooks في تطبيقك:

// Webhook endpoint example (Node.js/Express)
const express = require('express');
const app = express();

app.post('/webhooks/laabam', express.json(), (req, res) => {
  const event = req.body;
  
  // Verify webhook signature
  const signature = req.headers['x-laabam-signature'];
  if (!verifySignature(signature, req.body)) {
    return res.status(401).send('Invalid signature');
  }
  
  // Handle different event types
  switch (event.type) {
    case 'invoice.created':
      console.log('New invoice:', event.data.invoice_id);
      // Your business logic here
      break;
      
    case 'invoice.paid':
      console.log('Payment received:', event.data.payment_id);
      // Update your database, send email, etc.
      break;
  }
  
  res.status(200).send('Webhook received');
});

Webhooks الخاصة بك

https://api.yoursite.com/webhooks/laabam
نشط
invoice.createdinvoice.paid

آخر تسليم

قبل دقيقتين

معدل النجاح

99.8%

https://staging.yoursite.com/webhooks
نشط
customer.createdpayment.failed

آخر تسليم

قبل 15 دقيقة

معدل النجاح

100%

أفضل ممارسات Webhook

  • تحقق دائماً من توقيعات webhook لضمان الأصالة
  • قم بإرجاع رمز الحالة 200 بسرعة للإقرار بالاستلام
  • معالج بيانات webhook بشكل غير متزامن في طابور
  • استخدم نقاط نهاية HTTPS لضمان أمان البيانات
  • طبق التماثل للتعامل مع الأحداث المكررة

ابدأ باستخدام Webhooks

بناء تكاملات الوقت الفعلي مع Laabam webhooks