Определение места по ip: Информация об IP адресе или домене

API геолокации по IP — Документация

Вы можете вызвать API, отправив GET запрос http://ipwhois.app/json/{IP}

{IP} может быть IPv4 или IPv6 адресом, оставьте параметр пустым чтобы использовать текущий IP-адрес.

Пример

Вы можете отредактировать этот запрос и поэкспериментировать с параметрами

Ответ

{
  "ip": "8.8.4.4",
  "success": true,
  "type": "IPv4",
  "continent": "North America",
  "continent_code": "NA",
  "country": "United States",
  "country_code": "US",
  "country_flag": "https://cdn.ipwhois.io/flags/us.svg",
  "country_capital": "Washington",
  "country_phone": "+1",
  "country_neighbours": "CA,MX,CU",
  "region": "New Jersey",
  "city": "Newark",
  "latitude": 40.735657,
  "longitude": -74.1723667,
  "asn": "AS15169",
  "org": "Google LLC",
  "isp": "Google LLC",
  "timezone": "America/New_York",
  "timezone_name": "Eastern Standard Time",
  "timezone_dstOffset": 0,
  "timezone_gmtOffset": -18000,
  "timezone_gmt": "GMT -5:00",
  "currency": "US Dollar",
  "currency_code": "USD",
  "currency_symbol": "$",
  "currency_rates": 1,
  "currency_plural": 0
}

Возвращенные данные

API может возвращать следующие поля и значения

название	описание
ip	Запрашиваемый IP адрес (пример 8. 8.4.4)
success	true или false
message	Включается только тогда, когда success является false Может быть одним из следующих: invalid IP address, you’ve hit the monthly limit
type	Тип IP адреса (IPv4 или IPv6)
continent	Название континента (пример North America)
continent_code	Двухбуквенный код континента (пример NA)
country	Название страны (пример United States)
country_code	Двухбуквенный код страны (пример US)
country_capital	Столица страны (пример Washington)
country_phone	Телефонный код страны (пример +1)
country_neighbours	Соседние страны (пример CA,MX,CU)
region	Регион/штат (пример Virginia)
city	Город (пример Ashburn)
latitude	Широта (пример 39. 0437567)
longitude	Долгота (пример -77.4874416)
as	Номер AS (пример AS15169)
org	Название организации (пример Level 3 Communications)
isp	Имя провайдера (пример Level 3 Communications)
timezone	Часовой пояс (пример America/New_York)
timezone_name	Полное название часового пояса (пример Eastern Standard Time)
timezone_dstOffset	Смещение для летнего времени в секундах.
timezone_gmtOffset	Смещение от UTC (в секундах) для данного местоположения. (пример -18000)
timezone_gmt	Часовой пояс GMT. (пример GMT -5:00)
currency	Название валюты страны. (пример US Dollar)
currency_code	Код валюты страны. (пример USD)
currency_symbol	Символ валюты страны. (пример $)
currency_rates	Текущий курс по отношению к доллару США.
currency_plural	Название валюты во множественном числе. (пример US dollars)
completed_requests	Количество обращений к API за текущий месяц (Обновляется раз в 2 минуты).

Укажите поля ответа

Если вам не требуются все возвращаемые поля, вы можете ограничить набор результатов API определенными полями, для этого добавьте параметр GET objects к URL-адресу запроса к API и установите для него определенное поле или список полей через запятую.

Например: objects=country,city,timezone Запустить запрос

JSONP Callback

API поддерживает функцию обратного вызова (JSONP). Просто добавьте параметр callback к URL-адресу запроса API и задайте для него имя вашей функции.

Например: callback=getIPinfo Запустить запрос

Локализация

Локализацию city, region, country и continent можно запросить, установив для GET параметра lang одно из следующих значений:

Лимиты

Вы можете пользоваться нашим API бесплатно до 10,000 запросов в месяц.

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

Как вычислить адрес по IP-адресу

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

