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

API для IP Lookup

Описание API

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

Получение FileID

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

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

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

IP Lookup

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

http://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 'http://api.domengood.ru/?cid=UserID&s=SecretKey&ip=IPAddress&format=Format'

PHP:

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

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

{ "IPAddr": "91.227.68.130", "PTR": "nvhost.ru", "ContinentCode": "EU", "ContinentName": "Европа", "CountryCode": "RU", "CountryName": "Россия", "CityName": "", "TimeZone": "Europe/Moscow", "Latitude": "55.7386", "Longitude": "37.6068", "AccuracyRadius": "1000", "NetRange": { "StartIP": "1541620736", "FinishIP": "1541620991" }, "CIDR": "91.227.68.0/24", "AS": "50928", "ASOrg": "PJSC MegaFon", "DomainsOnIP": "9" }

где:

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

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

Ошибки

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

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