Поиск действующих услуг

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

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

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

• service
  Тип услуг, поиск которых производится (см. значения полей service и template). Необязательное поле (в случае отсутствия производится поиск услуг всех типов). Однострочное поле.
• domain
  Имя домена, для которого производится поиск услуг. Поле может содержать латинские буквы, цифры, дефисы, точку и символ "звездочку" (*). "Звездочка" заменяет группу символов (ноль и более). Доменное имя на национальном языке должно быть указано в виде XN--***.SU. Необязательное поле. Однострочное поле.
• service-objects-limit
  Количество блоков с данными об услугах, выдаваемых в ответе. В случае, если вы печатаете результаты ответа на странице, то значение этого поля можно установить например в 10 - база данных будет выдавать по 10 услуг, и на странице вашего интерфейса будет отображаться по 10 строк. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 10). Однострочное поле.
• service-objects-first
  Порядковый номер блока с данными об услугах, начиная с которого (из числа найденных в базе данных) блоки будут выдаваться в ответе. Для постраничной выдачи услуг в вашем интерфейсе, если на каждой странице отображается по 10 услуг, для первой страницы это поле нужно устанавливать равным 1, для второй - 11, для третей - 21, и так далее. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 1). Однострочное поле.
• object-only
  Ключ оптимизации полноты/скорости выдаваемых данных. Может принимать два значения: 0 и 1. Если значение установлено в 1, то выдаются только те данные, которые касаются объекта услуг, а поля service-id, payed-till, end-date не выводятся. Такой запрос обрабатывается базой данных в несколько раз быстрее. Это может оказаться полезным, если требуется получить информацию по большому количеству объектов в одном запросе. Если же значение этого поля установлено в 0, то в ответе выдаются все перечисленные ниже поля. Необязательное поле (по умолчанию его значение равно 0). Однострочное поле.

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

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

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

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

• service-objects-found
  Количество услуг, найденных по запросу в базе данных.
• service-objects-limit
  Количество услуг, выданных по запросу. Соответствует затребованному количеству выдаваемых услуг.
• service-objects-first
  Порядковый номер услуги, начиная с которой (из числа найденных в базе данных) осуществляется выдача. Соответствует затребованному порядковому номеру начальной услуги.

В блоках [service-object] содержатся следующие поля, общие для всех услуг:

• subject-contract
  Номер анкеты клиента, для которого была заказана услуга.
• object
  Тип объекта услуги (см. значения полей service и template).
• service
  Тип услуги. Совпадает с типом объекта услуги во всех случаях кроме специальных услуг (ручное заполнение анкеты и формы заказа), которые для партнеров не оказываются (см. значение полей service в ответах).

  ВАЖНО: При поиске действующих услуг для доменов .COM, .NET, .ORG, .BIZ, .INFO начиная с 15 августа 2011 вместо значения domain_rrp можно указывать значение, соответствующее расширению домена:

  • domain_epp_com для доменов .COM,
  • domain_epp_net для доменов .NET,
  • domain_epp_org для доменов .ORG,
  • domain_epp_biz для доменов .BIZ,
  • domain_epp_info для доменов .INFO.
• service-id
  Внутренний идентификатор услуги в базе данных. Служебное поле.
• service-state
  Состояние услуги:
  0 - услуга предоставляется
  1 - услуга временно не предоставляется
  2 - услуга никогда больше не будет предоставляться
  6 - Redemption для доменов .NET, .COM, .ORG, .BIZ, .INFO, .CC, .TV, .ME, .TEL, .MOBI, .NAME, .AG, .BZ, .MN, .LC, .SC, .VC (для домена инициирована процедура удаления в реестре)
• contract-id
  Внутренний идентификатор договора, к которому прикреплена услуга. Служебное поле.
• payed-till
  Дата, по которую оплачена услуга (включительно) в формате DD.MM.YYYY.
  Примечание. В день регистрации домена или создания новой услуги поле payed-till пустое.
