Поиск доменов .RU, .РФ, .SU и доменов третьего уровня

Пример запроса:

lang: ru
login:123/NIC-REG/adm
password:QWERTY
request:domain
operation:search
request-id:20011220103455.12345@nic.ru

[domain]
first:1
limit:50
client: 3457/NiC-D
domain:*.SU
nameservers:ns3.nic.ru*
testing-nservers:*
switch:ON/OFF
status:delegated/not delegated
created-start:01.01.2008
created-end:31.01.2008
end-date-start:08.02.2008
end-date-end:28.02.2008
e-mail:sidor@test.my-provider.ru
phone:+7 495 1234567
fax-no:+7 495 1234568

В заголовке запроса необходимо указать значения request:domain и operation:search (см. описание формата заголовка запроса).

После заголовка запроса следует блок domain, в котором следует задать данные для поиска. Поиск осуществляется с логикой "и" для перечисленных полей. Блок начинается заголовком, указанным в квадратных скобках в отдельной строке.

Блок [domain] может состоять из следующих полей:

  • first
    Порядковый номер блока с данными о доменах, начиная с которого (из числа найденных в базе данных) блоки будут выдаваться в ответе. Для постраничной выдачи доменов в вашем интерфейсе, если на каждой странице отображается по 10 доменов, для первой страницы это поле нужно устанавливать равным 1, для второй - 11, для третей - 21, и так далее. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 1). Однострочное поле.
  • limit
    Количество блоков с данными о доменах, выдаваемых в ответе. В случае если вы печатаете результаты ответа на странице, то значение этого поля можно установить, например, 10 - база данных будет выдавать по 10 услуг, и на странице вашего интерфейса будет отображаться по 10 строк. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию выдается полный список). Однострочное поле.
  • client
    Номер анкеты клиента, для которого был заказан домен. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • domain
    Домен, поиск которого производится. Поле может содержать латинские буквы, цифры, дефисы, точку и символ "*". "*" заменяет группу символов (ноль и более). Доменное имя на национальном языке должно быть указано в виде XN--***.SU. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • nameservers
    Поле может содержать латинские буквы, цифры, точку и символ "*". Для исключения из поиска доменов с пустыми DNS-серверами поставьте "*". Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • testing-nservers
    Поле может содержать латинские буквы, цифры, точку и символ "*". Для поиска только доменов, которые тестируются на данный момент, поставьте "*". Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • switch
    Индикатор выключателя услуги. Если услуга выключена клиентом или партнером, то значение этого поля будет OFF, если включена - ON. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • status
    Индикатор статуса услуги. Если домен делегирован, то значение этого поля будет delegated, если не делегирован - not delegated. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • created-start
    Домен зарегистрирован не раньше этой даты. В формате DD.MM.YYYY, где YYYY - год, MM - месяц, DD - число. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • created-end
    Домен зарегистрирован не позже этой даты. В формате DD.MM.YYYY, где YYYY - год, MM - месяц, DD - число. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Однострочное поле.
  • end-date-start
    Срок регистрации домена заканчивается не раньше этой даты. В формате DD.MM.YYYY, где YYYY - год, MM - месяц, DD - число. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Если поле заполнено, то домены, которые зарегистрированы в текущий день, в поиске не выводятся. Однострочное поле.
  • end-date-end
    Срок регистрации домена заканчивается не позже этой даты. В формате DD.MM.YYYY, где YYYY - год, MM - месяц, DD - число. Необязательное поле (в случае отсутствия производится поиск всех доменов .RU, .РФ, .SU). Если поле заполнено, то домены, которые зарегистрированы в текущий день, в поиске не выводятся. Однострочное поле.
  • e-mail
    phone
    fax-no
    Контактная информация для отображения через Whois-сервис.
    Поля могут быть пустыми. Указанные данные отображаются в ответах Whois-сервиса только в том случае, если поля phone, e-mail и fax-no для домена заполнены. В противном случае отображаются данные из анкеты.

Порядок следования полей в запросе произвольный в пределах каждого блока. Многострочные поля записываются в несколько строк, при этом в начале каждой строки присутствует название поля и разделитель (двоеточие). Для однострочных полей повторение не допускается. Необязательные поля могут либо отсутствовать в блоке, либо их значение может быть пустым (состоящим из пробельных символов).

Пример ответа:

State: 200 OK
request-id:20011220103455.12345@nic.ru

[domain-list]
domains-found:1

[domain]
domain:TEST.RU
switch:ON
nameservers:ns3.nic.ru.
nameservers:ns4.nic.ru.
testing-nservers:
autoprolong:0
descr: test domain!
status:delegated
created:01.01.2008
end-date:08.02.2008
e-mail:sidor@test.my-provider.ru
phone:+7 495 1234567
fax-no:+7 495 1234568

Ответ содержит заголовок (см. формат заголовка ответа) и тело ответа, которое отделяется от заголовка пустой строкой.

В случае успешного выполнения запроса (код 200) в теле ответа содержится блок domain-list, содержащий служебную информацию о результатах поиска, а также блоки domain c данными по найденным доменам.

Блок [domain-list] содержит следующие поля:

  • domains-found
    Количество доменов, найденных по запросу в базе данных.

В блоках [domain] содержатся следующие поля, общие для всех доменов:

  • domain
    Домен, поиск которого производится.
  • nameservers
    DNS-сервера домена в формате имя_сервера - пробел - IP-адреса через запятую.
  • testing-nservers
    В том случае если DNS-сервера домена были изменены и в данный момент производится их тестирование, в этом поле отображаются новые DNS-сервера, в то время как в поле nameservers - старые. В остальных случаях это поле не выводится
  • switch
    Индикатор выключателя услуги. Если услуга выключена клиентом или партнером, то значение этого поля будет OFF, если включена - ON.
  • status
    Индикатор статуса услуги. Если домен делегирован, то значение этого поля будет delegated, если не делегирован - not delegated.
  • descr
    Описание домена в свободной текстовой форме, выдаваемое через Whois-сервис.
  • created
    Дата последнего создания домена в RU-CENTER. В формате DD.MM.YYYY, где YYYY - год, MM - месяц, DD - число.
  • end-date
    Дата, по которую оплачен домен. В формате DD.MM.YYYY, где YYYY - год, MM - месяц, DD - число.
  • autoprolong
    Возможные значения: 1 - режим автоматического продления услуги включен. 0 - режим автоматического продления услуги выключен.
  • e-mail
    phone
    fax-no
    Контактная информация для отображения через Whois-сервис.
    Поля могут быть пустыми. Указанные данные отображаются в ответах Whois-сервиса только в том случае, если поля phone, e-mail и fax-no для домена заполнены. В противном случае отображаются данные из анкеты.

Всё ещё остались вопросы?