Возможно, читатель получал угрозы в соцсетях или по электронной почте, которые сводятся к тому, что оппонент вычислит его по IP-адресу и применит к нему различные санкции, начиная с «набития» лица и заканчивая физическим устранением.

Или другой вариант, вас оскорбляют в Интернете, пользуясь полной анонимностью, предоставляемой всемирной паутиной. И очень хочется найти обидчика. Или же вы стали жертвой мошенничества в сети и можете задаться вопросом о том, как найти мошенника. Как вычислить адрес по IP-адресу? Для начала немного теории.

Термин «ай-пи» английского происхождения. Расшифровывается как Internet Protocol, что в дословном переводе означает «межсетевой протокол».

Введём некоторые термины и определения.

Сетевой протокол – определённый набор правил, условий и действий (очерёдности действий) для осуществления соединения и обмена данными между двумя и более включёнными в сеть устройствами.

А причём здесь «ай-пи»? Именно он объединил компьютерные сети (КС) во всемирную паутину. В «локалках», наряду с ним, могут применять и другие протоколы.

IP-адрес – уникальный идентификатор узла сети, которая построена на основе рассматриваемого протокола. Причём КС может быть глобальной (например, Интернет) и локальной (в пределах фирмы, института и т. д.). Разумеется, что уникальность адреса в Интернете должна быть глобальной, а в случае локальной сети – только в её пределах.

Под узлом КС в общем случае понимается не только ноутбук или стационарный компьютер, но и карманный, а также мобильный телефон и специальные устройства (концентратор, роутер, и др. ).

Версии IP-протокола и виды адресов

Информационные технологии постоянно развиваются. Наиболее широко используемой версией в настоящее время является четвёртая (IPv4). IP-адрес в ней представляется в виде четырёх чисел в диапазоне от 0 до 255, разделённых точкой, например 125.12.35.0. Но пользоваться набором цифр неудобно, поэтому, например, для сайтов, адрес привязывают к доменному имени. И пользователь в строке браузера набирает mail.ru, а не 94.100.180.199. Хотя, если ввести эти цифры, тоже можно попасть на сайт Mail.Ru. Также в ходу шестая версия протокола (IPv6), но на ней останавливаться не будем.

IP-адреса бывают двух видов:

• статический (постоянный, неизменяемый) – назначается конкретному устройству в КС и не может быть назначен другому;
• динамические (непостоянные, изменяемые) – присваивается автоматически при подключении узла к сети и используется им в течение времени, указанного в специальном сервисе.

Если посмотрите договор с провайдером, то, скорее всего, там отмечено, что «ай-пи» у вас динамический. Что нам это даёт? Пользователь с таким адресом каждый раз выходит в Интернет под новым IP. Это можно проверить на указанных ниже ресурсах. С теорией всё, идём дальше.

Получение «ай-пи» сетевого устройства

Раз каждому компьютеру в КС присваивается уникальный адрес, то возникает вопрос о том, можно ли вычислить IP-адрес. Ответ простой: можно. И очень просто, но только адрес своего компьютера. Для этого можно использовать, например, два ресурса сети Интернет: 2ip.ru и SpeedTester.Info.

На первом вы увидите информацию о текущем адресе, браузере, операционной системе вашего компьютера, используете вы прокси или нет и некоторые другие данные. На SpeedTester.Info – практически то же, а также расположение данного «ай-пи» на карте местности. Ура! Проблема о том, как вычислить адрес по IP-адресу, решена! Однако не всё так просто. На карте показан провайдер, что предоставил вам доступ в Интернет, а не нахождение вашего компьютера.

Итак, со своим понятно. А как вычислить чужой IP-адрес?

Получение «ай-пи» другого компьютера

Для этого необходимо немного потрудиться. На Speed-Tester.Info есть специальный сервис – «узнать чужой IP». Просто щёлкаете на пункте меню и переходите на страничку с этим сервисом.

А теперь, чтобы вычислить IP-адрес чужого компьютера, поступаем просто: вводим свой адрес электронной почты и имя интересующего нас пользователя (вместо имени может быть ник, e-mail). Сервис генерирует короткую ссылку, и мы отправляем её собеседнику. Как только он по ней переходит, получаем на почту его «ай-пи».

