تخطَّ إلى المحتوى
Gurdx

التوثيق / المنصة

القوائم السوداء

القوائم السوداء هي قوائم بقيم لا تريد قبولها أبدًا، وتُفحص تلقائيًا في نقاط النهاية التي تتعامل مع هذا النوع من القيم.

كيف تعمل#

لكل قائمة نوع، ويمكن تفعيلها أو تعطيلها، وتحتوي على أي عدد من العناصر. أثناء الطلب يبحث Gurdx بمطابقة تامة ومفهرسة عن القيمة في عناصر قوائمك المفعّلة. إذا وُجدت تُوسم الاستجابة بأنها مدرجة (الحقل blacklisted في نتائج IP والبريد والجوال) وتُعامل النتيجة على أنها عالية الخطورة.

تُوحَّد القيم قبل تخزينها وقبل مقارنتها، فلا تقلق من اختلاف التنسيق:

النوع التوحيد
ip الصيغة القياسية لـ IPv4/IPv6
email بعد حذف الفراغات وبأحرف صغيرة
email_domain بعد حذف الفراغات وبأحرف صغيرة (مثل mailinator.com)
phone أرقام فقط وبدون أصفار بادئة
customer_id بعد حذف الفراغات وبأحرف صغيرة
card_bin أرقام فقط وأول 8 منها
card_country رمز من حرفين بأحرف كبيرة

الأنواع وأين تُطبَّق#

النوع ما تضيفه نقاط النهاية المتأثرة
ip عناوين IP الموقع الجغرافي، فحص IP، الفحص بالجملة، سمعة IP، الدفع
email عناوين بريد البريد، الدفع
email_domain نطاقات مثل example.org البريد، الدفع
phone أرقام جوال الجوال، الدفع
customer_id معرّفات عملائك الدفع
card_bin أرقام BIN (من 6 إلى 8 أرقام) فحص BIN، الدفع
card_country رموز دول الإصدار فحص BIN، الدفع

يُفحص البريد مرتين: كعنوان كامل ثم بحسب نطاقه، فإدراج نطاق يغطي كل العناوين عليه.

الأثر على الدرجة#

الإدراج في قائمة سوداء إشارة قوية، لكن Gurdx يُرجع النتيجة كاملة. في كشف احتيال الدفع يُحتسب كقاعدة مكتشفة ويرفع الدرجة. وفي فحوص البحث يُضبط الحقل blacklisted ويمكنك قراءته في كودك:

const res = await fetch('https://gurdx.cretip.com/api/scoring/email?email=' + encodeURIComponent(email), {
  headers: { Authorization: 'Bearer ' + process.env.GURDX_KEY },
});
const { data } = await res.json();
if (data.blacklisted) {
  // reject or send to manual review
}

كما تُنشئ التطابقات أحداثًا مقابلة تظهر في لوحة التحكم وتصل إلى الـ Webhooks وتنبيهات الدردشة.

إدارة القوائم#

  • أنشئ ما تحتاجه من القوائم، مثلًا قائمة لكل فريق أو حملة، وعطّل القائمة لإيقاف أثرها دون حذفها.
  • أضف العناصر واحدًا واحدًا أو بالجملة من لوحة التحكم.
  • يمكن لقاعدة مخصّصة بإجراء blacklist أن تُدرج القيم ديناميكيًا. انظر القواعد المخصّصة.
  • يحتاج أعضاء الفريق إلى صلاحية القوائم السوداء لتعديلها.

Tip: فضّل email_domain على عناوين كثيرة منفردة لمزوّدي البريد المؤقت، وفضّل card_bin على card_country حين تريد إيقاف جهة إصدار بعينها.

Warning: إدراج IP مشترك (شبكة شركة أو مشغّل جوال) قد يحجب عملاء أبرياء كثيرين. راجع قبل إضافة نطاقات واسعة.

صفحات مرجعية ذات صلة: سمعة IP وتقييم البريد وتقييم الجوال وفحص BIN واحتيال الدفع.

وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا