Check-Host.cc

Documentation de l'API

Diagnostic réseau distribué depuis plus de 65 nœuds globaux — Ping, MTR, DNS, HTTP, TCP et UDP — ainsi que les métadonnées d'hôte, WHOIS et rapports historiques. Chaque endpoint ci-dessous est modifiable et exécutable dans votre navigateur contre l'API en production.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
À quoi ça sert ?

L'usage anonyme suffit dans la plupart des cas. Des limites raisonnables par IP et par cible s'appliquent — voir le tableau complet sur /about si vous voulez les chiffres exacts.

Une clé API (au format UUID) relève ces limites avec un quota mensuel par clé. Les clés sont gratuites — Check-Host est un projet à but non lucratif et les limites n'existent que pour empêcher les abus, pas pour monétiser. Si vous avez un cas d'usage légitime qui dépasse le niveau anonyme, contactez le support.

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.

Vie privée : la clé reste uniquement dans le localStorage de votre navigateur sur cette page et n'est envoyée qu'à api.check-host.cc.

Démarrage rapide

Lancer un check est asynchrone : (1) POST sur un endpoint de monitoring pour obtenir un UUID, (2) interrogez /report/{uuid} jusqu'à ce que chaque nœud ait répondu. La plupart des checks aboutissent en 1 à 10 secondes. Les endpoints ci-dessous font le polling pour vous quand vous cliquez sur Exécuter.

Schéma de 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 .

Recherches

8 endpoints

IP, géolocalisation, WHOIS et la liste des nœuds en direct.

Checks globaux

12 endpoints

Lancez un check Ping / TCP / UDP / HTTP / DNS / MTR depuis plus de 65 nœuds globaux — chaque appel renvoie un UUID, puis fait du polling automatique sur /report/{uuid}.

Raccourcis GET rapides

URLs prêtes à l'emploi pour des checks simples — pas de ciblage par région ni de mode live (utilisez POST ci-dessus pour cela).

Network Intelligence

3 endpoints

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 endpoints

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 endpoints

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.

Rapports

3 endpoints

Récupérez le rapport JSON ou les images de statut rendues pour un check déjà lancé.