Принятый адрес можно проверить на упомянутых ресурсах или на любом из сервисов «whois», которых полно в Интернете. Если у вас UNIX-подобная операционная система, и вам нужно получить информацию, например, об адресе 125.124.13.41 то просто набираете в терминале команду «~$ whois 125.124.13.41» и видите на экране всё о предоставившем его провайдере.

Итак, как вычислить IP-адрес компьютера, разобрались.

Прокси, Tor и прочее…

Для обеспечения анонимизации в Интернете часто используются прокси-серверы, т. е. серверы, которые принимают на себя запрос клиента, получают необходимую информацию и передают её пользователю. В этом случае вы получите IP-адрес этого узла, который может находиться где угодно, хоть в Зимбабве. Также существуют искажающие прокси-серверы, передающие ложную информацию о настоящем пользователе. Тогда всё намного хуже.

Однако в последнее время сфера использования прокси больше сместилась из анонимизации в область обеспечения доступа к законодательно ограниченным ресурсам, у которых стоит фильтр по «ай-пи». Например, российские компьютеры не могут к ним подключиться, а зимбабвийские – запросто.

Также достаточно хорошую защиту обеспечивает система так называемой «луковичной маршрутизации» Tor. Она представляет собой совокупность прокси-серверов для установления анонимного сетевого соединения, защищённого от прослушивания за счёт шифрования передаваемой информации.

Таким образом, если ваш оппонент работает через Tor-браузер, то его настоящий IP-адрес вы, не будучи хакером или сотрудником технического отдела спецслужб, не получите.

Провайдеры

Существует такая коммерческая организация, которая обеспечивает доступ в Интернет. Она называется «Интернет-провайдером» или просто «провайдером». Такая фирма имеет лицензию на предоставление подобного вида услуг, выданную Роскомнадзором (для России). Естественно, что в её базе данных имеется вся необходимая информация.

Каждый компьютер, подключённый через провайдера, имеет уникальное имя, внутренний IP-адрес, MAC-адрес. Разумеется, в базе отражено и то, где именно установлено устройство.

И даже если у вас динамический адрес, в специальных электронных журналах (log-файлах) отражается, какому компьютеру присвоен тот или иной «ай-пи», на какие страницы пользователь этого устройства заходил и т. д. То есть в наличии полный компромат на каждого.

Вся эта информация хранится у провайдера в течение трёх-пяти лет.

Операторы сотовой связи

Как многим известно, операторы сотовой связи (ОСС) также предоставляют услуги по выходу во всемирную паутину. Здесь рассмотрим использование для доступа во всемирную сеть технологий мобильной связи, таких, например, как EDGE или CDMA.

В этом случае тоже всё достаточно просто. Неважно, используется ли мобильный телефон в качестве модема для связи стационарного компьютера или ноутбука с всемирной паутиной или сам является устройством для доступа в Интернет. Главное — то, что он также получает IP-адрес, который может быть статическим или динамическим, в зависимости от подключённых услуг.

Когда человек покупает SIM-карту, то в большинстве случаев предоставляет паспортные данные, которые хранятся у ОСС. И на серверах оператора также имеются log-файлы, где хранится информация о том, какой SIM-карте присваивался тот или иной «ай-пи».

И в случае определения IP-адреса абонента указанными выше способами мы получим адрес оператора сотовой связи.

Определение пользователя по «ай-пи»

Итак, мы выяснили, как вычислить адрес по IP-адресу. Но в этом случае получим точку расположения провайдера или его подразделения. Например, если вы будете проверять свой «айпишник», то, будучи в Москве, можете обнаружить, что находитесь где-то под Красноярском.

Понятно, что большинство читателей интересует другой вопрос: «Как вычислить по IP-адресу человека?»

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

Если читатель обладает хакерскими навыками, достаточными, чтобы добыть log-файлы провайдеров или ОСС, то можно попробовать. Только не стоит удивляться, если к нему в дверь постучат сотрудники Управления «К» МВД России или их коллеги в другой стране.

