API Định Vị Địa Lý IP & Phân Tích Rủi Ro Miễn Phí

API Định Vị IP & Phát Hiện Rủi Ro Gian Lận IP Miễn Phí

API tra cứu IP hiệu năng cao, hỗ trợ ngăn xếp kép IPv4/IPv6, đa ngôn ngữ. Giới hạn tần suất: 1 yêu cầu/giây, không giới hạn tổng số lượt gọi.

⏱️
Giới hạn tần suất Tối đa 1 yêu cầu mỗi giây (1 req/s).
♾️
Tổng hạn mức Không giới hạn hạn mức hàng ngày hoặc tổng hạn mức. Hoàn toàn miễn phí sử dụng 100%.

Điểm cuối API (Endpoints)

GET https://api.myipdns.com/
IPv4 IPv6 Định dạng JSON
GET https://v4.api.myipdns.com/
Chỉ IPv4 Định dạng văn bản thuần
GET https://v6.api.myipdns.com/
Chỉ IPv6 Định dạng văn bản thuần

Tham số truy vấn

Tên tham số Mô tả Ví dụ
ip Địa chỉ IP cần tra cứu. Nếu bỏ qua, trả về IP của chính người gọi. ?ip=8.8.8.8
lang Ngôn ngữ phản hồi. Hỗ trợ: en, cn, ru, ja, fr, de, es, pt. ?lang=zh-CN

Ví dụ phản hồi JSON

Request: GET https://api.myipdns.com/?ip=8.8.8.8&lang=en 

{
  "ip": "8.8.8.8",
  "continent": "North America",
  "continent_code": "NA",
  "country": "United States",
  "country_code": "US",
  "timezone": "America/Chicago",
  "latitude": 37.751,
  "longitude": -97.822,
  "asn": 15169,
  "as_org": "Google LLC",
  "native_type": "native",
  "rir_registry": "arin",
  "is_hosting": true,
  "usage_type": "DCH",
  "query_time": "0.03",
  "source": "maxmind.com"
}

API Chẩn đoán Ngăn xếp Giao thức & Quyền riêng tư qua Terminal (/check)

Điểm cuối kiểm tra cấu trúc liên kết cổng xuất và ngăn xếp giao thức trực tiếp có độ chính xác cao, không qua proxy, dành cho curl, wget và các tập lệnh tự động hóa.

⚡
Giới hạn tần suất đọc 1 yêu cầu/giây (bùng nổ tối đa 5) cho mỗi IP. Vượt quá sẽ trả về mã HTTP 429.
🔗
Hạn mức tạo liên kết chia sẻ 5 lượt tạo/giờ cho mỗi IP. Vượt quá hạn mức vẫn trả về kết quả chẩn đoán bình thường mà không kèm URL chia sẻ (HTTP 200).

Điểm cuối API (Endpoints)

GET https://myipdns.com/check
Dual-Stack Đầu ra mặc định (Màu sắc ANSI / Văn bản terminal)
GET https://myipdns.com/check?format=line
Dual-Stack Định dạng từng dòng (KEY=VALUE để phân tích trong Shell / Tự động hóa)
GET https://myipdns.com/check?format=json
Dual-Stack Định dạng JSON có cấu trúc

Tham số truy vấn

Tên tham số Mô tả Ví dụ
format Định dạng đầu ra: json (JSON có cấu trúc) hoặc line (định dạng KEY=VALUE) ?format=line / ?format=json
share Tạo liên kết báo cáo chia sẻ trong 30 ngày và huy hiệu SVG (giới hạn 5 lần ghi/giờ/IP) ?share=1
color Tắt mã thoát màu sắc ANSI: ?color=0 hoặc ?plain=1 ?color=0 / ?plain=1
-4 / -6 Thăm dò tường minh ngăn xếp IPv4 hoặc IPv6: curl -4 hoặc curl -6 curl -4 -sL https://myipdns.com/check

Quy chuẩn đầy đủ các trường JSON

