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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
ip | string | Có | Đị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ểu | Bắt buộc | Mô tả |
|---|---|---|---|
port | int | Có | Số 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>