Освобождающиеся домены .SU, .COM.RU, .NET.RU, .ORG.RU, .PP.RU или геодомены

• Заказ услуги
• Поиск действующих услуг
• Удаление услуги
• Аукцион освобождающихся доменов
  Поиск аукционов, ожидающих оплаты
  Подтверждение оплаты аукциона

Заказ услуги «Регистрация освобождающегося домена .SU, .COM.RU или геодомены»

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

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

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

• service
  Тип заказываемой услуги. В данном случае необходимо указать фиксированное значение - back_order. (см. значения полей service и template). Обязательное поле. Однострочное поле.
• template
  Шаблон заказываемой услуги. В данном случае необходимо указать фиксированное значение - back_order (см. значения полей service и template). Обязательное поле. Однострочное поле.
• action
  Тип заказа. Для заказа новой услуги в этом поле необходимо указать значение new. Необязательное поле (по умолчанию его значение new). Однострочное поле.
• domain
  Имя регистрируемого домена вместе с зоной. Обязательное поле. Однострочное поле.

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

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

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

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

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

Поиск действующих услуг "Регистрация освобождающегося домена"

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

После заголовка запроса следует блок back-order, в котором следует задать данные для поиска. Поиск осуществляется с логикой «и» для перечисленных полей. Блок начинается заголовком, указанным в квадратных скобках в отдельной строке.

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

• domain
  Имя домена, для которого оказывается услуга. Имя домена должно быть указано в верхнем регистре, может содержать латинские буквы, цифры, точку и символ «звездочка» (*). «Звездочка» заменяет группу символов (ноль и более). Доменное имя на национальном языке должно быть указано в виде XN--***.SU. Необязательное поле. Однострочное поле.
• back-order-limit
  Количество блоков с данными о заказах, выдаваемых в ответе. В случае если вы печатаете результаты ответа на странице, то значение этого поля можно установить, например, 10 - база данных будет выдавать по 10 заказов, и на странице вашего интерфейса будет отображаться по 10 строк. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 10). Однострочное поле.
• back-order-first
  Порядковый номер блока с данными о заказах, начиная с которого (из числа найденных в базе данных) блоки будут выдаваться в ответе. Для постраничной выдачи заказов в вашем интерфейсе, если на каждой странице отображается по 10 заказов, для первой страницы это поле нужно устанавливать равным 1, для второй - 11, для третьей - 21, и так далее. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 1). Однострочное поле.

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

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

В случае успешного выполнения запроса (код 200) в теле ответа содержится блок back-order-list, содержащий служебную информацию о результатах поиска, а также блоки back-order c данными по найденным услугам.

Блок [back-order-list] содержит следующие поля:

• back-order-found
  Количество услуг, найденных по запросу в базе данных.
• back-order-limit
  Количество услуг, выданных по запросу. Соответствует затребованному количеству выдаваемых услуг.
• back-order-first
  Порядковый номер услуги, начиная с которой (из числа найденных в базе данных) осуществляется выдача. Соответствует затребованному порядковому номеру начальной услуги.

В блоках [back-order] содержатся следующие поля, общие для всех услуг:

• contract-num
  Соответствует полю login в заголовке запроса.
• subject-contract
  Номер анкеты клиента, для которого была заказана услуга.
• service
  Тип услуги.
• status
  Статус действующего заказа:
  waiting - ожидает освобождения домена
  running - идет процесс регистрации
  ok - завершен
• domain
  Имя домена.
• order-id
  Идентификатор заказа, в состав которого входит данная услуга.
• item-id
  Внутренний идентификатор услуги в базе данных.

Удаление услуги «Регистрация освобождающегося домена»

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

После заголовка запроса следует блок back-order. Блок начинается заголовком, указанным в квадратных скобках в отдельной строке.

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

• item-id
  Внутренний идентификатор услуги в базе данных. Идентификатор можно получить с помощью запроса "Поиск действующей услуги "Регистрация освобождающегося домена". Обязательное поле. Многострочное поле.

Обработка запроса

Удаление услуги возможно только в случае если у нее установлен статус «ожидает освобождения домена» (status:waiting в ответе на запрос «Поиск действующей услуги «Регистрация освобождающегося домена»).

