Check-Host.cc

API-Dokumentation

Verteilte Netzwerkdiagnose von 65+ globalen Knoten — Ping, MTR, DNS, HTTP, TCP und UDP — sowie Host-Metadaten, WHOIS und historische Prüfberichte. Jeder Endpunkt unten ist bearbeitbar und direkt im Browser ausführbar gegen die Live-API.

Wofür ist das?

Anonym funktioniert für die meisten Fälle. Es gelten konservative Rate-Limits pro IP und pro Ziel — siehe die vollständige Tabelle auf /about, wenn du die genauen Zahlen brauchst.

Ein API-Schlüssel (UUID-Format) erhöht diese Limits mit einer monatlichen Quote pro Schlüssel. Schlüssel sind kostenlos — Check-Host ist ein Non-Profit-Projekt, und die Limits dienen nur dem Missbrauchsschutz, nicht der Monetarisierung. Wenn du einen legitimen Anwendungsfall hast, der die anonyme Stufe übersteigt, melde dich beim Support.

Datenschutz: Der Schlüssel bleibt ausschließlich im localStorage deines Browsers auf dieser Seite und wird nur an api.check-host.cc gesendet.

Schnellstart

Eine Prüfung läuft asynchron: (1) POST an einen Monitoring-Endpunkt, um eine UUID zu erhalten, (2) /report/{uuid} abfragen, bis jeder Knoten geantwortet hat. Die meisten Prüfungen sind in 1–10 Sekunden fertig. Die Endpunkte unten machen das automatisch, wenn du auf Ausführen klickst.

Polling-Muster (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 .

Abfragen

7 Endpunkte

IP, Geolokation, WHOIS und die Live-Knotenliste.

Globale Prüfungen

11 Endpunkte

Verteile eine Ping- / TCP- / UDP- / HTTP- / DNS- / MTR-Prüfung über 65+ globale Knoten — jeder Aufruf liefert eine UUID und fragt anschließend automatisch /report/{uuid} nach Ergebnissen ab.

GET-Kurzbefehle

Drop-in-URLs für einfache Prüfungen — kein Region-Targeting, kein Live-Modus (für beides POST oben verwenden).

Berichte

3 Endpunkte

Hole den JSON-Bericht oder gerenderte Statusbilder für eine zuvor gestartete Prüfung ab.