Публичный API

REST API доступен без регистрации: база — /api/v1, формат — JSON. Без ключа действует лимит на IP-адрес (по умолчанию 20 запросов в минуту и 200 в сутки, настраивается администратором) и капча после нескольких проверок. С бесплатным API-ключом — повышенные лимиты (по умолчанию 60/мин и 2000/сутки) и без капчи: подайте заявку →

API-ключ

Ключ выдаётся после одобрения заявки администратором. Подача — на странице /api-keys; нужен только контакт (email или Telegram) и пара слов о задаче. Статус заявки проверяется там же по номеру заявки; после одобрения ключ начинает работать автоматически.

Ключ передаётся в каждом запросе одним из двух заголовков:

Authorization: Bearer nck_xxxxxxxxxxxx...
X-API-Key: nck_xxxxxxxxxxxx...

Держите ключ в секрете: он даёт ваши повышенные лимиты. Скомпрометированный ключ администратор может отозвать. Проверить свой ключ: GET /api/v1/me — вернёт статус, лимиты и время последнего использования.

Создать проверку

POST/api/v1/checks

{
  "type": "ping",            // ping | http | tcp | dns | ssl | traceroute | whois | portscan
  "target": "example.com",   // хост, IP или URL (для http)
  "params": {
    "port": 443,             // для tcp и ssl
    "ports": [80, 443],      // для portscan (до 8 из белого списка)
  },
  "maxNodes": 5              // сколько узлов использовать (по умолчанию — настройка сервера)
}

Ответ 201: объект с id — используйте его для получения результата. Список выбранных узлов возвращается в поле nodes. С ключом капча не запрашивается: поля captchaId/captchaAnswer можно не передавать.

Получить результат

GET/api/v1/checks/{id}

{
  "id": "aBc123XyZ456",
  "type": "ping",
  "target": "8.8.8.8",
  "status": "done",          // pending | done
  "createdAt": "2026-09-27T10:00:00.000Z",
  "results": [
    {
      "nodeId": "local-1",
      "node": { "name": "Встроенный узел", "flag": "🏠", "city": "—", "country": "Локальный сервер" },
      "status": "success",   // success | error | pending | running
      "timeMs": 42,
      "data": { "packets": { "sent": 4, "received": 4, "lossPercent": 0 }, "rtt": { "min": 17, "avg": 17, "max": 17 } },
      "error": null
    }
  ]
}

Опрашивайте этот адрес раз в 1–2 секунды, пока status не станет done.

Мгновенные инструменты

Быстрые справочные методы отдают ответ сразу, без очереди и узлов:

GET/api/v1/tools/{тип}?target={цель}

где {тип} — один из: bgp, ipinfo, subdomains, virus, cms, hosting, spam, owner (владелец домена по WHOIS/RDAP), reverseip (сайты на том же сервере). Например: /api/v1/tools/ipinfo?target=8.8.8.8.

Без ключа — 30 запросов в минуту на IP и капча (если включена защита инструментов). С ключом — общий лимит ключа, капчи нет.

Справочные методы

GET/api/v1/nodes

Список онлайн-узлов проверки.

GET/api/v1/stats

Общая статистика: узлы и количество проверок.

GET/api/v1/me

Информация о вашем API-ключе: статус, лимиты, последнее использование. Требует заголовок с ключом.

Типы проверок

Тип	Назначение	Параметры	Ограничения
ping	ICMP-доступность, потери, RTT	—	4 пакета, хост не из приватных сетей
http	HTTP(S)-запрос: код, TTFB, редиректы, TLS	—	только http/https, до 5 редиректов
tcp	Доступность TCP-порта	port	порт 1–65535
dns	DNS-записи домена	type: A\|AAAA\|MX\|NS\|TXT\|CNAME\|SOA\|ALL	только доменные имена
ssl	Сертификат TLS	port (по умолчанию 443)	—
traceroute	Маршрут до хоста	maxHops (до 15)	выполняется до ~35 секунд
whois	Данные WHOIS домена	—	только домены, не IP
portscan	Проверка набора портов	ports	до 8 портов из белого списка

Коды ошибок

400 validation_failed — некорректный адрес или параметры (включая SSRF-защиту: приватные адреса запрещены);
400 check_disabled — инструмент отключён администратором;
401 invalid_api_key — ключ не найден или не передан;
403 api_key_pending — заявка ещё не одобрена; 403 api_key_revoked — ключ отозван;
404 not_found — проверка не найдена или удалена по истечении срока хранения;
428 captcha_required — нужен ответ на капчу (только для запросов без ключа);
429 rate_limited — превышен лимит запросов, в заголовке Retry-After — сколько секунд ждать;
503 no_nodes_online — нет доступных узлов.