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

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

lang: ru
login:123/NIC-REG/adm
password:QWERTY
subject-contract:3457/NIC-D
request:service-object
operation:search
request-id:20011220103455.12345@nic.ru

[service-object]
service:secondary
domain:TEST*.RU
service-objects-limit:10
service-objects-first:1
object-only:0

В заголовке запроса необходимо указать значения 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). Однострочное поле.

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

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

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

[service-objects-list]
service-objects-found:6 service-objects-limit:10 service-objects-first:1

[service-object]
object:domain_ru
service-id:5621679
service-state:0
testing-nameservers:
domain:TEST1234.RU
subject-contract:12345/NIC-D
payed-till:22.04.2009
contract-id:3481188
autoprolong:0
suspend-date:
nameservers:ns3.nic.ru
nameservers:ns4.nic.ru
nameservers:ns8.nic.ru
test-state:Ok
service:domain_ru
phone:+7 495 1234567
descr:
fax-no:+7 495 1234567
e-mail:you@mail.ru
switch:ON
object-state:DELEGATED
multiplier:1
end-date:22.04.2009

[service-object]
subject-contract:12345/NIC-D
object:primary_var
service:primary_var
service-id:294985
contract-id:267350
payed-till:21.08.2002
end-date:21.08.2002
switch:ON
object-state:Refresh
domain:TEST.RU
nserver:ns3.nic.ru 194.85.61.20
nserver:ns4.nic.ru 194.226.96.8
secondary:194.226.96.8

[service-object]
subject-contract:12345/NIC-D
object:primary_fixed
service:primary_fixed
service-id:294947
contract-id:267350
payed-till:16.08.2002
end-date:16.08.2002
switch:ON
object-state:Ok
domain:DEEP.SUB.TEST.RU
nserver:ns.DEEP.TEST.RU 1.3.4.5, 2.4.5.6
nserver:ns6.DEEP.TEST.RU 3.4.5.7
nserver:ns5.nic.ru
secondary:194.226.96.8

[service-object]
subject-contract:12345/NIC-D
object:secondary
service:secondary
service-id:293476
contract-id:267350
payed-till:27.08.2002
end-date:27.08.2002
switch:ON
object-state:Testing
domain:TEST.RU
primary-ip:194.85.61.20

[service-object]
subject-contract:12345/NIC-D
object:wforwarding
service:wforwarding
service-id:294962
contract-id:267350
payed-till:16.08.2002
end-date:16.08.2002
switch:ON
object-state:Refresh
domain:1353.RU
url:http://info.nic.ru/
frames:ON

[service-object]
subject-contract:12345/NIC-D
object:new_wf
service: new_wf
service-id:293978
contract-id:267350
payed-till: 19.10.2011
end-date: 19.10.2011
switch:ON
object-state:Refresh
domain:web-forward.ru
wf0:  https://www.nic.ru:12349 www / 302 NO
wf1: https://www.nic.ru / Page Title YES

[service-object]
subject-contract:12345/NIC-D
object:mforwarding
service:mforwarding
service-id:295032
contract-id:267350
payed-till:29.08.2002
end-date:29.08.2002
switch:OFF
object-state:Refresh
domain:AHA.RU
forward-to:* *@test.ru

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

В случае успешного выполнения запроса (код 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 для перенаправления почты, в случае, если перенаправление осуществляется на один адрес, или конструкция *@домен, если перенаправление осуществляется на аналогичные адреса другого домена (см. Описание услуги Перенаправление почты)

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

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