تخطَّ إلى المحتوى
Gurdx

التوثيق / الخيارات

اللغات

استخدم المعامل lang لتتلقى الحقول المترجمة بلغة مستخدميك.

المعامل lang#

curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY&lang=AR"

القيمة لا تتأثر بحالة الأحرف، والافتراضي EN. اللغات المدعومة:

langاللغة
ENالإنجليزية
ARالعربية
FRالفرنسية
DEالألمانية
ESالإسبانية
JAاليابانية
ZHالصينية
RUالروسية

القيمة غير المدعومة تعيد الخطأ 110 invalid_language.

ما الذي يُترجم#

تُترجم الحقول الوصفية فقط، مثل أسماء الدول وغيرها من التسميات المقروءة. أما الرموز والأرقام والقيم المنطقية وعناوين IP وأسماء الحقول فتبقى كما هي في كل اللغات، فيمكنك الاستمرار في تحليل الاستجابات بمسار شيفرة واحد.

تعتمد الترجمة على الدالة ومصدر البيانات. وحين لا تتوفر ترجمة لقيمة معيّنة تعيد Gurdx النص الإنجليزي بدل ترك الحقل فارغاً.

مثال#

curl "https://gurdx.cretip.com/api/lookup/country?key=YOUR_API_KEY&countryCode=DE&lang=FR"
{
  "data": {
    "countryCode": "DE",
    "countryName": "Allemagne"
  },
  "status": "success",
  "executionTime": 5
}

رسائل الأخطاء#

يبقى description في أخطاء الواجهة بالإنجليزية بغض النظر عن lang. اعتمد على code وtype واعرض لمستخدميك رسالتك المترجمة. راجع رموز الأخطاء.

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

curl "https://gurdx.cretip.com/api/geoip?key=YOUR_API_KEY&lang=JA&params=location,timezone"

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

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