Field Type Description
ipstringĐịa chỉ IP xuất của máy khách
ip_versionstringPhiên bản IP (IPv4 hoặc IPv6) (IPv4 / IPv6)
countrystringTên quốc gia được phân giải thông qua biểu quyết đồng thuận đa nguồn
country_codestringMã quốc gia viết hoa 2 chữ cái theo chuẩn ISO 3166-1 alpha-2
citystring | nullTên thành phố được phân giải thông qua biểu quyết đồng thuận đa nguồn (hoặc null nếu chưa đo)
asnstringSố hiệu mạng tự trị (ví dụ: AS15169)
as_orgstringTổ chức quản lý ASN hoặc tên nhà mạng ISP
is_datacenterbooleanCờ boolean biểu thị mạng trung tâm dữ liệu hoặc lưu trữ hosting
is_proxybooleanCờ boolean biểu thị cổng ra của VPN hoặc proxy thương mại
transportobjectĐối tượng tầng truyền tải. 🔴 Quy tắc lằn ranh đỏ: tất cả các chỉ số chưa được đo lường bắt buộc phải là null (tuyệt đối không dùng 0 hoặc false)
transport.mssstringKích thước phân đoạn tối đa TCP (MSS) quan sát được (ví dụ: 1380, hoặc "n/a")
transport.mtuinteger | nullMTU đường truyền được suy luận từ MSS (ví dụ: 1420 đối với WireGuard, hoặc null)
transport.mtu_notestring | nullPhân loại loại đường truyền gần đúng dựa trên MTU (hoặc null)
transport.wscaleinteger | nullHệ số tỷ lệ cửa sổ TCP (Window Scale) (hoặc null)
transport.syn_wininteger | nullKích thước cửa sổ TCP SYN khởi tạo (hoặc null)
transport.syn_ttlinteger | nullThời gian sống (TTL) của gói tin SYN khởi tạo ước tính (hoặc null)
transport.option_orderstring | nullThứ tự các tùy chọn TCP SYN được phân tách bằng dấu phẩy (hoặc null)
transport.ts_valinteger | nullGiá trị nhãn thời gian TCP (TSval) (hoặc null)
transport.ts_hzinteger | nullLuôn là null. Máy chủ chưa từng đo tần số đồng hồ nhãn thời gian; việc SYN có mang nhãn thời gian TCP hay không được biểu thị bằng ts_val.
transport.ecn_enabledboolean | nullTrạng thái boolean của Thông báo tắc nghẽn rõ ràng (ECN) (hoặc null)
cryptoobjectĐối tượng bắt tay ứng dụng & mật mã (phiên bản HTTP, phiên bản TLS, JA4, JA3, ALPN)
verdictobjectKết luận phân loại cấu trúc liên kết, căn cứ suy luận và mô tả tóm tắt
share_urlstring (optional)Liên kết báo cáo chia sẻ trong 30 ngày được tạo khi có yêu cầu ?share=1 trong hạn mức
badge_urlstring (optional)URL huy hiệu trạng thái SVG được tạo khi có yêu cầu ?share=1 trong hạn mức

Định dạng từng dòng (KEY=VALUE để phân tích trong Shell / Tự động hóa) Example:

ip=35.212.190.31
ip_version=IPv4
country=United States
country_code=US
city=San Jose
asn=AS15169
as_org=Google LLC
is_datacenter=true
is_proxy=false
mss=1380
mtu=1420
mtu_note=Encapsulated Tunnel (WireGuard / Tailscale / CDN)
wscale=7
syn_win=65535
syn_ttl=64
option_order=MSS,SACK_PERM,TS,NOP,WS
ts_val=987654
ts_hz=n/a
ecn_enabled=true
http_proto=HTTP/2.0
tls_version=TLS 1.3
ja4=t13d1516h2_8daaf6152771_000000000000
verdict=topo_terminated_remote_protocol
verdict_basis=reputation
verdict_summary=Data Center / Proxy Egress (Hosting Network)

