Check-Host.cc

Documentação da API

Diagnóstico de rede distribuído a partir de mais de 65 nós globais — Ping, MTR, DNS, HTTP, TCP e UDP — além de metadados de host, WHOIS e relatórios históricos. Cada endpoint abaixo é editável e executável no seu navegador contra a API ao vivo.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
Para que serve isto?

O uso anônimo cobre a maioria dos casos. Limites moderados por IP e por destino se aplicam — consulte a tabela completa em /about se precisar dos números exatos.

Uma chave API (formato UUID) eleva esses limites com uma cota mensal por chave. As chaves são gratuitas — Check-Host é um projeto sem fins lucrativos, e os limites existem só para prevenir abuso, não para monetizar. Se você tem um caso legítimo que excede o nível anônimo, entre em contato com o suporte.

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.

Privacidade: a chave fica apenas no localStorage do seu navegador nesta página e só é enviada para api.check-host.cc.

Início rápido

Disparar uma checagem é assíncrono: (1) POST num endpoint de monitoramento para receber um UUID, (2) faça poll em /report/{uuid} até cada nó ter respondido. A maioria das checagens completa em 1–10 segundos. Os endpoints abaixo já fazem o polling automaticamente quando você clica em Executar.

Padrão 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 .

Consultas

8 endpoints

IP, geolocalização, WHOIS e a lista de nós ao vivo.

Checagens globais

12 endpoints

Dispare uma checagem Ping / TCP / UDP / HTTP / DNS / MTR a partir de mais de 65 nós globais — cada chamada devolve um UUID e depois faz poll automático em /report/{uuid}.

Atalhos GET rápidos

URLs prontas para checagens simples — sem seleção de região nem modo ao vivo (use POST acima para isso).

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.

Relatórios

3 endpoints

Recupere o relatório JSON ou imagens de status renderizadas de uma checagem já disparada.