نظرة عامة
مرحباً بك في وثائق 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):
| الاسم | النوع | الوصف |
|---|---|---|
| key | string | مفتاح الأمان السري المشترك. |
| offer_id | int | معرف العرض الفريد. |
| payout | float | قيمة العمولة (بالدولار). |
| s1, s2 | string | (اختياري) معرفات التتبع الفرعية. |
الرابط المستخدم في لوحة 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):
| الاسم | النوع | الوصف |
|---|---|---|
| key | string | مفتاح الـ API المولد من لوحة المفاتيح. (إلزامي) |
| s1 | string | (اختياري) فلترة النتائج حسب مصدر التتبع الأول (مثال: insta). |
| s2 | string | (اختياري) فلترة النتائج حسب مصدر التتبع الثاني (مثال: snap). |
حالات الاستجابة (HTTP Status Codes):
| الكود | الحالة | الوصف |
|---|---|---|
| 200 | OK | تم جلب البيانات بنجاح (سواء من الكاش أو القاعدة). |
| 403 | Forbidden | المفتاح مفقود أو غير صحيح أو محذوف. |
| 405 | Method Not Allowed | الطلب ليس من نوع GET. |
| 500 | Error | خطأ داخلي في الخادم أو فشل الاتصال بالقاعدة. |
أمثلة الاستجابة (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); } });