Dokumentacja API

Skorzystaj z bezpłatnego API 내아이피.kr, aby programistycznie sprawdzać informacje o adresach IP.

Limit zapytań: 60 zapytań na minutę na adres IP. Po przekroczeniu limitu zwracana jest odpowiedź HTTP 429 z nagłówkiem Retry-After: 60. Odpowiedzi zawierają nagłówki X-RateLimit-Limit i X-RateLimit-Remaining.
GET /Api/MyIp

Zwraca publiczny adres IP, informacje o lokalizacji i dane User-Agent osoby wysyłającej żądanie.

Przykładowa odpowiedź
{
  "ip": "203.0.113.1",
  "geo": {
    "country": "South Korea",
    "countryCode": "KR",
    "city": "Seoul",
    "regionName": "Seoul",
    "isp": "Korea Telecom",
    "org": "Korea Telecom",
    "as": "AS4766",
    "lat": 37.5665,
    "lon": 126.978,
    "timezone": "Asia/Seoul",
    "isProxy": false
  },
  "userAgent": {
    "browser": "Chrome",
    "browserVersion": "131.0.0.0",
    "os": "Windows 10/11",
    "deviceType": "Desktop"
  }
}
Przykład użycia
curl https://xn--220b31d95hq1c.kr/Api/MyIp
fetch('https://xn--220b31d95hq1c.kr/Api/MyIp')
  .then(res => res.json())
  .then(data => console.log(data.ip));
import requests
r = requests.get('https://xn--220b31d95hq1c.kr/Api/MyIp')
print(r.json()['ip'])
GET /Api/IpLookup?ip={ip}

Sprawdza informacje o lokalizacji wskazanego adresu IP.

Parametr
ParametrTypWymaganyOpis
ipstringTakAdres IP do sprawdzenia (IPv4 lub IPv6)
Przykładowa odpowiedź
{
  "success": true,
  "data": {
    "query": "8.8.8.8",
    "country": "United States",
    "countryCode": "US",
    "regionName": "Virginia",
    "city": "Ashburn",
    "isp": "Google LLC",
    "lat": 39.0438,
    "lon": -77.4874,
    "isProxy": false,
    "isHosting": true
  }
}
Przykład użycia
curl "https://xn--220b31d95hq1c.kr/Api/IpLookup?ip=8.8.8.8"
GET /Api/PortCheck?port={port}

Sprawdza, czy wskazany port na adresie IP osoby wysyłającej żądanie jest otwarty. (Dotyczy wyłącznie własnego adresu IP)

Parametr
ParametrTypWymaganyOpis
portintTakNumer portu do sprawdzenia (1–65535, niebezpieczne porty są blokowane)
Przykładowa odpowiedź
{
  "success": true,
  "data": {
    "port": 80,
    "status": "Closed",
    "responseTime": 15
  }
}

Status: Open / Closed / Filtered / Blocked / RateLimit

GET /Api/DnsLookup

Zwraca wynik Reverse DNS dla adresu IP osoby wysyłającej żądanie.

Przykładowa odpowiedź
{
  "success": true,
  "data": {
    "ip": "203.0.113.1",
    "reverseDns": "host-203-0-113-1.example.com"
  }
}
Widget zewnętrzny

Wstaw poniższy kod na swoją stronę internetową, aby wyświetlać adres IP odwiedzającego.

<div id="myip-widget"></div>
<script src="https://xn--220b31d95hq1c.kr/js/widget.js"></script>