Перенаправление почты

Заказ на изменение данных для услуги Перенаправление почты

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

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

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

• service
  Тип заказываемой услуги. В данном случае необходимо указать фиксированное значение - mforwarding (см. значения полей service и template). Обязательное поле. Однострочное поле.
• template
  Шаблон заказываемой услуги. В данном случае необходимо указать фиксированное значение - mail_forwarding (см. значения полей service и template). Обязательное поле. Однострочное поле.
• action
  Тип заказа. Необязательное поле (по умолчанию его значение new). Однострочное поле. При заказе на изменение данных необходимо указать: update.
• domain
  Имя домена вместе с зоной, для которого заказывается услуга. Доменное имя на национальном языке должно быть указано в виде XN--***.SU. В том случае, если требуется переадресация с адреса вида www.домен.зона, то в этом поле необходимо указать домен вместе с www (переадресация домена с префиксом www и без префикса - две отдельные услуги). Обязательное поле. Однострочное поле.
• forward-to
  Шаблон управления почтой: звездочка (т.е. перенаправлять всю почту), пробел, далее адрес e-mail для перенаправления почты, в случае, если перенаправление осуществляется на один адрес, или конструкция *@домен, если перенаправление осуществляется на аналогичные адреса другого домена (см. описание услуги Перенаправление почты). Обязательное поле. Однострочное поле.
• switch
  Флаг выключателя услуги. Для того чтобы услуга была включена, значение этого поля должно быть ON, для выключения услуги - значение OFF. Обязательное поле. Однострочное поле.

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

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

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

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

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

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