Пример запроса:
lang:ruПример запроса для геодомена:
lang: ruВ заголовке запроса необходимо указать значения request:order и operation:create (см. описание формата заголовка запроса).
После заголовка запроса следуют блоки order-item. Количество этих блоков неограниченно, т.е. в одном запросе можно заказать произвольное количество услуг (в том числе не связанных между собой). Каждый блок начинается заголовком, указанным в квадратных скобках в отдельной строке.
Блок [order-item] состоит из следующих полей:
Поле | Значение поля |
---|---|
service | Тип заказываемой услуги. В данном случае необходимо указать фиксированное значение - domain (см. значения полей service и template). Обязательное поле. Однострочное поле. |
template | Шаблон заказываемой услуги. Необходимо указать значение client_ru — для .RU, .SU или доменов третьего уровня; domain_rf — для .РФ (см. значения полей service и template). Необязательное поле. Однострочное поле. |
action | Тип заказа. Для заказа новой услуги в этом поле необходимо указать значение new. Необязательное поле (по умолчанию его значение new). Однострочное поле. |
domain | Имя регистрируемого домена вместе с зоной. Доменное имя на национальном языке должно быть указано в виде «XN--***». Обязательное поле. Однострочное поле. |
descr | Описание домена в произвольном текстовом формате на английском языке. Выводится через Whois-сервис. Поле может содержать латинские буквы, цифры, знаки препинания и пробелы. Максимальный размер поля - 300 символов. Необязательное поле. Многострочное поле. |
e-mail phone fax-no |
Контактная информация для отображения через Whois-сервис. Поля могут быть пустыми. Указанные данные будут отображаться в ответах Whois-сервиса только в том случае, если поля phone, e-mail и fax-no для домена заполнены. В противном случае будут отображаться данные из анкеты. |
nserver | DNS-серверы домена в формате имя_сервера - пробел - IP-адреса через запятую. Указание IP-адреса (IP-адресов) требуется в том случае, если имя DNS-сервера содержит регистрируемый домен. Во всех остальных случаях достаточно указания имени DNS-сервера. Необязательное поле (но в том случае, если заполняется, должно быть указано как минимум два DNS-сервера, находящиеся в различных сетях класса C). Многострочное поле. |
check-ns | Флаг, управляющий запуском тестирования DNS-серверов при регистрации домена .RU, .РФ и .SU или при направлении заказа типа UPDATE на изменение списка DNS-серверов для зарегистрированного домена. ON - инициировать стандартную процедуру тестирования DNS-серверов, OFF - не проводить стандартную процедуру тестирования DNS-серверов. Однострочное поле, необязательное для заполнения (по умолчанию его значение ON). |
Порядок следования полей в запросе произвольный в пределах каждого блока. Многострочные поля записываются в несколько строк, при этом в начале каждой строки присутствует название поля и разделитель (двоеточие). Для однострочных полей повторение не допускается. Необязательные поля могут либо отсутствовать в блоке, либо их значение может быть пустым (состоящим из пробельных символов).
Пример ответа:
State: 200 OKОтвет содержит заголовок (см. формат заголовка ответа) и тело ответа, которое отделяется от заголовка пустой строкой.
В случае успешного выполнения запроса (код 200) в теле ответа содержится одно поле - order_id, в котором указывается идентификатор принятого заказа.
Примечание: Для данного типа запросов код 200 означает только то, что запрос не содержит синтаксических ошибок и принят к обработке. Указанный код не означает, что заказ выполнен с успешным результатом. Сообщаемый в ответе order_id можно использовать для запросов на получение информации о ходе исполнения заказа. В ответ на такие запросы предоставляется точная информация о статусе заказа: выполнен (успешно или неуспешно), в обработке и т.п.
Если в форме запроса обнаружены ошибки, выдается ответ с кодом 402, и в теле ответа содержится блок errors с описанием ошибок на языке, указанном в запросе в поле lang.