Если в заказе указаны несколько пунктов заказа (несколько order-item'ов), то код 200 возвращается только при успешном удалении всех пунктов заказа. Если оказывается невозможным удаление хотя бы одного order-item'а — никаких изменений не происходит (ничего не удаляется), и возвращается код ошибки.

Сообщение об успешном выполнении

Сообщение об ошибке

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

Аукцион освобождающихся доменов

Если в RU-CENTER поступили несколько заказов от клиентов на один и тот же освобождающийся домен, каждый из которых готов к исполнению, и домен удалось зарегистрировать после освобождения — среди клиентов проводится аукцион. После проведения аукциона победителю необходимо подтвердить оплату аукциона.

Поиск аукционов, ожидающих оплаты

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

После заголовка запроса следует блок service, в котором следует задать данные для поиска. Поиск осуществляется с логикой «и» для перечисленных полей. Блок начинается заголовком, указанным в квадратных скобках в отдельной строке.

Блок [service] может состоять из следующих полей:

• service
  Тип услуг, поиск которых производится. Обязательное поле. В данном случае должно быть указано значение back_order.
• domain
  Имя домена, для которого производится поиск услуг. Поле может содержать латинские буквы, цифры, дефисы, точку и символ «звездочка» (*). «Звездочка» заменяет группу символов (ноль и более). Доменное имя на национальном языке должно быть указано в виде XN--***.SU. Необязательное поле. Однострочное поле.
• re-registration-flag
  Обязательное поле. В данном случае должно быть указано значение 1.
• state
  Признак услуги в отношении ее оплаты. Обязательное поле. В данном случае должно быть указано значение 0.
• is-blocked
  Признак того, заблокированы ли деньги на счету на оплату услуги. Обязательное поле. В данном случае должно быть указано значение NO.
• service-limit
  Количество блоков с данными об услугах, выдаваемых в ответе. В случае если вы печатаете результаты ответа на странице, то значение этого поля можно установить, например, 10 - база данных будет выдавать по 10 услуг, и на странице вашего интерфейса будет отображаться по 10 строк. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 10). Однострочное поле.
• service-first
  Порядковый номер блока с данными об услугах, начиная с которого (из числа найденных в базе данных) блоки будут выдаваться в ответе. Для постраничной выдачи услуг в вашем интерфейсе, если на каждой странице отображается по 10 услуг, для первой страницы это поле нужно устанавливать равным 1, для второй - 11, для третей - 21, и так далее. Поле может содержать число от 1 до 64000. Необязательное поле (по умолчанию его значение равно 1). Однострочное поле.
• order-by
  Сортировка списка. Необязательное поле. При указании значения suspend-date сортировка будет осуществляться по последнему дню оплаты.

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

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

В случае успешного выполнения запроса (код 200) в теле ответа содержится блок service-objects-list, содержащий служебную информацию о результатах поиска, а также блоки service-object c данными по найденным услугам.

Блок [service-list] содержит следующие поля:

• service-found
  Количество услуг, найденных по запросу в базе данных.
• service-limit
  Количество услуг, выданных по запросу. Соответствует затребованному количеству выдаваемых услуг.
• service-first
  Порядковый номер услуги, начиная с которой (из числа найденных в базе данных) осуществляется выдача. Соответствует затребованному порядковому номеру начальной услуги.

В блоках [service] содержатся следующие поля, общие для всех услуг:

• subject-contract
  Номер анкеты клиента, для которого оказывается услуга.
• domain
  Название домена.
• service
  Тип услуги.
• service-id
  Внутренний идентификатор услуги в базе данных. Используется для подтверждения оплаты аукциона (должен быть подставлен в поле acc-req).
• prolong-flag
  Флаг оплаты домена:
  0 - оплата домена не подтверждена;
  1 - оплата домена подтверждена.
• is-blocked
  Признак того, заблокированы ли деньги на счету на оплату домена.
• suspend-date
  Последний день оплаты.
• sum
  Стоимость услуги с указанием валюты.

Остальные поля в ответах на этот запрос для поиска аукционов, ожидающих оплаты, не используются, либо являются служебными.

Подтверждение оплаты аукциона

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

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

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

• action
  Тип заказа. Для подтверждения оплаты аукциона в этом поле необходимо указать значение prolong. Обязательное поле. Однострочное поле.
• template
  Шаблон заказываемой услуги. В данном случае необходимо указать фиксированное значение - prolong (см. значения полей service и template). Обязательное поле. Однострочное поле.
• service
  Тип услуги. В данном случае необходимо указать фиксированное значение - back_order. Необязательное поле. Однострочное поле.
• acc-rec
  Внутренний идентификатор услуги в базе данных (соответствует полю service-id в результатах поиска аукционов, ожидающих оплаты). Необязательное поле. Однострочное поле.
• domain
  Имя домена, для которого оказывается услуга. Имя домена должно быть указано в верхнем регистре. Доменное имя на национальном языке должно быть указано в виде XN--***.SU. Необязательное поле. Однострочное поле.
   

  Для идентификации продлеваемой услуги в заказе должно присутствовать либо поле acc-rec, либо поле domain и service.

• prolong
  0 - отказаться от оплаты;
  1 - подтвердить оплату.
  Обязательное поле. Однострочное поле.

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

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

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

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

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