التوثيق / المنصة
القوائم السوداء
القوائم السوداء هي قوائم بقيم لا تريد قبولها أبدًا، وتُفحص تلقائيًا في نقاط النهاية التي تتعامل مع هذا النوع من القيم.
كيف تعمل#
لكل قائمة نوع، ويمكن تفعيلها أو تعطيلها، وتحتوي على أي عدد من العناصر. أثناء الطلب يبحث 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 واحتيال الدفع.
وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا