Поиск доменов .RU, .РФ, .SU и доменов третьего уровня
В заголовке запроса необходимо указать значения 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 для домена заполнены. В противном случае отображаются данные из анкеты.
Порядок следования полей в запросе произвольный в пределах каждого блока. Многострочные поля записываются в несколько строк, при этом в начале каждой строки присутствует название поля и разделитель (двоеточие). Для однострочных полей повторение не допускается. Необязательные поля могут либо отсутствовать в блоке, либо их значение может быть пустым (состоящим из пробельных символов).
Ответ содержит заголовок (см. формат заголовка ответа) и тело ответа, которое отделяется от заголовка пустой строкой.
В случае успешного выполнения запроса (код 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 для домена заполнены. В противном случае отображаются данные из анкеты.