API-Dokumentation

Verwenden Sie die kostenlose API von 내아이피.kr, um IP-Informationen programmatisch abzufragen.

Rate Limit: 60 Anfragen pro Minute pro IP. Bei Überschreitung wird HTTP 429 mit dem Header Retry-After: 60 zurückgegeben. Die Antwort enthält die Header X-RateLimit-Limit und X-RateLimit-Remaining.

GET /Api/MyIp

Gibt die öffentliche IP-Adresse, Standortinformationen und User-Agent-Daten des Anfragenden zurück.

Antwortbeispiel

{
  "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"
  }
}

Verwendungsbeispiel

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}

Fragt die Standortinformationen einer angegebenen IP-Adresse ab.

Parameter

ParameterTypErforderlichBeschreibung
ipstringJaAbzufragende IP-Adresse (IPv4 oder IPv6)

Antwortbeispiel

{
  "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
  }
}

Verwendungsbeispiel

curl "https://xn--220b31d95hq1c.kr/Api/IpLookup?ip=8.8.8.8"

GET /Api/PortCheck?port={port}

Prüft, ob ein bestimmter Port der anfragenden IP geöffnet ist. (Nur die eigene IP)

Parameter

ParameterTypErforderlichBeschreibung
portintJaZu prüfende Portnummer (1–65535, gefährliche Ports gesperrt)

Antwortbeispiel

{
  "success": true,
  "data": {
    "port": 80,
    "status": "Closed",
    "responseTime": 15
  }
}

Status: Open / Closed / Filtered / Blocked / RateLimit

GET /Api/DnsLookup

Gibt das Reverse DNS-Ergebnis der anfragenden IP zurück.

Antwortbeispiel

{
  "success": true,
  "data": {
    "ip": "203.0.113.1",
    "reverseDns": "host-203-0-113-1.example.com"
  }
}

Externes Widget

Fügen Sie den folgenden Code in Ihre Webseite ein, um die IP-Adresse des Besuchers anzuzeigen.

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