Ещё может быть такой вариант, когда, имея навыки социального программирования, вы всё-таки смогли убедить сотрудника фирмы-провайдера поделиться ценной информацией. Но говорить о том, что у вас получилось вычислить человека по IP-адресу, вряд ли уместно. Вы не определили местоположение пользователя, используя компьютерные технологии, а всего лишь получили информацию о нём и причём незаконным путём.

В заключение

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

Битрикс — GeoIP — определение местоположения по IP-адресу

1.7.1 (14.12.2016)	Новое Поправлен механизм подстановки выбранного местоположения для оформления заказа D7
1.7.0 (20.10.2016)	Новое Реализован механизм подстановки выбранного местоположения для оформления заказа D7
1.6.9 (23.08.2016)	Новое Установка города посетителя с помощью параметра cityId в адресной строке. ID городов можно найти на странице редактирования связи местоположения и складов в списке местоположений, определяемых по IP, или просто в базе веб-аналитики. Открыть демо-сайт для города Адлер: http://bitronic2-pro.romza.ru/?cityId=7276 Смена города посетителя при открытии сайта с другого поддомена при использовании совмещенного режима работы с модулем geoipstore и включенным редиректом на поддомены для автоматической смены города-склада. Исправления Установка куки для поддомена www. Устранены проблемы со сменой города при использовании на сайте модифицированной библиотеки jQuery с заблокированными синхронными AJAX запросами.
1.6.8 (08.04.2016)	Исправления Исправлена установка местоположения при оформлении заказа, при использовании нового компонента оформления заказа (Битрикс 16, D7)
1. 6.7 (17.03.2016)	Добавлена поддержка callback для YS.GeoIP.AutoComplete.buildList(query, callback) Теперь третьим параметром в YS.GeoIP.AutoComplete.buildList(query, callback, parentInput) — можно указать инпут который заполнится выбраным элементом автоподбора
1.6.6 (08.02.2016)	Добавлена поддержка новой версии компонента sale.order.ajax для автоматической подстановки города посетителя при выборе нового профиля покупателя в момент оформления заказа.
1.6.5 (05.02.2016)	Новый функционал Добавлен обработчик события для подстановки города в компонент создания профиля покупателя (yenisite:sale.personal.profile.add) из модуля yenisite.profileadd.
1.6.4 (26.01.2016)	Исправления Исправлена установка cookies для сайтов работающих на нескольких поддоменах
1. 6.3 (24.12.2015)	Исправлено небольшое замечание при установки cookies местоположений.
1.6.2 (27.11.2015)	Улучшения Добавлен параметр в компонент geoip.city который позволяет отключить перезагрузку страниы после выбора города
1.6.1 (01.09.2015)	Доработана совместимость с протоколом HTTPS. Исправлена проблема с конвертацией кодировки названия города при оформлении заказа.
1.6.0 (26.06.2015)	Подстановка города в форму оформления заказа из браузера перенесена в обработчик события на стороне сервера. Город подставляется во все незаполненные свойства заказа типа LOCATION (Местоположение), а не только в те, которые отмечены как местоположения для доставки. Устранена XSS-уязвимость в случаях, когда города посетителя нет в базе. Убрано появление решётки в URL при нажатии на выбор города. Устранены проблемы при работе через протокол HTTPS Исправлена работа модуля при использовании IPv4 вместо доменного имени сайта.
1.5.4 (13.05.2015)	Исправлена совместимость параметров компонента с последней версией Битрикса.
1.5.2 (22.04.2015)	Исправления в алгоритме определения быстрого поиска местоположений.
1.5.1 (20.04.2015)	Исправления в алгоритме определения домена для сохранения куки. Оптимизация и улучшение стабильности в конвертации кодировок. Исправлена ошибка в таймингах установки/чтения куки в совместной работе с yenisite. geoipstore
1.5.0 (26.01.2015)	Добавлена поддержка механизма «Местоположения 2.0»
1.4.7 (17.12.2014)	В параметрах компонента для списка быстрого выбора городов добавлены подписи области и страны. В списке быстрого выбора город устанавливается по идентификатору, заданному в параметрах компонента, а не поиском по названию города
1.4.6 (02.12.2014)	Служебная часть модуля исключена из учета модулем статистики.
1.4.5 (21.11.2014)	Исправление в механизме подстановки местоположения в оформлении заказа
1.4. 4 (18.11.2014)	Исправление названий модуля и компонентов в административной части
1.4.3 (13.10.2014)	Исправлена ошибка в объедененном режиме с модулем связи складов и цен
1.4.2 (07.10.2014)	Исправлена несовместимость с браузерами IE при использовании шаблона местоположений «Строка поиска».
1.4.1 (06.10.2014)	Исправления для страницы редактирования профиля покупателя.
1.4.0 (02.10.2014)	Добавлен новый параметр для объединения с компонентом модуля привязки городов и складов (yenisite.geoipstore) в одно целое. Исправлена работа с кодировкой UTF-8 для некоторых случаев. Исправлена работа параметра для запрета подключения jQuery из ядра Битрикс. Исправлена работа компонента совместно с технологией композитного сайта. Исправлено автоподставление местоположения при использовании модуля для редактирования профилей покупателя (yenisite.profileadd). Устранена перезагрузка страницы при каждом закрытии окна с выбором городов, если включен параметр «Не требовать обязательного подтверждения», но город даже не менялся. Устранены проблемы в работе модуля в том случае, когда города посетителя или города из списка быстрого выбора нет в базе местоположений интернет-магазина. Оптимизировано кеширование компонента. Оптимизировано построение списка городов при использовании поля ввода во всплывающем окне. Для поля ввода во всплывающем окне добавлена возможность выбора первого города из списка нажатием клавиши Enter.
1. 3.4 (22.08.2014)	Добавлена украинская локализация
1.3.3 (01.08.2014)	Оптимизация производительности для типового решения Битроник.
1.3.2 (30.07.2014)	Исправлены ошибки с установкой куки при кешировании компонента. Исправлена подстановка местоположения покупателя в шаблон popup (строка поиска) в одношаговом оформлении заказа.
1.3.1 (30.07.2014)	Добавлен автоперевод введеного в поисковой строке города в язык сайта при его сохранении. Устранено несколько конфликтов со стилями других модулей и шаблонов.
1.3.0 (29.07.2014)	Добавлен параметр для отключения всплывающего окна при автоопределении города. Добавлены параметры для управления списком городов быстрого выбора. Добавлена поддержка отображения городов в языке, заданном в настройках сайта. Добавлено обновление города в форме оформления заказа при смене города во всплывающем окне. Добавлена подстановка города при выборе нового профиля в одношаговом шаблоне оформления заказа. Исправлена логика работы с регионами в базе местоположений. Исправлена ошибка, из-за которой невозможно было открыть окно выбора города, если города посетителя нет в базе местоположений. Исправлена ошибка с переключением местоположения в многошаговом заказе, когда пользователь вручную выбирает другое. Исправления валидности верстки шаблона в составе типового решения Битроник. Устранено дублирование городов в списке автодополнения. Устранены проблемы с кодировкой на устройствах Android.
1. 2.0 (09.06.2014)	— Добавлен параметр для автоподтверждения определившегося города, даже если посетить закрыл окно выбора города.
1.1.7 (04.06.2014)	— Исправлена проблема с подставлением города на странице оформления заказа, при смене типа плательщика
1.1.6 (22.05.2014)	— Исправлена проблема с подставлением города на странице оформления заказа
1.1.5 (19.05.2014)	— Добавлена группа «Параметры подстановки города при оформлении заказа» в параметрах компонента geoip.city — Исправление мелких ошибок
1.1.4 (15.05.2014)	— Небольшие правки связанные с технологией «Композитный сайт»
1.1.3 (08.05.2014)	— Добавлена перезагрузка страницы после выбора города
1.1.2 (07.02.2014)	— Исправлена проблема верстки при использовании технологии «Композитный сайт»
1.1.1 (30.04.2014)	— Добавлена совместимость с версиями Битрикса до 14.5
1.1.0 (29.04.2014)	— Шаблоны всех используемых компонентов переведены на работу по технологии «Композитный сайт»
1.0.31 (17.04.2014)	— Исправлена проблема подставления города при оформлении заказа
1.0.30 (04.04.2014)	Исправлено отображение крестика для закрытия всплывающего окна.
1.0.29 (01.04.2014)	Исправлена работа компонента для всех случаев, когда исходное название страны в базе местоположений не «Russia».
1.0.28 (14.03.2014)	— Иcправлен механизм определения города при использовании кодировки windows-1251 — Исправлен вывод некорректных символов, при отключении подгрузки новых шрифтов — Небольшие правки в верстке
1.0.27 (14.11.2013)	— Иправление механизма подключения JS скриптов.
1.0.26 ()	— Иправление ошибки, связанных с городами не из РФ.
1.0.25 ()	— Иправление ошибки, возникающей на странице профиля покупателя.
1.0.24 ()	— Сохранение в куках ID местоположения. — Исправление ошибок, связанных с дублированием городов. — Вснывающее окно закрывается по esc и клику вне области. — Исправление неверного отображения в FF 3.6
1.0.22 ()	— Правки по стилизации input во всех цветовых схемах. — Незначительные правки в верстке при оформлении заказа.
1.0.21 ()	— Исправление ошибки, при которой не загружались файлы скриптов и стилей при включенном кэшировании. — Исправления недоработок, при которых была неверная работа на сайтах в кодировке cp1251. — Исправлена недоработка, при которой при регистрации пользователя в профиль могли записаться пустые значения.
1.0.20 ()	— Исправление кода, ранее приводящее к Warning — Исправление ошибки со шрифтом 1.0.19 — Исправление кода, ранее приводящее к Warning — Исправление проблем при включенном кэшировании 1.0.18 — Небольшие правки в структуре 1.0.17 — Небольшие правки в структуре 1.0.14 — Исправление ошибок в IE. Исправление ошибок со шрифтом 1.0.12 — Исправление ошибок со шрифтом. 1.0.11 — Добавлена возможность использования нового шрифта. 1.0.10 — Исправлена проблема с переключением цветовых схем. Добавлен параметр подключения jQuery из ядра Битрикс. 1.0.8 — Исправлена проблема с кодировкой. 1.0.7 — Небольшие исправления неправильного сохранения города. 1.0.6 — Исправлена ошибка при работе на 11-й версии Битрикса, для AJAX поиска города отсутствовали регионы. Исправлена ошибка, когда при отсутствии результатов AJAX поиска города, появлялся div. 1.0.5 — Убрано всплывающее сообщение об отсутствии модуля Веб-Аналитика. Добавлен выбор городов для Украины. 1.0.4 — Исправлена недоработка некорректного AJAX поиска города в IE. 1.0.3 — Исправления в верстке. 1.0.2 — Исправления в безопасности. Сообщение об отсутствии модуля Веб-Аналитика выводится только Администратору. 1.0.1 — Исправлена ошибка, возникающая при отсутствии модуля Веб-аналитика.

