تخصيص الوحدات

استخدم المعامل params لتطلب بالضبط البيانات الإضافية التي تحتاجها وتُبقي الاستجابات صغيرة.

كيف يعمل#

بعض الدوال، وأهمها الموقع الجغرافي للزائر وفحص عنوان IP، تعيد مجموعة حقول أساسية وعدداً من الوحدات الاختيارية. الحقول الأساسية مضمّنة دائماً. ولإضافة وحدات اذكرها في params مفصولةً بفواصل.

# وحدة الجهاز فقط
curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY&params=device"

# عدة وحدات
curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY&params=timezone,currency,security"

الاسم parms مقبول أيضاً كاسم بديل. أسماء الوحدات لا تتأثر بحالة الأحرف، والأسماء غير المعروفة تُتجاهل.

الوحدات المتاحة#

الوحدة	تضيف
`security`	فحوص التهديد للعنوان: وكيل وVPN وTor ونحوها. راجع كشف VPN والوكيل.
`currency`	تفاصيل عن عملة الزائر.
`timezone`	معلومات المنطقة الزمنية كالفارق والوقت المحلي.
`location`	تفاصيل موقع إضافية فوق الحقول الأساسية.
`device`	معلومات من وكيل المستخدم: المتصفح ونظام التشغيل ونوع الجهاز.

لدالة معلومات الدولة وحداتها الخاصة (currency وtimezone وlanguage وflag)، وتعيدها كلها إذا لم تُمرَّر params.

متطلبات الخطة#

تتطلب وحدة security ميزة الأمان في خطتك. إذا لم تتوفر يفشل الطلب بالخطأ 114 security_module_not_allowed. أما بقية الوحدات فمتاحة في كل خطة تشمل الدالة.

مثال على الاستجابة#

{
  "data": {
    "ip": "203.0.113.7",
    "countryCode": "SA",
    "security": {
      "proxy": false,
      "vpn": false,
      "tor": false
    }
  },
  "status": "success",
  "executionTime": 18
}

أسماء الحقول داخل كل وحدة مذكورة في صفحة الدالة التي تعيدها.

الجمع مع بقية الخيارات#

curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY&params=security,timezone&lang=AR&format=JSON"

Tip: اطلب الوحدات التي تستخدمها فقط. الاستجابات الأصغر أسرع وأخف في المعالجة.

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