Check-Host.cc

Dokumentacja API

Rozproszona diagnostyka sieci z ponad 65 globalnych węzłów — Ping, MTR, DNS, HTTP, TCP i UDP — plus metadane hosta, WHOIS i historyczne raporty. Każdy endpoint poniżej jest edytowalny i wykonywalny w przeglądarce wobec produkcyjnego API.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
Do czego to służy?

Anonimowo wystarczy w większości przypadków. Obowiązują rozsądne limity per IP i per cel — pełna tabela na /about, jeśli potrzebujesz dokładnych liczb.

Klucz API (format UUID) zwiększa te limity z miesięcznym przydziałem na klucz. Klucze są darmowe — Check-Host to projekt non-profit, a limity istnieją tylko po to, żeby zapobiegać nadużyciom, nie po to, żeby zarabiać. Jeśli masz uzasadniony przypadek przekraczający poziom anonimowy, odezwij się do wsparcia.

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.

Prywatność: klucz żyje wyłącznie w localStorage Twojej przeglądarki na tej stronie i jest wysyłany tylko do api.check-host.cc.

Szybki start

Wysłanie sprawdzenia jest asynchroniczne: (1) POST do endpointu monitorującego, żeby dostać UUID, (2) odpytuj /report/{uuid}, aż każdy węzeł odpowie. Większość sprawdzeń kończy się w 1–10 sekund. Endpointy poniżej robią polling za Ciebie po kliknięciu Wykonaj.

Wzorzec pollingu (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 .

Zapytania

8 endpointów

IP, geolokalizacja, WHOIS i lista węzłów na żywo.

Globalne sprawdzenia

12 endpointów

Wyślij sprawdzenie Ping / TCP / UDP / HTTP / DNS / MTR z ponad 65 globalnych węzłów — każde wywołanie zwraca UUID i potem automatycznie odpytuje /report/{uuid} po wyniki.

Szybkie skróty GET

Gotowe URL-e do prostych sprawdzeń — bez celowania regionalnego ani trybu Live (od tego POST powyżej).

Network Intelligence

3 endpointów

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ów

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ów

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.

Raporty

3 endpointów

Pobierz raport JSON lub wyrenderowane obrazy statusu wcześniej wysłanego sprawdzenia.