Документация по API геолокации IP и поиска IP

ipgeolocation предоставляет четыре API:

• API геолокации по IP
  API геолокации по IP предоставляет информацию о местоположении для любого адреса IPv4 / IPv6 или имени домена.
• Timezone API
  Timezone API предоставляет информацию о дате, времени и часовом поясе из названия часового пояса, IP-адреса или координат местоположения (широта и долгота).
• User-Agent API
  User-Agent API предоставляет точную информацию о браузере, устройстве и операционной системе из строки пользовательского агента устройства.
• Astronomy API
  Astronomy API предоставляет время восхода солнца, время захода солнца, время восхода луны и время захода луны, включая текущее положение, угол и расстояние до Солнца и Луны на заданную дату.

Эта документация предоставляет полную информацию о функциях и доступных опциях в вышеуказанных API. Для получения информации, связанной с нашей базой данных API геолокации IP, обратитесь в нашу службу поддержки.

Авторизация

Мы предоставляем два способа авторизации с использованием:

• Ключ API
• Источник запроса (CORS)

Чтобы использовать API, зарегистрируйтесь на желаемый план.

Мы предоставляем одинаковый ответ API в наших бесплатных и платных тарифных планах через https. Ответ на нескольких языках , Массовый поиск геолокации IP и Запрос на поддержку источника , однако, недоступен для бесплатных планов.

