نظرة عامة

مرحباً بك في وثائق Webhook API الموحدة. يوفر هذا النظام بنية قوية لاستقبال التحويلات من شبكات الـ CPA المختلفة وتوفيرها لمواقعك الأخرى عبر واجهة برمجية منظمة وسريعة.

المصادقة (Authentication)

نعتمد في نظامنا على مفاتيح الأمان لضمان أن الطلبات المصرح لها فقط هي من تصل لقاعدة البيانات.

أنواع المفاتيح:

  • Webhook Key: مفتاح ثابت يتم تعريفه في ملف الإعدادات داخل السيرفر لاستلام الـ Postbacks.
  • API Lead Key: مفاتيح متغيرة يتم توليدها لكل موقع خارجي من لوحة التحكم.
مثال على استخدام المفتاح في الرابط
?key=your_secure_key

Postback v1 (Adbluemedia)

نقطة استلام التحويلات للشبكات التي تدعم الروابط المخصصة مع دعم كامل لـ Sub IDs.

GET https://webhook-api.online/postback.php GET

المعلمات (Parameters):

الاسمالنوعالوصف
keystringمفتاح الأمان السري المشترك.
offer_idintمعرف العرض الفريد.
payoutfloatقيمة العمولة (بالدولار).
s1, s2string(اختياري) معرفات التتبع الفرعية.
الرابط المستخدم في لوحة Adbluemedia
https://webhook-api.online/postback.php?key=my_secret_123&offer_id={offer_id}&payout={payout}&status={status}&s1={s1}&s2={s2}

Leads Data API

جلب إحصائيات وبيانات التحويلات الخاصة بـ اليوم الحالي (بدأ من الساعة 00:00 صباحاً) بصيغة JSON، مع دعم كامل للفلترة ونظام كاش متقدم.

GET https://webhook-api.online/api.php?key=YOUR_API_KEY GET

المعلمات (Parameters):

الاسمالنوعالوصف
keystringمفتاح الـ API المولد من لوحة المفاتيح.
(إلزامي)
s1string(اختياري) فلترة النتائج حسب مصدر التتبع الأول (مثال: insta).
s2string(اختياري) فلترة النتائج حسب مصدر التتبع الثاني (مثال: snap).

حالات الاستجابة (HTTP Status Codes):

الكودالحالةالوصف
200OKتم جلب البيانات بنجاح (سواء من الكاش أو القاعدة).
403Forbiddenالمفتاح مفقود أو غير صحيح أو محذوف.
405Method Not Allowedالطلب ليس من نوع GET.
500Errorخطأ داخلي في الخادم أو فشل الاتصال بالقاعدة.

أمثلة الاستجابة (JSON Cases):

1. استجابة نجاح (Success)
{
  "success": true,
  "generated": "2026-03-30 17:07:26",
  "period": "last_24_hours",
  "summary": {
    "total_leads": 120,
    "accepted": 120,
    "rejected": 0,
    "total_payout": 53.27
  },
  "leads": [
    {
      "id": 414,
      "offer_id": 68455,
      "offer_name": "Higo-Chat & Meet Friends",
      "payout": 0.06,
      "ip": "188.71.214.194",
      "status": "accepted",
      "s1": "ContentLocker",
      "country_code": "??",
      "created_at": "2026-03-30 16:44:57"
    },
    {
      "id": 413,
      "offer_id": 15317,
      "offer_name": "ClickBox - Treasure Box",
      "payout": 0.15,
      "ip": "182.3.43.230",
      "status": "accepted",
      "country_code": "ID"
    },
    "..." 
  ]
}
                
2. خطأ في المفتاح (Invalid Key)
{
  "success": false,
  "error": "Forbidden: Invalid API Key"
}
                
3. محاولة طلب POST (Invalid Method)
{
  "success": false,
  "error": "Method Not Allowed"
}
                
JavaScript Example
fetch('https://.../api.php?key=YOUR_KEY')
  .then(res => res.json())
  .then(data => {
    if (data.success) {
      console.log('Success!', data.leads);
    } else {
      console.error('Error:', data.error);
    }
  });