Местоположение часто лишь часть того, что важно знать об IP-адресе. Связан ли этот адрес с известной вредоносной активностью и к какому типу сети он на самом деле принадлежит, может быть не менее важно для предотвращения мошенничества, контроля доступа или общей оценки рисков. /v1/ip теперь возвращает именно эту информацию как дополнительную опцию, доступную всякий раз, когда вы её запрашиваете.
Если добавить к запросу mg_extras=1 или отправить заголовок X-MG-Extras, поверх стандартного ответа о местоположении добавляются сведения об угрозах и сети для IP, при этом базовые поля, которые возвращаются и так, никак не меняются. Без этого флага ответ остаётся точно таким же, как всегда. С ним тот же вызов возвращает дополнительные сведения рядом с уже получаемыми полями местоположения.
Тот же механизм работает и для высоты рельефа, поэтому mg_extras=1 служит единым, последовательным способом запросить дополнительные данные в разных эндпоинтах, а не отдельным флагом для каждой функции. Он работает и на наших совместимых хостах, поэтому запрос в формате ip-api.com, ipinfo.io или ipstack может добавить тот же флаг или заголовок поверх в остальном точно совпадающего формата запроса и ответа и получить сведения об угрозах и сети, не нарушая совместимости с исходным форматом.
Цена не зависит от того, запрашиваются ли дополнительные данные. Поиск с добавленным mg_extras=1 учитывается в бесплатном лимите, предоплаченном балансе или пакете Unlimited как один запрос, точно так же, как поиск без него. Отдельного, более дорогого тарифа для дополнительных сведений нет, как нет и отдельной квоты, которую нужно отслеживать специально для них.
Это рассчитано прежде всего на сценарии, где одного местоположения недостаточно. Приложение, проверяющее регистрации на подозрительную активность, сервис, решающий, нужна ли дополнительная проверка для конкретного подключения, или инструмент безопасности, составляющий более широкую картину репутации сети, могут получать этот контекст напрямую из того же вызова /v1/ip, который они уже делают, вместо того чтобы поддерживать вторую интеграцию с отдельным поставщиком данных об угрозах ради одной этой части.
Полная документация IP-эндпоинтов, в том числе о том, как добавить дополнительные данные, доступна на страницах /docs/ipv4-lookup/ и /docs/ipv6-lookup/. Поскольку функция полностью включается по желанию, проверить её на существующей интеграции так же просто, как добавить один флаг к вызову, который вы уже делаете.