Общее описание команд EPP

Команды обрабатываются на сервере EPP в порядке, в котором они поступили от клиента. Команды обрабатывается немедленно, о чем клиенту сообщается в ответе сервера. В случае, если обработка команды требует подтверждения со стороны клиента, другого клиента или оператора Реестра, клиенту будет сообщено, что команда принята, но действие отложено (action pending). (см. код ответа 1001). В случае отложенного действия предусмотрена возможность просматривать информацию о ходе выполнения команды.

Команды EPP делятся на 3 категории:

• команды управления сессией - для подключения/отключения к EPP-серверу;
• команды для получения информации об объектах - операции чтения;
• команды изменения объектов.

Команды управления сессией

Для управления сессией используются две команды: <login> и <logout>.

Команда EPP <login> используется для открытия сессии с EPP сервером.

Команда EPP <logout> завершает сеанс доступа к серверу EPP. Сессия может быть также завершена по истечении некоторого времени бездействия либо по истечении максимального времени сессии. Данные параметры регулируются Регламентом.

Команды для получения информации об объектах

Для получения информации о том, зарегистрирован ли объект (домен, хост или контакт) в Реестре, используется команда проверки <check>:

• <domain:check>
• <contact:check>
• <host:check>

Для получения информации об уже зарегистрированных объектах используется команда <info>

• <domain:info>
• <contact:info>
• <host:info>

Для чтения служебных сообщений, которые сервер EPP направляет клиенту, используется команда <poll>. Команда имеет атрибуты:
"req" - чтение последнего непрочитанного сообщения из очереди сообщений,
"ack" - подтверждение прочтения сообщения

Для получения информации о текущем статусе операции трансфера объекта используется информационная команда <transfer op="query">. Команда доступна для клиента, инициировавшего трасфер, и спонсора объекта.

Команды изменения объектов

Для создания новых объектов (доменов, хостов или контактов) используется команда <create>

• <domain:create>
• <contact:create>
• <host:create>

Для изменения данных в объектах (доменах, хостах или контактах) используется команда <update>

• <domain:update>
• <contact:update>
• <host:update>

Для продления срока регистрации домена используется команда <renew>

• <domain:renew>

Для трансфера домена к новому регистратору используется команда <transfer>

• <domain:transfer>

Для удаления объекта (домена, хоста или контакта) используется команда <delete>

• <domain:delete>
• <contact:delete>
• <host:delete>

Формат команд EPP

Все EPP-элементы размещаются между метками <?xml>, <epp> и </epp>. Сама команда описывается блоком <command>.

Блок команды выглядит следующим образом (на примере команды domain info):

  <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
     <info>
       <domain:info xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
         <domain:name>example1-epp.uz</domain:name>
       </domain:info>
     </info>
     <clTRID>USER-1276595352</clTRID>
    </command>
  </epp>

Команда содержит следующие элементы:

• Название команды.
• Объектно-зависимые или протокольно-зависимые элементы (см. описание отдельных команд).
• НЕОБЯЗАТЕЛЬНЫЙ элемент <clTRID>, содержащий уникальный идентификатор запроса. Этот идентификатор будет присутсвовать в ответе сервера на данную команду. Используется для определения соответствия запросов и ответов сервера EPP.

Формат ответов сервера EPP (Responses)

На каждую полученную от клиента команду сервер направляет ответ, в котором указано, была ли успешно выполнена команда либо при ее анализе и выполнении возникли ошибки.

Общая структура ответов сервера EPP:

Все EPP-элементы размещаются между метками <?xml>, <epp> и </epp>. Блок ответа выглядит следующим образом:

  <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <response>
      -- Ответ сервера --
    </response>
  </epp>

Ответ сервера EPP содержит элементы:

• Один или несколько элементов <result>, которые сообщают об успешном или неуспешном выполнении команд Каждый элемент содержит следующие атрибуты и дочерние элементы:
  • Атрибут "code" - четырехзначный десятичный код результата. Детальнее см. описание всех кодов: Code Response.
  • Элемент <msg> - текстовое описание результата команды. Язык описания указан в атрибуте "lang".
  • Необязательный элемент <value> - значение ошибочного параметра (в случае наличия ошибки).
  • Необязательный элемент <extValue>, содержащий в случае наличия ошибки значение ошибочного параметра (элемент <value>) и текстовое описание причины ошибки (элемент <reason>).
• НЕОБЯЗАТЕЛЬНЫЙ элемент <msgQ>, содержащий номер служебного сообщения (в случаях, когда это предусмотрено).
• НЕОБЯЗАТЕЛЬНЫЙ элемент <resData>, содержащий информацию, специфичную для каждой команды.
• Элемент <trID>, содержащий уникальный идентификатор запроса <clTRID> (если он был передан клиентом) и уникальный идентификатор ответа, сгенерированный сервером <svTRID>