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.

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

7 endpoints

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

Checks globaux

11 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).

Rapports

3 endpoints

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