• multiplier
  Число периодов, на которое заказана услуга. Поле может содержать следующие значения:
  от 1 до 10 - количество лет для международных и зарубежных национальных доменов
  1, 3, 6, 12 - количество месяцев для хостинга
  1 - 1 год для остальных услуг.
• end-date
  Дата окончания действия услуги в формате DD.MM.YYYY. Обычно совпадает с датой, по которую оплачена услуга, кроме случаев, когда дополнительная услуга для домена заказываются отдельно после регистрации домена. В этом случае датой окончания действия дополнительной услуги будет дата окончания делегирования домена, если не заказана услуга продления регистрации домена на очередной период.
• switch
  Индикатор выключателя услуги. Если услуга выключена клиентом или партнером, то значение этого поля будет OFF, если включена - ON.
• object-state
  Состояние объекта услуги. Может принимать одно из следующих значений:

  object	object-state	Информация о состоянии услуги
  domain_ru	Delegated	Домен зарегистрирован и делегирован
  	Not delegated	Домен зарегистрирован, но не делегирован
  domain_rf	Delegated	Домен зарегистрирован и делегирован
  	Not delegated	Домен зарегистрирован, но не делегирован
  domain_su	Delegated	Домен зарегистрирован и делегирован
  	Not delegated	Домен зарегистрирован, но не делегирован
  domain_abkhazia_su domain_adygeya_ru domain_adygeya_su domain_aktyubinsk_su domain_arkhangelsk_su domain_armenia_su domain_ashgabad_su domain_azerbaijan_su domain_balashov_su domain_bashkiria_ru domain_bashkiria_su domain_bir_ru domain_bryansk_su domain_cbg_ru domain_chimkent_su domain_dagestan_ru domain_dagestan_su domain_east_kazakhstan_su domain_exnet_su domain_georgia_su domain_grozny_ru domain_ivanovo_su domain_kalmykia_ru domain_kalmykia_su domain_kaluga_su domain_karacol_su domain_karaganda_su domain_karelia_su domain_khakassia_su domain_krasnodar_su domain_kustanai_ru domain_kustanai_su domain_mangyshlak_su domain_marine_ru domain_mordovia_ru domain_mordovia_su domain_msk_ru domain_msk_su domain_murmansk_su domain_mytis_ru domain_nalchik_ru domain_nalchik_su domain_navoi_su domain_north_kazakhstan_su domain_nov_ru domain_nov_su domain_pokrovsk_su domain_pyatigorsk_ru domain_ru_net domain_sochi_su domain_spb_ru domain_spb_su domain_termez_su domain_togliatti_su domain_troitsk_su domain_tselinograd_su domain_tula_su domain_tuva_su domain_vladikavkaz_ru domain_vladikavkaz_su domain_vladimir_ru domain_vladimir_su domain_vologda_su	Delegated	Домен зарегистрирован и делегирован
  	Not delegated	Домен зарегистрирован, но не делегирован
  Deleted	Домен удален из базы данных
  Deleted	Домен удален из базы данных
  domain_epp_com, domain_epp_net, domain_epp_org, domain_epp_biz, domain_epp_info domain_epp_me, domain_epp_cc, domain_epp_tv, domain_epp_tel, domain_epp_mobi, domain_epp_name, domain_epp_pro, domain_epp_ag, domain_epp_bz, domain_epp_hn, domain_epp_mn, domain_epp_lc, domain_epp_sc, domain_epp_vc	LOCK	Запрещена смена регистратора, на делегирование домена не влияет
  	ACTIVE	Смена регистратора разрешена, на делегирование домена не влияет
  	HOLD	Смена регистратора запрещена, домен не прописан в файле зоны
  	Примечание. По аналогии с доменами .RU введены статусы DELEGATED и NOT DELEGATED, которые отображаются через whois-сервис RU-CENTER (whois.nic.ru или https://www.nic.ru/whois/). Эти статусы устанавливаются при выполнении следующих условий: DELEGATED (делегирован) - услуга предоставляется (service-state:0), в домене указано не менее 2 (двух) DNS-серверов (поля nameservers не пустые) и object-state:LOCK или object-state:ACTIVE. NOT DELEGATED (не делегирован) - в остальных случаях
  primary_var, primary_fixed	Ok	Услуга работает нормально
  	RCS-Ok	Зона обновлена, услуга работает нормально
  	Refresh	Зона ожидает обновления
  secondary	Ok	Услуга работает нормально
  	Testing	Производится тестирование Name-сервера
  	Suspend	Тестирование Name-сервера приостановлено из-за наличия ошибок конфигурации и будет возобновлено через 4 часа
  	Hold	Тестирование Name-сервера приостановлено из-за наличия ошибок конфигурации и не будет возобновлено
  webforwarding, mailforwarding, new_wf, web_forwarding	Ok	Услуга работает нормально
  	Refresh	Производится обновление настроек услуги

• domain
  Название домена, для которого оказывается услуга.
• suspend-date
  Дата, после которой произойдет отключение услуги - если услуга предоставляется;
  дата, после которой произойдет удаление услуги - если услуга уже отключена за неуплату.

Кроме того, для каждого типа услуг в блоках [service-object] могут присутствовать дополнительные поля, содержащие специфичные для этой услуги данные.

Дополнительные поля для услуги регистрации и продления регистрации доменов:

• descr
  Описание домена в свободной текстовой форме, выдаваемое через Whois-сервис.
• nameservers
  DNS-сервера домена в формате имя_сервера - пробел - IP-адреса через запятую.
• testing-nameservers
  В том случае, если DNS-сервера домена были изменены и в данный момент производится их тестирование, в этом поле отображаются новые DNS-сервера, в то время как в поле nameservers - старые. В остальных случаях это поле не выводится.
• test-state
  информация о тестировании DNS-серверов:
  Checking - идет тестирование;
  Failed - тестирование завершено неуспешно;
  Ok - тестирование завершено успешно.
• autoprolong
  Флаг автоматического продления:
  1 - режим автоматического продления услуги включен;
  0 - режим автоматического продления услуги выключен.
• e-mail
  phone
  fax-no
  Контактная информация для отображения через Whois-сервис.
  Поля предназначены для доменов .RU, .РФ, .SU и могут быть пустыми. Указанные данные отображаются в ответах Whois-сервиса только в том случае, если поля phone, e-mail и fax-no для домена заполнены. В противном случае отображаются данные из анкеты.
• admin-c
  bill-c
  tech-c
  Контактная информация для отображения через Whois-сервис. Поля предназначены для доменов в международных и зарубежных национальных доменах (.NET, .COM, .TV, .ME, .TEL, .TRAVEL,…).
  Поиск контактных лиц

Дополнительные поля для услуги Primary-Standard:

• nserver
  DNS-сервера домена, для которого оказывается услуга, в формате имя_сервера - пробел - IP-адреса через запятую.
• secondary
  IP-адреса secondary DNS-серверов (через запятую), для которых обеспечивается возможность скачивания зоны.

Дополнительные поля для услуги Primary-Auto:

• nserver
  DNS-сервера домена, для которого оказывается услуга, в формате имя_сервера - пробел - IP-адреса через запятую.
• secondary
  IP-адреса secondary DNS-серверов (через запятую), для которых обеспечивается возможность скачивания зоны.

Дополнительные поля для услуги Web-forwarding:

• url
  URL, на который осуществляется перенаправление HTTP-запроса.
• frames
  ON в случае, если перенаправление запроса осуществляется с помощью структуры фреймов, или OFF в случае, если перенаправление осуществляется через HTTP Redirect (см. описание услуги Web-forwarding).

Дополнительное поле для услуги Перенаправление почты:

• forward-to
  Шаблон управления почтой: звездочка (т.е. перенаправлять всю почту), пробел, далее адрес e-mail для перенаправления почты, в случае, если перенаправление осуществляется на один адрес, или конструкция *@домен, если перенаправление осуществляется на аналогичные адреса другого домена (см. Описание услуги Перенаправление почты)

Дополнительное поле для услуги Перенаправление домена:

• wfi
  Опции перенаправления (см. Заказ услуги Перенаправление домена)