القواعد المخصّصة

تتيح لك القواعد المخصّصة تعديل نتائج Gurdx بمنطق عملك، مثل حظر دولة أو استبدال درجة، دون تغيير كود التكامل لديك.

ما هي القاعدة#

تتبع القاعدة مجموعة نقاط نهاية واحدة، ولها عنوان وقائمة شروط ونمط مطابقة وإجراء واحد. عند معالجة الطلب يبني Gurdx الاستجابة ثم يقيّم كل القواعد المفعّلة في المجموعة بالترتيب الظاهر في لوحة التحكم. كل قاعدة تتحقق شروطها تنفّذ إجراءها على الاستجابة. ولأن القواعد تعمل بالترتيب، فإن overwrite_score اللاحق يتغلب على السابق.

نمط المطابقة#

مطابقة الكل: يجب أن تتحقق كل الشروط.
مطابقة أي شرط: يكفي تحقق شرط واحد على الأقل.

القاعدة التي لا شروط فيها لا تتطابق أبدًا.

الشروط والمعاملات#

الشرط يتكوّن من حقل ومعامل وقيمة. الحقول إما مدخلات الطلب (input.*) أو قيم من الاستجابة (result.*). تعرض لوحة التحكم المعاملات المناسبة لنوع الحقل فقط.

المعامل	المعنى	أنواع الحقول
`equals`, `not_equals`	مقارنة غير حساسة لحالة الأحرف	نص، رقم، دولة
`in`, `not_in`	ضمن قائمة مفصولة بفواصل	نص، رقم، دولة
`contains`, `starts_with`, `ends_with`	مطابقة النص	نص
`gt`, `gte`, `lt`, `lte`	مقارنة رقمية	رقم
`is_true`, `is_false`	فحص منطقي	منطقي
`in_cidr`	IP ضمن نطاق CIDR أو أكثر	IP

المجموعات والحقول والإجراءات#

المجموعة	نقاط النهاية	الإجراءات	ما يغيّره الإجراء
`ip`	الموقع الجغرافي، فحص IP، الفحص بالجملة	`blacklist`, `whitelist`	`security.blacklisted`
`ip_reputation`	سمعة IP	`blacklist`, `whitelist`	`threats.blacklisted`
`payment`	الدفع	`overwrite_score`	`score`
`email`	البريد	`overwrite_score`, `mark_valid`, `mark_invalid`	`score`، `isValid`
`phone`	الجوال	`mark_valid`, `mark_invalid`	`isValid`
`bin`	فحص BIN	`mark_valid`, `mark_invalid`	`isValid`
`iban`	فحص الآيبان	`mark_valid`, `mark_invalid`	`isValid`

الحقول المتاحة للشروط حسب المجموعة:

ip: result.ip وresult.countryCode وresult.continentCode وresult.regionName وresult.cityName وresult.asn.asn وresult.asn.name وresult.security.isProxy وproxyType وisTor وisBot وisHosting وisRelay.
ip_reputation: result.ip وresult.countryCode وresult.threats.isProxy وproxyType وisTor وisBot وisHosting وisRelay.
payment: input.data.action وtransaction_amount وtransaction_currency وcustomer_id وcustomer_email وcustomer_phone وcustomer_ip وcustomer_country وbilling_country وshipping_country وpayment_type وisDigitalProducts وwebsite_domain، إضافة إلى result.score وresult.rulesDetected.
email: input.email وresult.domain.name وresult.score (من 0 إلى 3) وisDisposable وisFree وisRoleBased وisEducational.
phone: input.phone وinput.countryCode وresult.carrier وresult.isValid.
bin: input.bin وresult.info.scheme وtype وisPrepaid وisCommercial وcountry.alpha2 وbank.name.
iban: input.iban وresult.countryCode وresult.isValid.

كشف الألفاظ المسيئة وفحوص ASN والدولة والنطاق لا تدعم القواعد المخصّصة.

مثال#

رفع درجة الطلبات الرقمية الكبيرة من دولة لا تخدمها:

المجموعة: payment، المطابقة: الكل
input.data.isDigitalProducts صحيح
input.data.transaction_amount أكبر من 200
input.data.billing_country ليس من SA, AE, KW
الإجراء: overwrite_score بقيمة 90

في استجابة الـ API#

كل استجابة من نقطة نهاية تدعم القواعد تحتوي على custom_rules_applied حتى لو لم تتطابق أي قاعدة:

{
  "status": "success",
  "data": {
    "score": 90,
    "custom_rules_applied": {
      "total": 1,
      "rules": [ { "id": "CR12", "message": "Large digital order from unserved country" } ]
    }
  }
}

قيمة id هي رمز القاعدة الظاهر في لوحة التحكم (CR ورقم القاعدة)، وmessage هو عنوان القاعدة. وفي سمعة IP يقع الكائن داخل data.threats.

Tip: استخدم زر «اختبار القاعدة» في لوحة التحكم لتجربة القاعدة على بيانات نموذجية قبل تفعيلها.

Warning: قاعدة overwrite_score أو mark_valid تستبدل ما حسبه Gurdx. اجعل شروطها ضيقة كي لا تُخفي إشارات حقيقية.

انظر أيضًا القوائم السوداء والأحداث والتنبيهات.

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