Định dạng JSON có cấu trúc Example:

{
  "ip": "35.212.190.31",
  "ip_version": "IPv4",
  "country": "United States",
  "country_code": "US",
  "city": "San Jose",
  "asn": "AS15169",
  "as_org": "Google LLC",
  "is_datacenter": true,
  "is_proxy": false,
  "transport": {
    "mss": "1380",
    "mtu": 1420,
    "mtu_note": "Encapsulated Tunnel (WireGuard / Tailscale / CDN)",
    "wscale": 7,
    "syn_win": 65535,
    "syn_ttl": 64,
    "option_order": "MSS,SACK_PERM,TS,NOP,WS",
    "ts_val": 987654,
    "ts_hz": null,
    "ecn_enabled": true
  },
  "crypto": {
    "http_proto": "HTTP/2.0",
    "tls_version": "TLS 1.3",
    "ja4": "t13d1516h2_8daaf6152771_000000000000"
  },
  "verdict": {
    "key": "topo_terminated_remote_protocol",
    "basis": "reputation",
    "summary": "Data Center / Proxy Egress (Hosting Network)"
  }
}

Giao diện dòng lệnh (CLI / curl)

Không cần tích hợp API phức tạp. Bạn có thể thực thi lệnh trực tiếp trong terminal để lấy dữ liệu IP hoặc chuỗi IP thuần. Các yêu cầu CLI bị giới hạn tốc độ 1 yêu cầu mỗi giây.

1. Lấy hồ sơ JSON chuẩn của chính IP của bạn:

curl https://myipdns.com

2. Lấy hồ sơ JSON chuẩn của một IP đích (ví dụ: 8.8.8.8):

curl https://myipdns.com/ip/8.8.8.8

3. Lấy chuỗi IP dạng văn bản thuần (lý tưởng cho shell script):

curl https://myipdns.com/ip

Kiến trúc kỹ thuật & Câu hỏi thường gặp về API

Hiểu rõ cơ chế kiểm tra ngăn xếp giao thức /check, quy tắc an toàn null và cách tích hợp vào tập lệnh tự động hóa.

/check đưa ra phản hồi chuyển hướng HTTP 302 trực tiếp đến tên miền đầu dò trực tiếp ngăn xếp kép của chúng tôi (check_dns.myipdns.com). Bằng cách bỏ qua hoàn toàn các proxy ngược và mạng CDN, nhân hệ điều hành của chúng tôi trực tiếp kiểm tra gói tin TCP SYN gửi đến, ghi lại MTU, Window Scale và các tùy chọn TCP thực sự.

Nhằm ngăn ngừa sự sai lệch dữ liệu và gây nhầm lẫn cho các hệ thống phía dưới. Trong phân tích TCP, MTU bằng 0 là vô nghĩa, và việc tắt ECN hoàn toàn khác với việc chưa đo lường ECN (ví dụ: khi kết nối qua HTTP/3 QUIC). Các thông số chưa đo lường bắt buộc phải trả về null.

Sử dụng lệnh curl -sL 'https://myipdns.com/check?format=line' để phân tích dạng KEY=VALUE với các công cụ tiêu chuẩn như awk -F= '$1=="mtu"{print $2}' hoặc grep, hoặc dùng ?format=json kết hợp cùng công cụ jq.

Các yêu cầu đọc vượt quá 1 req/s (bùng nổ tối đa 5) sẽ nhận mã lỗi HTTP 429 kèm theo tiêu đề Retry-After. Các yêu cầu tạo liên kết chia sẻ vượt quá 5 lần/giờ/IP vẫn sẽ nhận dữ liệu chẩn đoán tiêu chuẩn HTTP 200 mà không kèm theo liên kết chia sẻ.

Ghi nhận đóng góp & Nguồn tham chiếu

Chúng tôi sử dụng các API bên thứ ba sau để xác minh các điểm xuất mạng.

AbuseIPDB Contributor Badge