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ợ.

Send the key as an Authorization: Bearer <key> header — the code samples below fill this in for you. For backward compatibility an apikey field in a POST body is still accepted; passing it in the URL query string is not.

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

8 endpoint

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

Kiểm tra toàn cầu

12 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ứ đó).

Network Intelligence

3 endpoint

Dispatch deep, multi-stage scans (port + banner + body + TLS + threat-intel) of an IP, CIDR, domain or ASN. Asynchronous: submit, then poll the status endpoint. Open to guests, with per-IP and per-target hourly quotas.

Intelligence Data

8 endpoint

Read the aggregated intelligence we already hold for an entity — the same data that powers the /ip, /as, /domain … pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Geo Intelligence

4 endpoint

Country, TLD and continent-level aggregates plus the global threat feed — the same data that powers the /country, /tld, /continent and /threats pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

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 đó.