WHOIS API: регистратор, даты и NS домена

GET /v1/redirekto/whois запрашивает WHOIS домена и разбирает ответ в единый формат: регистратор, даты регистрации, обновления и окончания, NS-серверы, статусы, DNSSEC и владелец. Работает и для зон .ru/.рф (поля paid-till, free-date, org/person), и для ICANN-зон (.com, .org и другие).

Параметры

Параметр	Тип	Обязательный	Описание
domain	string	да	домен; протокол, путь и порт отбрасываются, кириллический домен переводится в punycode

curl -G https://proxy.seyka.ru/v1/redirekto/whois \
  -H "Authorization: Bearer $SEYKA_API_KEY" \
  --data-urlencode "domain=seyka.ru"

Ответ

{
  "domain": "seyka.ru",
  "registrar": "RU-CENTER-RU",
  "createdDate": "2024-03-11T09:12:44Z",
  "expiryDate": "2027-03-11T09:12:44Z",
  "freeDate": "2027-04-11",
  "nameServers": ["ns3-l2.nic.ru.", "ns4-l2.nic.ru."],
  "status": ["REGISTERED, DELEGATED, VERIFIED"],
  "admin": "Private Person",
  "adminContact": "https://www.nic.ru/whois",
  "queryTimeMs": 412
}

Поле	Описание
domain	домен, как его запрашивали у WHOIS (для кириллического — в punycode)
domainDisplay	исходное написание, если оно отличается от domain (кириллица)
registrar, registrarUrl	регистратор и его сайт
createdDate, updatedDate, expiryDate	даты регистрации, последнего обновления и окончания — строками в формате реестра
freeDate	дата освобождения домена (зоны .ru/.рф)
nameServers	NS-серверы из записи, в нижнем регистре, без повторов (в записанном реестром виде, у .ru — с точкой на конце)
status	статусы домена: у ICANN-зон — по одному на элемент (clientTransferProhibited), у .ru/.рф — строка state целиком
dnssec	состояние DNSSEC, как его отдаёт реестр
admin	владелец: организация, если указана, иначе имя
adminContact	ссылка для связи с владельцем (зоны .ru/.рф)
queryTimeMs	время запроса, мс
error	причина, если WHOIS не удалось получить

Отсутствующее в ответе реестра поле в результат не попадает: WHOIS разных зон отдаёт разный набор данных, а многие регистраторы скрывают владельца.

Пакетный запрос

POST /v1/redirekto/whois принимает массив из 1–25 объектов {"domain": "…"} и возвращает массив результатов в том же порядке:

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"}]'

Общие правила пакетов — в обзоре Redirekto.

Поведение и ограничения

• На запрос к WHOIS-серверу отводится 10 секунд; если он не ответил, результат придёт с error.
• Домен с недопустимыми символами (пробелы, управляющие символы) не отправляется в WHOIS: результат — с "error": "Invalid domain format", код ответа 200.
• Ошибка WHOIS-сервера или таймаут — это тоже 200 с полем error; код 502 означает, что сервис не дал ответа вовсе. Коды — на странице Ошибки.

Цена

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