Главная / API /IP Lookup API

API для IP Lookup

Описание API

Скачивание файлов

Получение FileID

Получение данных

Вы можете получать данные об IP-адресе IP v4 или IP v6 такие как: Подсеть, диапазон адресов подсети, ISO-код континента, название континента, ISO-код страны, навзание страны, название города, временная зона, широта, долгота. через API или через форму.

Ответ реализован в виде JSON или XML. Для использования API вам потребуется регистрация и приобретение тарифного плана.

IP Lookup

Для запроса вам необходимо использовать URL:

https://api.domengood.ru/?cid=UserID&s=SecretKey&ip=IPAddress&format=Format

где:

UserID - ваш пользовательский ID из Личного кабинета;

SecretKey - ваш секретный ключ из Личного кабинета;

IPAddress - IP-адрес в строковом формате, к примеру, 91.227.68.240 или 2a00:15f8:a000:4:1:5:1:80;

Format (необязательно) - формат выдачи ответа, json или xml. По умолчанию - JSON.

Примеры использования

Самое простое - вставить сгенерированный URL в адресную строку браузера. Если вы получили ответ в вашем формате - вы всё сделали правильно.

Другие примеры:

CURL:

curl 'https://api.domengood.ru/?cid=UserID&s=SecretKey&ip=IPAddress&format=Format'

PHP:

<?php file_get_contents('https://api.domengood.ru/?cid=UserID&s=SecretKey&ip=IPAddress&format=Format'); ?>

В результате выполнения вы получите JSON-данные наподобие:

{ "IPAddr": "34.102.136.180", "ContinentCode": "NA", "ContinentName": "Северная Америка", "CountryCode": "US", "CountryName": "США", "CityName": "Канзас-Сити", "TimeZone": "America/Chicago", "Latitude": "39.1027", "Longitude": "-94.5778", "AccuracyRadius": "20", "NetRange": { "StartIP": "34.102.128.0", "FinishIP": "34.102.255.255" }, "CIDR": "34.102.128.0/17" }

где:

IPAddr - IP-адрес IP v4 или IP v6 в строковом формате;
ContinentCode - Двухзначный ISO-код (стандарт ISO 639-1) континента;
ContinentName - Название континента на русском языке;
CountryCode - Двухзначный ISO-код (стандарт ISO 639-1) страны;
CountryName - Название страны на русском языке;
CityName - Название города на русском языке;
TimeZone - Временная зона.
Latitude - Широта.
Longitude - Долгота.
AccuracyRadius - Радиус точности.
NetRange - первый и последний IP-адрес диапазона.
CIDR - Подсеть.

При отсутствии данных, параметр будет присутствовать, но значение будет пустым.

Ошибки

В случае ошибок вы будете получать сообщения об ошибках в plain-text:

Service Temporary Unvailable - Сервис временно недоступен
Lost Parametr - Не передан один или более параметров
Subscribe Not Found - Не найдена активная подписка
Wrong Parametr - Передан неправильный параметр
API Query Limit Reached - Закончился суточный лимит запросов по вашей подписке
Domain Not Found - Домена нет в нашей базе