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 auth с ключом в качестве имени пользователя или в параметре запроса. Какой бы способ ни использовала ваша текущая интеграция, он принимается без изменений.
Цены на этом хосте такие же, как на всех остальных наших хостах и эндпоинтах. Любой адрес получает 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 включены все.
Для проектов, которым нужно больше, чем стандартное определение IP, добавление mg_extras=1 к запросу или отправка заголовка X-MG-Extras добавляет поверх совместимого ответа необязательные поля, например сведения об угрозах и сети для IP, не меняя его базовую структуру, пока вы об этом не попросите.
Все подробности на /compatibility/ip-api/. Если какой-то скрипт в вашем стеке уже обращается к ip-api.com, перенаправить его сюда будет быстрым способом увидеть, что меняет хост с учётом квот и ценами в евро.