API địa chỉ IP và endpoint dòng lệnh

curl checkmyip.com/raw
203.0.113.42

Đó là toàn bộ API cho hầu hết nhu cầu: một yêu cầu, địa chỉ, một dấu xuống dòng. curl -4 và curl -6 ép một họ địa chỉ; curl checkmyip.com/json trả về các chi tiết bên dưới. Bất kỳ client nào gửi Accept: text/plain hoặc User-Agent dạng dòng lệnh đều nhận địa chỉ trần từ /raw; trình duyệt nhận trang cho người đọc.

Mọi endpoint đều trả lời qua HTTPS với CORS bật cho mục đích chỉ đọc, gửi Cache-Control: no-store, và được đánh dấu noindex với công cụ tìm kiếm. Kết quả cho các địa chỉ khác được lưu đệm mười phút.

ip — địa chỉ dạng chuỗi. version — 4 hoặc 6. geo.consensus — country (ISO 3166-1 alpha-2), region, city, lat, lon, timezone, confidence (0–1), disagreement (boolean), anycast (boolean); geo.sources[] — câu trả lời của từng cơ sở dữ liệu kèm updated, licence và attribution. network — asn, as_name, as_org, prefix, rir, allocation_date, registry_country, abuse_contacts[]. hostname — tên PTR hoặc null. type.type — residential, mobile, business, datacenter hoặc unknown, kèm confidence và reasons[]. risk — is_proxy, is_vpn, is_tor, is_datacenter, is_relay, score (0–100), level, reasons[], blacklists[] và score_version. Giá trị thiếu là null kèm lý do trong status hoặc note; các kết luận heuristic được ghi rõ là vậy. Các chuỗi ghi công phải được hiển thị nếu bạn hiển thị dữ liệu định vị cho người dùng (điều kiện CC BY 4.0 / CC BY-SA 4.0).

Mỗi ví dụ in ra địa chỉ công khai của máy mà nó chạy trên đó.

#!/bin/sh
# báo khi IP công khai thay đổi (chạy từ cron mỗi 5 phút)
new=$(curl -fsS --max-time 5 https://checkmyip.com/raw) || exit 0
old=$(cat /var/tmp/public-ip 2>/dev/null)
[ "$new" != "$old" ] && { echo "$new" > /var/tmp/public-ip; logger "public IP changed: $old -> $new"; }

Hãy dùng --max-time, coi một lần thất bại là không rõ thay vì đã đổi, và đừng hỏi thường xuyên hơn một lần mỗi phút.

/raw, /ip, /ip.txt, /json, /json?ip= và các host /ip theo họ địa chỉ cho phép 600 yêu cầu mỗi phút cho mỗi địa chỉ; công cụ check port cho phép 20 mỗi phút và chỉ kiểm tra địa chỉ của chính người gọi. Vượt giới hạn trả về HTTP 429 kèm phần thân lỗi JSON. Các endpoint miễn phí cho mục đích cá nhân, nội bộ và thương mại trong các giới hạn này; nếu bạn dự kiến lưu lượng liên tục cao hơn, hoặc muốn nhúng dữ liệu của chúng tôi vào một sản phẩm, hãy báo trước qua trang liên hệ. Vui lòng đừng dùng các trang cho người đọc từ script — chúng nặng và chậm hơn các endpoint ở trên.

Các endpoint chạy trên cùng mạng biên với trang và được giám sát liên tục; endpoint /healthz của máy chủ kiểm tra báo phiên bản và thời gian hoạt động của nó. Một trang trạng thái công khai đang được lên kế hoạch. Thay đổi về định dạng phản hồi được thông báo trước trên trang này; các trường hiện có không bao giờ bị đổi tên, chỉ được thêm.