Tài liệu API

Sử dụng API miễn phí của 내아이피.kr để tra cứu thông tin IP theo cách lập trình.

Rate Limit: Cho phép 60 yêu cầu mỗi phút trên mỗi IP. Khi vượt quá, sẽ nhận phản hồi HTTP 429 kèm header Retry-After: 60. Phản hồi bao gồm các header X-RateLimit-Limit, X-RateLimit-Remaining.

GET /Api/MyIp

Trả về địa chỉ IP công cộng, thông tin vị trí và thông tin User-Agent của người yêu cầu.

Ví dụ phản hồi

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

Ví dụ sử dụng

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}

Tra cứu thông tin vị trí của địa chỉ IP được chỉ định.

Tham số

Tham sốKiểuBắt buộcMô tả
ipstringĐịa chỉ IP cần tra cứu (IPv4 hoặc IPv6)

Ví dụ phản hồi

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

Ví dụ sử dụng

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

GET /Api/PortCheck?port={port}

Kiểm tra trạng thái mở cổng được chỉ định trên IP của người yêu cầu. (Chỉ áp dụng cho IP của chính mình)

Tham số

Tham sốKiểuBắt buộcMô tả
portintSố cổng cần kiểm tra (1~65535, các cổng nguy hiểm bị chặn)

Ví dụ phản hồi

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

Status: Open / Closed / Filtered / Blocked / RateLimit

GET /Api/DnsLookup

Trả về kết quả Reverse DNS của IP người yêu cầu.

Ví dụ phản hồi

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

Widget bên ngoài

Chèn đoạn mã dưới đây vào trang web để hiển thị địa chỉ IP của khách truy cập.

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