Смена тарифа

Заказ на моментальную смену тарифа услуги хостинга

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

login:123/NIC-REG/adm
password:********
request:order
operation:create
lang:ru
request-id:20011220103455.12345@nic.ru

[order-item]
action:upgrade
template:upgrade
domain:TEST
service:trf_102
new-service:trf_302
hosting-ip: 0

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

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

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

  • action
    Тип заказа. Для заказа на изменение тарифа услуги в этом поле необходимо указать значение upgrade. Обязательное поле. Однострочное поле.
  • template
    Шаблон заказываемой услуги. В данном случае необходимо указать фиксированное значение - upgrade. Обязательное поле. Однострочное поле.
  • service
    Тип изменяемой услуги. Возможные значения поля service в описании поля service, относящемся к услуге хостинга. Обязательное поле. Однострочное поле.
  • domain
    Идентификатор услуги хостинга, для которой оказывается услуга продления. Обязательное поле. Однострочное поле.
  • new-service: Поле определяет новый тариф. Обязательное поле. Однострочное поле. Возможные значения поля new-service определены в описании поля service, относящемся к услуге хостинга.
  • hosting-ip:
    Поле, в котором указывается количество IP-адресов. Возможные значения 0 или 1. Обязательное поле. Однострочное поле. Значение по умолчанию 0.

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

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

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

[order]
order_id:4515

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

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

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

Если в форме запроса обнаружены ошибки, выдается ответ с кодом 402, и в теле ответа содержится блок errors с описанием ошибок на языке, указанном в запросе в поле lang.

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