Многие приложения обращаются к IP-геолокации ровно один раз, когда пользователь впервые подключается, чтобы угадать страну или установить валюту по умолчанию и двигаться дальше. ipstack давно остаётся популярным выбором для этого единственного шага. Наш новый совместимый хост позволяет этому шагу работать так же, но с другим бэкендом.
Хост точно повторяет параметры запросов и тело ответа ipstack, за исключением текста об авторских правах, условиях и конфиденциальности, который относится к My Geocode, а не к исходному провайдеру. Где бы ваше приложение сейчас ни отправляло запрос в формате ipstack, оно может отправить тот же запрос на наш хост, и возвращаемые поля окажутся там же, где их ожидает ваш существующий код разбора.
Здесь полностью поддерживаются оба семейства адресов, как и в /v1/ip везде на платформе. И адрес IPv4, и адрес IPv6 корректно обрабатываются этим хостом, с одинаковой структурой ответа в обоих случаях.
Ключи можно передавать в заголовке X-API-Key, в заголовке Authorization: Bearer, через HTTP Basic auth с ключом в качестве имени пользователя или в параметре запроса, в зависимости от того, какой способ уже использует ваша интеграция с ipstack. Все четыре принимаются одинаково на всех наших хостах и эндпоинтах, поэтому код аутентификации редко приходится менять.
Цены за этим хостом такие же, как и везде. Любой адрес получает 2 500 бесплатных запросов в день без всякого ключа, с подсчётом по сети, чтобы общий офис или здание расходовали один общий лимит, а не множество. Ключ сам по себе добавляет ещё 2 500 бесплатных запросов в день. Сверх этих квот предоплаченный баланс стоит 0,0001 € за запрос, или пакет Unlimited покрывает использование за 50 € в месяц, без отдельного тарифа для этого совместимого хоста.
Каждый ответ также содержит наш полный набор заголовков квот, которых обычная интеграция с ipstack иначе не предоставила бы: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used и X-Credits-Remaining присутствуют все, запрос за запросом.
Если вашему проекту нужно больше, чем стандартный ответ, mg_extras=1 в запросе или заголовок X-MG-Extras добавляет поверх совместимой структуры необязательные поля, например сведения об угрозах и сети для IP. По умолчанию это выключено, поэтому формат ответа не меняется, пока вы специально об этом не попросите.
Совместимый хост описан на /compatibility/ipstack/, а полный справочник по определению IP на /docs/ipv4-lookup/ и /docs/ipv6-lookup/ охватывает всё, что лежит в его основе.