Check-Host.cc

Документация API

Распределённая сетевая диагностика с более чем 65 глобальных узлов — Ping, MTR, DNS, HTTP, TCP и UDP — плюс метаданные хоста, WHOIS и исторические отчёты. Каждый эндпоинт ниже можно редактировать и запускать прямо в браузере на боевом API.

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
Для чего это?

Анонимного режима хватает в большинстве случаев. Действуют умеренные лимиты по IP и по цели — точные цифры в полной таблице на /about.

API-ключ (формат UUID) поднимает эти лимиты с месячной квотой на ключ. Ключи бесплатные — Check-Host некоммерческий проект, и лимиты существуют только для защиты от злоупотреблений, а не ради монетизации. Если у вас законный сценарий, превышающий анонимный уровень, напишите в поддержку.

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.

Конфиденциальность: ключ хранится только в localStorage вашего браузера на этой странице и отправляется только на api.check-host.cc.

Быстрый старт

Запуск проверки асинхронный: (1) делаете POST на мониторинговый эндпоинт и получаете UUID, (2) опрашиваете /report/{uuid}, пока все узлы не ответят. Большинство проверок укладывается в 1–10 секунд. Эндпоинты ниже сами делают polling, когда вы нажимаете Выполнить.

Шаблон 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 .

Запросы

эндпоинтов: 8

IP, геолокация, WHOIS и живой список узлов.

Глобальные проверки

эндпоинтов: 12

Отправляйте проверку Ping / TCP / UDP / HTTP / DNS / MTR с более чем 65 глобальных узлов — каждый вызов возвращает UUID и затем автоматически опрашивает /report/{uuid} за результатами.

Быстрые GET-ярлыки

Готовые URL для простых проверок — без выбора региона и Live-режима (для них используйте POST выше).

Network Intelligence

эндпоинтов: 3

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

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

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.

Отчёты

эндпоинтов: 3

Получайте JSON-отчёт или сгенерированные картинки статуса по ранее отправленной проверке.