My Geocode

Миграция

Переход с ipstack

· 3 мин чтения · My Geocode · #ipstack#ip-geolocation#migration#compatibility#api

ipstack аутентифицирует запросы с помощью параметра запроса access_key и возвращает JSON-ответ с полями type (ipv4 или ipv6), continent_code, latitude, longitude, а на более высоких тарифах ещё и с вложенным объектом connection, содержащим сведения об автономной системе и провайдере отдельно от полей верхнего уровня. Эта вложенная структура connection немного сложнее, чем более плоские форматы некоторых конкурентов, и подходит приложениям, которым нужно, чтобы сведения о провайдере и сети были отдельной логической группой, а не смешивались с полями местоположения.

Миграция такой вложенной структуры требует чуть большей осторожности, чем плоский ответ, просто потому что в дереве ответа больше мест, где название поля может отличаться. Прежде чем считать миграцию завершённой, стоит протестировать именно вложенные пути, а не только поля верхнего уровня.

Совместимый хост ipstack в My Geocode воспроизводит полную структуру, включая поля type, continent_code, latitude, longitude и вложенный объект connection, меняя только текст об авторских правах, условиях и конфиденциальности. Справочные сведения на странице /compatibility/ipstack/. Код, который читает response.connection.isp или response.type, должен получать ту же структуру после того, как его направят на новый хост с новым ключом.

Поскольку определение IP в My Geocode полностью работает от начала до конца, результаты здесь конкретные, а не описаны только форматом. Запрос по конкретному адресу возвращает страну, регион, город, координаты и сведения о подключении в реальном времени, с проверкой по слою кэширования, который поддерживает IP-геолокацию актуальной, а не полагается на редкие пакетные обновления.

Особенности миграции для интеграций ipstack:

  • Схема с параметром запроса access_key напрямую соответствует нашему варианту с параметром запроса, либо вы можете в рамках той же миграции перейти на заголовок X-API-Key, Authorization: Bearer или HTTP Basic auth, если хотите заодно сменить способ аутентификации
  • Дополнительные поля (высота там, где это уместно, сведения об угрозах для IP, более подробная информация о сети) доступны через mg_extras=1 или заголовок X-MG-Extras и дополняют стандартную структуру, ничего в ней не заменяя
  • Если ваша интеграция проверяет поля security для обнаружения прокси или угроз, эти конкретные значения входят в дополнительные данные, а не в базовый совместимый ответ, поэтому прежде чем рассчитывать на полное соответствие, уточните, от каких полей ваш код действительно зависит

Что касается цен, 2 500 запросов в день бесплатны вообще без ключа, а каждый ключ получает собственные 2 500 бесплатных запросов в день с учётом по сети. Сверх этого единообразно действует предоплаченный баланс по 0,0001 € за запрос или ключ Unlimited за 50 € в месяц, и каждый эндпоинт, включая этот совместимый хост, стоит одинаково. Для приложений, которые используют объект connection из ipstack как отдельную группу данных в своих внутренних моделях, эта группировка переносится без изменений, поэтому код ниже по цепочке, дашборды и хранилища данных, построенные на этой структуре, остаются нетронутыми.

Ещё в разделе «Миграция»