Документація API

Основна інформація API

Щоб почати користуватися API IPHunter, потрібно підписатися на план

Підписатися

У відповіді API ми маємо поле під назвою block , який ідентифікує рівень ризику аналізованого ІС. Коли block дорівнює 1, ми радимо заблокувати доступ аналізованого користувача, щоб уникнути проблем решті користувачів, які правильно користуються своїм веб-сайтом чи додатком.

block: 0 Житлова / некласифікована IP (безпечний IP)

block: 1 Нежитловий IP (хостинг, проксі, VPN ...)

block: 2 Нежитлова та житлова IP (попередження, може попереджати невинних людей)

Щодня ми знаємо більше 3000 нових IPS, які використовуються для приховування реальної ідентичності користувачів (серед інших причин).

Для отримання додаткової інформації, не соромтеся ознайомитися з нашою документацією.

Документація

Додаткова інформація

На додаток до типу зв'язку з рівнем безпеки ( block ), ми надсилаємо назву країни англійською мовою, код країни, місто та Інтернет-провайдер IP.

Перш ніж заблокувати IP-адресу на вашому веб-сайті, радимо проаналізувати, чи користувач намагається здійснити будь-які шахрайські дії щодо вашої програми. Ми боремося з шахрайством в Інтернеті, і в 90% випадків вони використовують хостинг, VPN або проксі, щоб приховати ідентифікацію користувачів.

Відповідь вибірки API

Endpoint

curl https://www.iphunter.info:8082/v1/ip/148.56.53.217 -H "X-Key: PRIVATEAPIKEY"

Правильна відповідь

{
    "status": "success",
    "data": {
        "ip": "148.56.53.217",
        "ip_num": 2486711769,
        "country_code": "ES",
        "country_name": "Spain",
        "city": "Madrid",
        "isp": "Vodafone Espana S.A.U.",
        "block": 0
    }
}

Відповідь на помилку

{
    "status": "error",
    "code": "Bad Ip Range"
}

API відповідає у форматі JSON. cURL - програма командного рядка для відновлення даних з Інтернету за допомогою консолі.

Якщо ви досягнете ліміту запитів (за секунду чи за день), буде повернуто код статусу HTTP 429.