Вот обзор обоих методов авторизации.

Ключ API

Вы можете делать авторизованные запросы к нашему API, передав ключ API в качестве параметра запроса. Чтобы получить свой ключ API, войдите в нашу консоль API и получите оттуда свой ключ API.Мы настоятельно не рекомендуем использовать ключ API в клиентском JavaScript, так как это сделает ваш ключ API доступным для всех.

Чтобы использовать ключ API в клиентском JavaScript, используйте подход Request Origin (CORS) .

Источник запроса (CORS)

Эта функция доступна только для платных планов. Цель этой функции — вызвать наш API из клиентского JavaScript без использования вашего ключа API.

Чтобы использовать эту функцию, перейдите в консоль приложения и нажмите кнопку + Добавить в разделе Dashboard / API Keys.Откроется всплывающее окно с вопросом о добавлении ключа API или источника запроса. Выберите Request Origina и введите доменное имя веб-сайта, с которого вы будете делать запросы. Если ваш веб-сайт https://www.example.com, вы должны ввести example.com во всплывающем окне в качестве источника запроса.

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

Ограничение на количество ключей API + источник запросов

Количество дополнительных ключей API и источников запросов ограничено планом пользователя.

Вы можете добавить больше ключей API и источников запросов, чем установленный вами, по цене 2 доллара США.5 в месяц за ключ API или источник запроса.

