.UA - наш дом. Сделаем его лучшим!
Тестовый Сервер


CONTACT:CREATE

Команда EPP <create> contact предназначена для создания объекта Контакт.
Этот объект используется для указания регистранта, административных, технических и финансовых контактов домена.

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

  • <contact:id> - уникальный идентификатор создаваемого контакта. Если вместо идентификатора задать зарезервированное значение autonic, то Реестр автоматически сгенерирует новый идентификатор, который будет выдан в ответе команды. В идентификаторе используются только буквы латинского алфавита в НИЖНЕМ регистре, а также цифры и дефис. См. Описание объекта.
  • <contact:postalInfo> - один или два элемента с адресной информацией.
    Возможно использование элементов <contact:postalInfo> одного из двух типов:
    type=”int” - допускает текст только латиница;
    type="loc” - текст на нациальном языке в кодировке UTF-8.
    В записи Контакт могут присутствовать оба поля ("int" и "loc") или только одно из них ("int" или "loc"). Использование двух элементов одного типа не допускается.
    <contact:postalInfo> содержит следующие под-элементы:
    • <contact:name> - имя (обязательный параметр)
    • <contact:org> - название организации (необязательный параметр)
    • <contact:addr> - адрес, состоящий из:
      • <contact:street> - до трех строк. (необязательный параметр)
      • <contact:city> - город
      • <contact:sp> - район или провинция. (необязательный)
      • <contact:pc> - почтовый индекс (необязательный)
      • <contact:cc> - двухсимвольный код страны
  • <contact:voice> - номер телефона (необязательный)
  • <contact:fax> - номер факс (необязательный)
  • <contact:email> - адрес email (обязательный параметр)
  • <contact:authInfo><pw> - auth-info (пароль к объекту). Если элемент не задан, Реестр автоматически генерирует пароль.
  • <contact:disclose> - необязательный элемент, определяющий набор флагов для скрытия или раскрытия персональной информации.
    Если этот элемент задан, то он должен содержать аттрибут "flag", принимающий значения:
    "0" ("скрыть информацию") или
    "1" ("открыть информацию")
    и не менее одного подэлемента, определяющего тип информации:
                 
       <contact:name type="int"/>
       <contact:name type="loc"/>
       <contact:org type="int"/>
       <contact:org type="loc"/>
       <contact:addr type="int"/>
       <contact:addr type="loc"/>
       <contact:voice/>
       <contact:fax/>
       <contact:email/>
    

Пример команды <create>

 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <command>
     <create>
       <contact:create xmlns:contact="http://eunic.net.ua/epp/contact-1.1">
         <contact:id>ex123</contact:id>
         <contact:postalInfo type="int">
           <contact:name>Vasya Pupkin</contact:name>
           <contact:org>My Company</contact:org>
           <contact:addr>
             <contact:street>1 Street</contact:street>
             <contact:city>Kyiv</contact:city>
             <contact:pc>01001</contact:pc>
             <contact:cc>UA</contact:cc>
           </contact:addr>
         </contact:postalInfo>
         <contact:postalInfo type="loc">
           <contact:name>Вася Пупкин</contact:name>
           <contact:org>Моя Компания</contact:org>
           <contact:addr>
             <contact:street>1, Улица</contact:street>
             <contact:city>Киев</contact:city>
             <contact:pc>01001</contact:pc>
             <contact:cc>UA</contact:cc>
           </contact:addr>
         </contact:postalInfo>
         <contact:voice>+380.442222222</contact:voice>
         <contact:email>someone@somewhere.com.ua</contact:email>
         <contact:authInfo>
           <contact:pw>2fooBAR</contact:pw>
         </contact:authInfo>
         <contact:disclose flag="0">
           <contact:name type="loc"/>
           <contact:org type="loc"/>
           <contact:addr type="loc"/>
           <contact:voice/>
           <contact:email/>
         </contact:disclose>
       </contact:create>
     </create>
     <clTRID>USER-1275595171</clTRID>
   </command>
 </epp>

Пример ответа сервера на команду <create>

Если команда <create> выполнена успешно, ответ сервера содержит элемент <resData> с подэлементом <creData>.

Элемент <creData> содержит подэлементы:

  • <contact:id> - уникальный идентификатор созданного контакта.
  • <contact:crDate> - дата и время создания объекта (локальное).
 <?xml version="1.0" encoding="UTF-8"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <response>
     <result code="1000">
       <msg lang="en">Command completed successfully</msg>
     </result>
     <resData>
       <contact:creData xmlns:contact="http://eunic.net.ua/epp/contact-1.1">
         <contact:id>nnn</contact:id>
         <contact:crDate>2010-06-06T17:19:14+03:00</contact:crDate>
       </contact:creData>
     </resData>
     <trID>
       <clTRID>USER-1275595171</clTRID>
       <svTRID>UA-20100606171915-214076-00002</svTRID>
     </trID>
   </response>
 </epp>

Пример ответа сервера с ошибкой выполнения команды

 <?xml version="1.0" encoding="UTF-8"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <response>
     <result code="2302">
       <msg lang="en">Object exists</msg>
     </result>
     <trID>
       <clTRID>USER-1275595171</clTRID>
       <svTRID>UA-20100606174034-297418-00002</svTRID>
     </trID>
   </response>
 </epp>

Коды ответов сервера на команду <create>

1000    "Command completed successfully"
        "Команду виконано успішно"
        "Команда выполнена успешно"

2001    "Command syntax error"
        "Синтаксична помилка команди"
        "Синтаксическая ошибка команды"

2003    "Required parameter missing"
        "Відсутній обов'язковий параметр"
        "Отсутствует обязательный параметр"

2005    "Parameter value syntax error"
        "Синтаксична помилка параметра"
        "Синтаксическая ошибка параметра"

2302    "Object exists"
        "Об'єкт вже існує"
        "Объект уже существует"