معرّف المستخدم

أرفق مرجع مستخدمك بالطلب لتشير الأحداث الخطرة في لوحة التحكم إلى شخص حقيقي في نظامك.

المعامل userID#

مرّر userID مع أي دالة. يمكن أن يكون اسم مستخدم أو بريداً إلكترونياً أو رقم جوال أو معرّفاً داخلياً لديك.

curl "https://gurdx.cretip.com/api/lookup/ip?key=YOUR_API_KEY&ip=1.1.1.1&userID=john@example.com"

curl "https://gurdx.cretip.com/api/scoring/email?key=YOUR_API_KEY&email=john@example.com&userID=u_48213"

الصيغة بأحرف صغيرة userid مقبولة أيضاً.

فيمَ يُستخدم#

عندما يولّد الطلب حدثاً (كعنوان IP مشبوه أو بريد مزعج) يُحفظ المعرّف مع الحدث. وفي صفحة الأحداث بلوحة التحكم تستطيع البحث به، كما تحمله حمولة webhooks لتقوم أنظمتك بقفل الحساب أو طلب تحقق إضافي أو فتح مراجعة.

القواعد#

• يجب أن تكون القيمة نصاً أو رقماً مفرداً وبطول لا يزيد عن 255 حرفاً. القيم الأطول أو غير المفردة تعيد الخطأ 123 invalid_userid.
• المعامل اختياري. احذفه إن لم يكن لديك ما يفيد.
• يُخزَّن كنص، فلا تضع فيه أسراراً مثل كلمات المرور أو أرقام البطاقات الكاملة.
• طلبات وضع الاختبار لا تولّد أحداثاً، فلا أثر ظاهراً للمعرّف فيها.

طلبات الدفع#

في كشف احتيال الدفع لا تحتاج إلى userID، فالعميل يُحدَّد من البيانات التي ترسلها أصلاً كبريد العميل أو جواله أو معرّفه.

اختيار معرّف جيد#

استخدام المعرّف نفسه في كل مكان يتيح للوحة التحكم تجميع أحداث المستخدم الواحد عبر فحوص IP والبريد والجوال.

حذف بيانات المستخدم#

إذا طلب شخص محو بياناته فاستخدم حذف بيانات مستخدم الذي يزيل السجلات المرتبطة ببريد أو جوال أو معرّف مستخدم.

Tip: اعتمد بصمة (مثل SHA-256 للبريد) بدل البيانات الشخصية الصريحة متى أمكن. تحتفظ بقدرتك على المطابقة دون تخزين بيانات شخصية مقروءة لدى Gurdx.