التوثيق / المنصة
الأحداث والتنبيهات
الحدث هو السجل الذي ينشئه Gurdx كلما أنتج طلب API نتيجة خطِرة، وهو أساس المراقبة في لوحة التحكم والـ Webhooks وتنبيهات الدردشة.
متى يُنشأ الحدث#
تُنشأ الأحداث بعد إرسال استجابة الـ API، فلا تُبطئ طلباتك، ولا تُنشأ في الوضع التجريبي. افتراضيًا يُنشأ الحدث عند بلوغ هذه العتبات:
| المصدر | العتبة |
|---|---|
| فحوص IP | خطورة 50 من 100 |
| احتيال الدفع | درجة 50 من 100 |
| تقييم البريد | درجة 2 من 3 |
| الألفاظ المسيئة | خطورة 0.5 من 1 |
كما تُنشئ أحداثًا تطابقات القوائم السوداء ونتائج الآيبان وBIN والجوال غير الصالحة. تُخزَّن درجة كل حدث مُطبَّعة على مقياس من 0 إلى 100.
أنواع الأحداث#
| Event | الوصف |
|---|---|
suspicious_ip | عنوان IP مشبوه |
fraud_payment | محاولة دفع احتيالية |
spam_email | بريد مزعج أو وهمي |
spam_phone | رقم جوال وهمي |
profanity | محتوى مسيء |
invalid_iban | آيبان غير صالح |
invalid_bin | بطاقة غير صالحة |
تُسلّم الـ Webhooks نوع VPN والبروكسي بالاسم العام: proxy_detected. انظر الـ Webhooks.
ما يحتويه الحدث#
- نوع الحدث ودرجة الخطورة (من 0 إلى 100).
- الموضوع: عنوان IP أو البريد أو الجوال أو BIN أو الآيبان أو النص الذي فُحص.
- عنوان IP والدولة إن عُرفا.
- معرّف المستخدم الذي مرّرته عبر المعامل
userID. - تفاصيل النتيجة وهل حُظر الطلب.
- الوقت بتوقيت حسابك.
معرّف المستخدم#
أضف userID إلى أي طلب لوسمه بمعرّفك الخاص مثل رقم المستخدم أو بريده. يتيح لك ذلك البحث في صفحة الأحداث عن كل ما يخص عميلًا بعينه، ويظهر في حمولات الـ Webhooks والدردشة باسم user_identifier.
curl "https://gurdx.cretip.com/api/lookup/ip/threats?ip=203.0.113.42&userID=user_1042" \
-H "Authorization: Bearer $GURDX_KEY"
Note: يفضَّل استخدام معرّف مبهم بدل البيانات الشخصية الخام. ويمكنك محو بيانات شخص عبر نقطة حذف المستخدم.
التصفية والتصدير#
في صفحة الأحداث داخل https://gurdx.cretip.com/app يمكنك التصفية بنوع الحدث ونطاق الخطورة ونطاق التاريخ ومعرّف المستخدم، وفتح أي حدث لرؤية تفاصيله الكاملة. استخدم خيار التصدير لتنزيل القائمة المصفّاة للمراجعة أو لتحميلها في أدواتك. يحتاج أعضاء الفريق إلى صلاحية «الأحداث والتنبيهات».
التنبيهات#
تنتشر الأحداث تلقائيًا:
- كل Webhook مفعّل مشترك في النوع يتلقى تسليمًا موقّعًا. انظر الـ Webhooks.
- كل تكامل مفعّل (Slack أو Telegram أو Discord) مشترك في النوع ويحقق حدّه الأدنى للخطورة يتلقى رسالة قصيرة. انظر التكاملات.
الاحتفاظ بالبيانات#
تُحفظ سجلات طلبات الـ API الخام 90 يومًا افتراضيًا ثم تُحذف. أما عدّادات الاستخدام اليومية فتُحفظ دائمًا. استخدم التصدير أو الـ Webhooks لأرشفة الأحداث التي تحتاجها مدة أطول.
Tip: ابدأ بحدّ أدنى منخفض للخطورة على قناة هادئة، وراقب أسبوعًا، ثم ارفعه حتى يصبح حجم التنبيهات مما سيقرأه فريقك فعلًا.
وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا