الأخبار

التوافق البديل المباشر مع ip-api.com متاح الآن

كثيرًا ما يكون ip-api.com أول خدمة لتحديد الموقع الجغرافي عبر IP يلجأ إليها المطور، ويرجع ذلك أساسًا إلى سرعة تجربته وسهولة ربطه بنص برمجي. وهذه البساطة نفسها هي بالضبط ما بُني مضيفنا المتوافق للحفاظ عليه، مع العمل خلف مجموعة مختلفة من قواعد الحصص والأسعار.

يعيد المضيف إنتاج طريقة معالجة الطلبات في ip-api.com ومتن الاستجابة مطابقة تامة، باستثناء نصوص حقوق النشر والشروط والخصوصية، وهي خاصة بنا. فالطلب الذي كان يُرسل إلى نقطة نهاية ip-api.com يمكن إرساله إلى نقطة نهايتنا بدلًا منها، ويُحلَّل JSON العائد بالطريقة نفسها، بأسماء الحقول نفسها في المواضع نفسها.

لأن /v1/ip يحلل عائلتي العناوين كلتيهما بالكامل، يتعامل مضيف التوافق هذا مع استعلامات IPv4 وIPv6 بالطريقة نفسها. فاستعلام عنوان IPv4 واستعلام عنوان IPv6 يعودان كلاهما بالبنية الصحيحة، دون الحاجة إلى أي خيار إضافي لإخبار المضيف بنوع العنوان الذي يتعامل معه.

تصادق المفاتيح هنا بالطريقة نفسها المتبعة في كل مكان آخر على My Geocode: في ترويسة X-API-Key، أو في ترويسة Authorization: Bearer، أو عبر مصادقة HTTP Basic مع المفتاح بوصفه اسم المستخدم، أو في معلمة استعلام. وأيًا كان الأسلوب الذي يستخدمه تكاملك الحالي، فهو مقبول دون تعديل.

الأسعار على هذا المضيف تطابق كل مضيف ونقطة نهاية أخرى نشغّلها. يحصل أي عنوان على 2,500 استعلام IP مجاني يوميًا دون أي مفتاح، تُحسب لكل شبكة. ويضيف المفتاح 2,500 طلب مجاني يوميًا منفصلة خاصة به. وبعد ذلك، يكلّف الرصيد المسبق الدفع 0.0001 € للطلب، أو تغطي باقة Unlimited كل شيء بسعر 50 € شهريًا، دون أي علاوة مرتبطة باستخدام مضيف توافق بدلًا من /v1/ip مباشرة.

ترافق ترويسات الحصة كل استجابة هنا أيضًا، وهو أمر لا يُظهره عادة تكامل ip-api.com العادي من تلقاء نفسه: تتضمن الاستجابة جميع X-Quota-Limit وX-Quota-Used وX-Quota-Free-Remaining وX-Quota-Network-Used وX-Credits-Remaining وX-Key-IPs-Used وX-Key-IPs-Limit وX-Quota-Reset.

للمشاريع التي تريد أكثر من الاستعلام القياسي، فإن إضافة mg_extras=1 إلى الطلب، أو إرسال ترويسة X-MG-Extras، يضيف حقولًا اختيارية مثل تفاصيل تهديدات IP والشبكة فوق الاستجابة المتوافقة، دون تغيير بنيتها الأساسية ما لم تطلب ذلك.

التفاصيل الكاملة في /compatibility/ip-api/. إذا كان نص برمجي في مكان ما من منظومتك يتصل أصلًا بالخدمة ip-api.com، فإن إعادة توجيهه إلى هنا طريقة سريعة لرؤية الفرق الذي يصنعه مضيف يراعي الحصص وتسعيره باليورو.