التوثيق / البدء
المقدمة
Gurdx واجهة برمجية لمنع الاحتيال وتحليل المستخدمين، تقيّم عناوين IP والبريد الإلكتروني وأرقام الجوال والبطاقات وأرقام الآيبان والمدفوعات بطلب واحد وبصيغة JSON.
ماذا تقدّم Gurdx#
تساعدك Gurdx على أن تقرّر لحظياً هل يستحق الزائر أو العملية الثقة. ترسل قيمة (عنوان IP، بريداً، رقم BIN، عملية دفع، نصاً) فتعيد لك بيانات منظّمة، ودرجة مخاطر يمكنك البناء عليها عندما يكون ذلك مناسباً.
تتشارك كل الدوال اصطلاح المسارات نفسه وغلاف الاستجابة نفسه ورموز الأخطاء المرقّمة، فيكفي عميل واحد لكل الواجهة. ابدأ من مرجع الواجهة.
عنوان الخادم الأساسي#
تُرسل جميع الطلبات إلى:
https://gurdx.cretip.com/api
كل النقاط متاحة عبر HTTPS فقط. راجع HTTPS.
أول طلب#
أنشئ مفتاحاً من لوحة التحكم (https://gurdx.cretip.com/app) ثم استدعِ نقطة الموقع الجغرافي:
curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY"
إذا لم تمرّر المعامل ip فستبحث Gurdx عن العنوان الذي صدر منه الطلب. الاستجابة الناجحة تبدو هكذا:
{
"data": {
"ip": "203.0.113.7",
"countryCode": "SA",
"countryName": "Saudi Arabia"
},
"status": "success",
"executionTime": 12
}
executionTime هو زمن المعالجة بالميلي ثانية.
النقاط المتاحة#
| الخدمة | المسار | الباقات |
|---|---|---|
| الموقع الجغرافي للزائر | GET /geoip |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| فحص عنوان IP | GET /lookup/ip |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| فحص عناوين IP بالجملة | GET /lookup/ip/bulk |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| سمعة عنوان IP | GET /lookup/ip/threats |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| فحص الشبكة ASN | GET /lookup/asn |
تجربة مجانية المميّزة الدفع حسب الاستخدام |
| فحص البطاقة BIN | GET /lookup/bin |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| التحقق من الآيبان | GET /lookup/iban |
تجربة مجانية المميّزة الدفع حسب الاستخدام |
| معلومات الدولة | GET /lookup/country |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| فحص النطاق | GET /lookup/domain |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| تقييم البريد الإلكتروني | GET /scoring/email |
تجربة مجانية المميّزة الدفع حسب الاستخدام |
| تقييم رقم الجوال | GET /scoring/phone |
تجربة مجانية المميّزة الدفع حسب الاستخدام |
| كشف الألفاظ المسيئة | GET /scoring/profanity |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| كشف احتيال الدفع | POST /scoring/payment |
تجربة مجانية المميّزة الدفع حسب الاستخدام |
| حذف بيانات مستخدم | DELETE /account/users/delete |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| الإبلاغ عن نتيجة الدفع | POST /feedback/payment |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| تصنيف هوية أو حدث | POST /feedback/event |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| الملاحظات بالجملة | POST /feedback/bulk |
تجربة مجانية القياسية المميّزة الدفع حسب الاستخدام |
| Free Get-IP | GET /ip |
بلا مفتاح |
لكل دالة صفحة في مرجع الواجهة، مثل فحص عنوان IP وكشف احتيال الدفع.
شكل الاستجابة#
- النجاح:
{"data": {...}, "status": "success", "executionTime": 12}. - الفشل:
{"status": "error", "code": 101, "type": "invalid_key", "description": "..."}.
تُعاد الأخطاء برمز HTTP 200، لذا افحص الحقل status في المحتوى ولا تعتمد على رمز HTTP. القائمة الكاملة في رموز الأخطاء.
خيارات مشتركة بين كل الدوال#
| المعامل | الغرض |
|---|---|
key |
مفتاح الواجهة (أو ترويسة Bearer). راجع المصادقة. |
format |
JSON أو XML أو CSV أو Newline. راجع صيغة الاستجابة. |
lang |
لغة الحقول المترجمة. راجع اللغات. |
mode |
live أو test. راجع بيئة التطوير. |
params |
وحدات بيانات إضافية. راجع تخصيص الوحدات. |
userID |
وسم الطلب بمستخدمك. راجع معرّف المستخدم. |
callback |
دالة JSONP. راجع JSONP. |
إلى أين بعد ذلك#
- المصادقة ومفاتيح الواجهة.
- حدود الاستخدام لخطتك.
- رموز الأخطاء وطريقة التعامل معها.
وجدت خطأ؟ أخبرنا عبر صفحة التواصل. تواصل معنا