Redirekto API: WHOIS, SSL, DNS, редиректы и реестр РКН

Redirekto — пять инструментов диагностики домена: кто и до какого числа держит домен, в порядке ли сертификат, куда смотрит DNS, как отрабатывают редиректы и не заблокирован ли сайт в России. На них ассистент Сейки строит разбор домена; через REST API те же проверки доступны вашим скриптам.

Инструмент	Эндпоинт	Что отвечает
WHOIS	`GET /v1/redirekto/whois`	регистратор, даты регистрации и окончания, NS, статусы, DNSSEC
Проверка SSL	`GET /v1/redirekto/ssl`	оценка A+…F с причинами, сертификат, TLS, HSTS, доверие к цепочке
DNS (dig)	`GET /v1/redirekto/dig`	цепочка CNAME, IP-адреса с геолокацией, NS
Тест редиректов	`GET /v1/redirekto/tester`	каждый шаг цепочки: код, сервер, `Location`, заголовки, время
Реестр РКН	`GET /v1/redirekto/rkn`	записи о блокировке домена, URL или IP и пересечения по IP

Один запрос и пакет

У каждого инструмента два вызова с одинаковыми параметрами:

GET — одна проверка, параметры в query-строке, в ответе — один объект результата.
POST — пакет: тело — JSON-массив из 1–25 объектов с теми же полями, что и query-параметры GET; в ответе — массив результатов в том же порядке.

curl https://proxy.seyka.ru/v1/redirekto/whois \
  -H "Authorization: Bearer $SEYKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[{"domain": "seyka.ru"}, {"domain": "example.com"}]'

[
  { "domain": "seyka.ru", "registrar": "...", "queryTimeMs": 412 },
  { "domain": "example.com", "registrar": "...", "queryTimeMs": 388 }
]

Элементы пакета проверяются независимо: если один домен не ответил, его результат придёт с полем error (в тесте редиректов — шагом с кодом 0), остальные — как обычно. Исключение — вход, который сервис не принимает вовсе: URL без http:///https:// в тесте редиректов, запрос длиннее 500 символов в реестре РКН или пустая строка в обязательном поле отклоняют весь пакет кодом 502. Пакет оплачивается поэлементно — как столько же отдельных GET, включая элементы с error: бесплатен только ответ с HTTP-ошибкой. Больше 25 элементов — 413, пустой массив или лишнее поле в элементе — 422.

Пакетные вызовы: POST /v1/redirekto/whois, POST /v1/redirekto/ssl, POST /v1/redirekto/dig, POST /v1/redirekto/tester, POST /v1/redirekto/rkn.

Ошибки

Результат проверки — даже неудачной — приходит с кодом 200: «домен не найден», «сертификат истёк», «нет DNS-записей» — это ответ, а не ошибка. Смотрите на поле error и на поля самого результата.

Код 502 означает, что источник не дал результата вовсе. Так же — 502 без подробностей в теле — выглядят:

адрес во внутренней сети или IP-адрес в числовой записи (2130706433, 0x7f000001) в GET проверки SSL и теста редиректов (в пакете — ошибка этого элемента);
вход, который сервис счёл некорректным (например, URL без http:///https:// в тесте редиректов).

Нарушение схемы запроса (нет обязательного параметра, port вне 1–65535, limit вне 1–20) — 422. Все коды — на странице Ошибки.

Кэш

Проверка SSL и реестр РКН кэшируют ответы: повторный такой же запрос в пределах окна кэша бесплатен. Попадание в кэш видно по заголовку X-Cache: HIT; заголовок Cache-Control: no-cache заставляет выполнить проверку заново. Подробнее — в разделе Кэш ответов.

Цена

Каждая проверка — отдельный вызов; пакет — по числу элементов. Цены и окна кэша — в таблице цен.