Заказ на изменение данных для домена в доменах RU, РФ, SU и доменов третьего уровня
Пример запроса:
lang:rurequest:order
operation:create
login:123/NIC-REG/ADM
password:qwerty
subject-contract:3457/NIC-D
request-id:20011220103455.12345@nic.ru
[order-item]
service:domain
action:update
domain:test.ru
descr:Domain for test purpose
e-mail:sidor@test.my-provider.ru
phone:+7 495 1234567
fax-no:+7 495 1234568
nserver:ns2.nic.ru
nserver:ns1.nic.ru
Пример запроса для геодомена:
lang: rurequest:order
operation:create
login:123/NIC-REG/ADM
password:qwerty
subject-contract:3457/NIC-D
request-id:20011220103455.12345@nic.ru
[order-item]
service:domain
action:update
domain:test.msk.ru
descr:Domain for test purpose
e-mail:sidor@test.my-provider.ru
phone:+7 495 1234567
fax-no:+7 495 1234568
nserver:ns2.nic.ru
nserver:ns1.nic.ru
В заголовке запроса необходимо указать значения request:order и operation:create (см. описание формата заголовка запроса).
После заголовка запроса следуют блоки order-item. Количество этих блоков неограничено, т.е. в одном запросе можно заказать произвольное количество услуг (в том числе не связанных между собой). Каждый блок начинается заголовком, указанным в квадратных скобках в отдельной строке.
Блок [order-item] состоит из следующих полей:
|
Поле |
Значение поля |
|
service |
Тип заказываемой услуги. В данном случае необходимо указать фиксированное значение — domain (см. значения полей service и template). Обязательное поле. Однострочное поле. |
|
template |
Шаблон заказываемой услуги. Необходимо указать значение |
|
action |
Тип заказа. Для заказа на изменение данных по услуги в этом поле необходимо указать значение update. Обязательное поле. Однострочное поле. |
|
domain |
Имя регистрируемого домена вместе с зоной. Доменное имя на национальном языке должно быть указано в виде XN—***. Обязательное поле. Однострочное поле. |
|
descr |
Описание домена в произвольном текстовом формате на английском языке. Выводится через Whois-сервис. Поле может содержать латинские буквы, цифры, знаки препинания и пробелы. Максимальный размер поля — 300 символов. Необязательное поле. Многострочное поле. |
|
e-mail |
Контактная информация для отображения через Whois-сервис. Поля могут быть пустыми. Указанные данные будут отображаться в ответах Whois-сервиса только в том случае, если заполнены поля e-mail и phone. В противном случае будут отображаться данные из анкеты. |
|
nserver |
DNS-серверы домена в формате имя_сервера — пробел — IP-адреса через запятую. Указание IP-адреса (IP-адресов) требуется в том случае, если имя DNS-сервера содержит регистрируемый домен. Во всех остальных случаях достаточно указания имени DNS-сервера. Необязательное поле (но в том случае, если заполняется, должно быть указано как минимум два DNS-сервера, находящиеся в различных сетях класса C). Многострочное поле. |
|
check-ns |
Флаг, управляющий запуском тестирования DNS-серверов при регистрации домена .RU, .РФ и .SU или при направлении заказа типа UPDATE на изменение списка DNS-серверов для зарегистрированного домена. |
Порядок следования полей в запросе произвольный в пределах каждого блока. Многострочные поля записываются в несколько строк, при этом в начале каждой строки присутствует название поля и разделитель (двоеточие). Для однострочных полей повторение не допускается. Необязательные поля могут либо отсутствовать в блоке, либо их значение может быть пустым (состоящим из пробельных символов).
Пример ответа:
State: 200 OKrequest-id:20011220103455.12345@nic.ru
[order]
order_id:4515
Ответ содержит заголовок (см. формат заголовка ответа) и тело ответа, которое отделяется от заголовка пустой строкой.
В случае успешного выполнения запроса (код 200) в теле ответа содержится одно поле - order_id, в котором указывается идентификатор принятого заказа.
Примечание: Для данного типа запросов код 200 означает только то, что запрос не содержит синтаксических ошибок и принят к обработке. Указанный код не означает, что заказ выполнен с успешным результатом. Сообщаемый в ответе order_id можно использовать для запросов на получение информации о ходе исполнения заказа. В ответ на такие запросы предоставляется точная информация о статусе заказа: выполнен (успешно или неуспешно), в обработке и т.п.
Если в форме запроса обнаружены ошибки, выдается ответ с кодом 402, и в теле ответа содержится блок errors с описанием ошибок на языке, указанном в запросе в поле lang.