Получить IP

Get IP endpoint возвращает IP-адрес клиента, откуда он был вызван. Поэтому, если вы вызываете его со своего сервера, он возвращает IP-адрес сервера. Если он вызывается с вашего веб-сайта, например, с помощью JavaScript, он вернет IP-адрес человека, просматривающего ваш сайт. Эта конечная точка не требует проверки подлинности, и вы можете использовать эту конечную точку без создания учетной записи. Вот пример curl :

  $ curl 'https: // api.ipgeolocation.io/getip '{"ip": "1.1.1.1"}  

Форматы ответов JSON и XML

Все конечные точки ipgeolocation API могут отвечать в форматах JSON и XML, JSON является форматом ответа по умолчанию.

Формат XML

Получить ответ API в формате XML можно двумя способами:

1. Передайте output = xml в качестве параметра URL.
2. Установите Accept HTTP Header на application / xml или text / xml .

Вот несколько примеров ответа XML:

 
                    $ curl 'https: // api.ipgeolocation.io/ipgeo?apiKey=API_KEY&ip=1.1.1.1&fields=city&output=xml '
                     

  {
    "ip": "8.8.8.8 ",
    "место расположения": {
        "страна": "США",
        "region": "Калифорния",
        "город": "Маунтин-Вью",
        «шир»: 37,40599,
        «lng»: -122.078514,
        "postalCode": "94043",
        "часовой пояс": "-07: 00",
        "geonameId": 5375481
    },
    "домены": [
        "0d2.net",
        "003725.com",
        "0f6.b0094c.cn",
        "007515.com",
        "0guhi.jocose.cn"
    ],
    "в качестве": {
        "asn": 15169,
        "name": "Google LLC",
        "route": "8.8.8.0/24",
        "домен": "https: // о.google / intl / en / ",
        "тип": "Контент"
    },
    "isp": "Google LLC",
    "прокси": {
        "прокси": ложь,
        "vpn": ложь,
        "tor": ложь
    },
}