الانتقال

الانتقال من ip-api.com

بنى ip-api.com قاعدة مستخدمين بفضل تنسيق استجابة بسيط حقًا: كائن JSON مسطح لكل عملية بحث بحقول مثل country وregionName وcity وlat وlon وisp وquery الذي يحمل عنوان IP الذي جرى البحث عنه، دون تداخل يُذكر. وقد جعلته هذه البساطة المسطحة خيارًا أول شائعًا لكل من يضيف تحديدًا أساسيًا للموقع الجغرافي لعناوين IP إلى مشروع دون الرغبة في تعلم مخطط أكثر تعقيدًا.

تحديد الموقع الجغرافي لعناوين IP من عمليات البحث التي يمكن فيها إظهار النتائج وهي تعمل فعلًا من البداية إلى النهاية، على عكس الترميز الجغرافي أو الإكمال التلقائي حيث يُوصف الشكل فقط. فالطلب على عنوان IPv4 أو IPv6 يعيد الدولة والمنطقة والمدينة والإحداثيات ومعلومات الشبكة، مأخوذة من بيانات تظل محدّثة عبر مسار التخزين المؤقت الخاص بنا، بدلًا من مجموعة بيانات ثابتة أو بطيئة التحديث.

يعيد المضيف البديل المتوافق مع ip-api في My Geocode إنتاج بنية الحقول المسطحة تمامًا، بما فيها country وregionName وcity وlat وlon وisp وquery، ويكون نص حقوق النشر والشروط والخصوصية هو الفرق الوحيد في المحتوى. والتفاصيل المرجعية موجودة في /compatibility/ip-api/. وينبغي أن تستمر الشيفرة التي تقرأ response.city أو response.isp مباشرة، دون فك أي كائن متداخل، في العمل بمجرد تغيير المضيف والمفتاح.

ما الذي يتغير تحديدًا في هذا الترحيل:

  • تنتقل المصادقة إلى مفتاح، يُرسَل كترويسة X-API-Key أو Authorization: Bearer أو مصادقة HTTP Basic أو معامل استعلام، بدلًا من بحث عام دون مصادقة أو بحدود خفيفة
  • أصبحت الحصة مرئية الآن مباشرة في كل استجابة عبر ترويسات مثل X-Quota-Limit وX-Quota-Used وX-Quota-Reset، بدلًا من الحاجة إلى استنتاجها من الإبطاء العرضي
  • الحقول الإضافية الاختيارية، تفاصيل تهديدات IP ومعلومات الشبكة الأعمق، متاحة بإضافة mg_extras=1 أو ترويسة X-MG-Extras، دون تغيير الشكل المسطح الذي تحلله شيفرتك أصلًا

هناك 2,500 طلب مجاني يوميًا دون أي مفتاح على الإطلاق، ويحصل كل مفتاح أيضًا على 2,500 طلب مجاني يوميًا تُحتسب لكل شبكة، سواء IPv4 (لكل /24) أو IPv6 (لكل /48)، وتتشاركها الاستخدامات دون مفتاح وبمفتاح من تلك الشبكة. وبعد هذه الحصة، يكون الخيار رصيدًا مسبق الدفع بسعر 0.0001 € للطلب أو مفتاح Unlimited مقابل 50 € شهريًا، وكل نقطة نهاية، بما فيها هذا المضيف البديل المتوافق، بالسعر نفسه.

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