Check-Host.cc

Tài liệu API

Chẩn đoán mạng phân tán từ hơn 65 node toàn cầu — Ping, MTR, DNS, HTTP, TCP và UDP — kèm metadata host, WHOIS và báo cáo kiểm tra cũ. Mọi endpoint bên dưới đều có thể chỉnh sửa và chạy thẳng trong trình duyệt trên API thật.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
Cái này để làm gì?

Dùng ẩn danh là đủ cho hầu hết trường hợp. Có rate limit vừa phải theo IP và theo target — cần con số chính xác thì xem bảng đầy đủ ở /about.

API key (định dạng UUID) sẽ nâng các giới hạn đó kèm hạn ngạch hàng tháng cho từng key. Key miễn phí — Check-Host là dự án phi lợi nhuận, và giới hạn chỉ để ngăn lạm dụng, không phải để kiếm tiền. Nếu nhu cầu hợp lệ vượt mức ẩn danh, hãy liên hệ hỗ trợ.

Riêng tư: key chỉ nằm trong localStorage trên trình duyệt của bạn ở trang này, và chỉ được gửi tới api.check-host.cc.

Bắt đầu nhanh

Gửi kiểm tra là bất đồng bộ: (1) POST tới một endpoint monitoring để lấy UUID, (2) poll /report/{uuid} đến khi tất cả các node đã phản hồi. Phần lớn kiểm tra xong trong 1–10 giây. Các endpoint bên dưới tự poll khi bạn bấm Chạy.

Mẫu polling (bash) 
# 1. Dispatch a check, capture the UUID
UUID=$(curl -s -X POST https://api.check-host.cc/ping \
  -H 'Content-Type: application/json' \
  -d '{"target":"check-host.cc","region":["DE"]}' | jq -r .uuid)

# 2. Poll until at least one node has reported
until curl -s "https://api.check-host.cc/report/$UUID" \
  | jq -e '.data | length >= 1' > /dev/null; do sleep 1; done

curl -s "https://api.check-host.cc/report/$UUID" | jq .

Tra cứu

7 endpoint

IP, vị trí địa lý, WHOIS và danh sách node trực tiếp.

Kiểm tra toàn cầu

11 endpoint

Gửi kiểm tra Ping / TCP / UDP / HTTP / DNS / MTR từ hơn 65 node toàn cầu — mỗi lần gọi trả về UUID, sau đó tự poll /report/{uuid} để lấy kết quả.

Lối tắt GET nhanh

URL sẵn dùng cho kiểm tra đơn giản — không có chọn khu vực, không Live mode (dùng POST ở trên cho mấy thứ đó).

Báo cáo

3 endpoint

Lấy báo cáo JSON hoặc ảnh trạng thái đã render của một kiểm tra đã gửi trước đó.