Пример запроса:
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]
action:prolong
service:domain
domain:test.com
prolong:1
[order-item]
action:prolong
template:prolong
service: trf_201
domain:TESTHOSTING
prolong:1
[order-item]
action:prolong
service:domain
domain:TEST.RU
autoprolong:1
В заголовке запроса необходимо указать значения request:order и operation:create (см. описание формата заголовка запроса).
После заголовка запроса следуют блоки order-item. Количество этих блоков неограничено, т.е. в одном запросе можно заказать произвольное количество услуг (в том числе не связанных между собой). Каждый блок начинается заголовком, указанным в квадратных скобках в отдельной строке.
Блок [order-item] состоит из следующих полей:
|
Поле |
Описание поля |
|
acc-rec |
Внутренний идентификатор услуги в базе данных (значение поля service-id из ответа на запрос поиска услуг, действие которых заканчивается). Необязательное поле. Однострочное поле. |
|
action |
Тип заказа. Для заказа на продление услуги в этом поле необходимо указать значение prolong. Обязательное поле. Однострочное поле. |
|
autoprolong |
Необязательное поле. Однострочное поле. Возможные значения: |
|
domain |
Имя домена, для которого оказывается услуга, или идентификатор хостинга. Указывается в верхнем регистре. Доменное имя на национальном языке должно быть указано в виде XN--***.TLD. Необязательное поле. Однострочное поле. |
|
prolong |
Поле, определяющее срок, на который будет продлена услуга. Необязательное поле. Однострочное поле. Возможные значения: |
|
service |
Тип продляемой услуги в соответствии с таблицей типов услуг. Обязательное поле. Однострочное поле. |
|
template |
Шаблон заказываемой услуги. В данном случае необходимо указать фиксированное значение - prolong (см. значения полей service и template). Если тип продляемой услуги domain, данное поле является необязательным. Для всех остальных случаев поле является обязательным. Однострочное поле. |
В заказе в обязательном порядке должно присутствовать либо поле prolong, либо поле autoprolong.
При получении заказа на продление действия услуги c заполненным полем prolong он исполняется сразу в случае, если на личном счете партнера достаточно средств. В том случае если средств недостаточно, заказ будет исполнен после поступления необходимой суммы. Отменить заказ на продление действия услуги путем направления аналогичного заказа со значением prolong:0 нельзя.
При получении заказа на продление действия услуги с заполненным полем autoprolong он исполняется сразу. Если режим автоматического продления включен (autoprolong:1), услуга будет продлена на 1 год автоматически за 30 дней до окончания срока ее действия, если на личном счете партнера достаточно средств. Заказ на выключение режима автоматического продления (autoprolong:0) отменяет продление действия услуги только в том случае, если он отправлен не позднее, чем за 30 дней до окончания срока действия услуги.
Порядок следования полей в запросе произвольный в пределах каждого блока. Многострочные поля записываются в несколько строк, при этом в начале каждой строки присутствует название поля и разделитель (двоеточие). Для однострочных полей повторение не допускается. Необязательные поля могут либо отсутствовать в блоке, либо их значение может быть пустым (состоящим из пробельных символов).
Пример ответа:
State: 200 OKrequest-id:20011220103455.12345@nic.ru
[order]
order_id:4515
Пример ответа:
State: 402 Errors in order item templates[order-item]
errors-template: service - domain_ru, domain - test.ru . Сервис не доступен
[order-item]
errors-template: service - primary_var, domain test.ru . Сервис не доступен
Пример ответа:
State: 404 Object not foundОтвет содержит заголовок (см. формат заголовка ответа) и тело ответа, которое отделяется от заголовка пустой строкой.
State: 200 OK
В случае успешного выполнения запроса в теле ответа содержится одно поле - order_id, в котором указывается идентификатор принятого заказа.
Данный тип ответа означает только то, что запрос не содержит синтаксических ошибок и принят к обработке. Данный ответ не означает, что заказ выполнен с успешным результатом.
Сообщаемый, в ответе, order_id можно использовать для получения информации о заказе. В ответ на такие запросы предоставляется точная информация о статусе заказа: выполнен (успешно или неуспешно), в обработке и т.п.
State: 402 Errors in order item templates
В ответе содержатся блоки [order-item] с указанием услуг (service), которые не могут быть продлены.
Примечание: Значения поля service в ответах могут отличатся от значений поля service в заказах для доменов COM, NET, ORG, BIZ, INFO. (см. значения поля service).
State: 404 Object not found
Услуга (service) или ее идентификатор (acc-rec), указанный в пункте заказа, не принадлежит указанному договору клиента.
При возврате ошибок в заголовке ответа - запрос не будет обработан.