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