Заказ услуги сокрытия данных в Whois (WHOISPROXY)

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

login:14872/NIC-REG/ADM
password:123456
subject-contract:2094276/NIC-D
request:order
operation:create
lang:ru
request-id:20141117165609@partner-site.ru

[order-item]
action:new
domain:checkoldcom.com
service:whois_proxy
template:whois_proxy
admin-on:ON
bill-on:ON
multiplier:1
switch:ON

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

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

Блок [order-item] состоит из следующих полей:

  • service
    Тип заказываемой услуги. В данном случае необходимо указать фиксированное значение - whois_proxy (см. значения полей service и template). Обязательное поле. Однострочное поле.
  • template
    Шаблон заказываемой услуги. В данном случае необходимо указать фиксированное значение - whois_proxy (см. значения полей service и template). Обязательное поле. Однострочное поле.
  • switch
    Флаг выключателя услуги. Возможные значения ON (включено) и OFF (выключено). При заказе новой услуги в этом поле устанавливается значение ON. Обязательное поле. Однострочное поле.
  • domain
    Имя домена вместе с зоной, для которого заказывается услуга. Доменное имя на национальном языке должно быть указано в виде XN--***.NET. Обязательное поле. Однострочное поле.
  • action
    Тип заказа. Для заказа новой услуги необходимо указать значение new. Необязательное поле (по умолчанию его значение new). Однострочное поле.
  • multiplier
    Срок действия услуги в годах. Услугу можно заказать на один год. Если указано иное значение, то заказ не принимается. Срок действия услуги WHOISPROXY может не совпадать со сроком регистрации домена
  • admin-on
    Включить [выключить] защиту для контакта admin-c (контактное лицо по административным вопросам). Возможные значения ON (включено) и OFF (выключено). При заказе новой услуги в этом поле устанавливается значение ON. Необязательное поле.
  • bill-on
    Включить [выключить] защиту для контакта bill-c (контактное лицо по административным вопросам). Возможные значения ON (включено) и OFF (выключено). При заказе новой услуги в этом поле устанавливается значение ON. Необязательное поле.
  • tech-on
    Включить [выключить] защиту для контакта tech-c (контактное лицо по административным вопросам). Возможные значения ON (включено) и OFF (выключено). При заказе новой услуги в этом поле устанавливается значение ON. Необязательное поле.

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

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

State: 200 OK
request-id: 20141117165609@partner-site.ru

[order]
order_id:35868423

[order-item]

Ответ содержит заголовок (см. формат заголовка ответа) и тело ответа, которое отделяется от заголовка пустой строкой.
В случае успешного выполнения запроса (код 200) в теле ответа содержится блок [order] с полем - order_id, в котором указывается идентификатор принятого заказа.

Если в заказе были нефатальные ошибки, то в теле ответа содержится блок [order-item] с полем warnings-template, содержащим описание ошибки и результатом ее исправления.

Если в форме запроса обнаружены фатальные ошибки, то выдается ответ с кодом 402, и в теле ответа содержится блок [errors] с описанием ошибок на языке, указанном в запросе в поле lang. В блоках [order-item] приводятся описания ошибок относящиеся к конкретному пункту заказа.

Примечание: Для данного типа запросов код 200 означает только то, что запрос не содержит синтаксических ошибок и принят к обработке. Указанный код не означает, что заказ выполнен с успешным результатом. Сообщаемый в ответе order_id можно использовать для запросов на получение информации о ходе исполнения заказа. В ответ на такие запросы предоставляется точная информация о статусе заказа: выполнен (успешно или неуспешно), в обработке и т.п.

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