2.4.2 Реселлинг доменов: EMAIL API

Автоматизированное управления доменами с помощью EMAIL API в рамках программы реселлинга доменов осуществляется с помощью обмена электронными письмами в специальном формате. Каждое письмо, отправляемое реселлером, должно содержать детальное описание требуемого действия с доменными именами. На протяжении нескольких минут реселлер получает ответ со статусом выполнения поставленной задачи.

Технические требования для корректной работы EMAIL API:

  • EMAIL API доступен только для клиентов, получивших статус реселлера доменных имён.
  • Электронные письма реселлера должны отправляться в текстовом режиме без HTML оформления.
  • Email команды принимаются и обрабатываются исключительно при получении с почтового ящика, ассоциированного с учётной записью реселлера в личном кабинете.
  • Почтовым шлюзом EMAIL API является почтовый ящик autoreg@thehost.net.ua. Именно на него должна производиться отправка email команд реселлера.

Перечень основных переменных:

  • $CLID - Код клиента, получаемый в разделе личного кабинета Клиент -> Информация о счетах.
  • $ACID - Код счёта в проекте TheHost Domains Reselling, получаемый в разделе личного кабинета Клиент -> Информация о счетах.

Коды ответов:

  • OK - Команда выполнена успешно.
  • ERROR: Domain status doesn’t allow requested operation- Текущий статус доменного имени в реестре доменных имён не допускает проведении запрошенной операции.
  • ERROR: Insufficient funds - Недостаточно средств для выполнения запрошенной операции.
  • ERROR: Incorrect transfer code - Недействительный код трансфера доменного имени.
  • ERROR: Incorrect CLID/ACID - Некорректные данные CLID/ACID.
  • ERROR: Premium or reserved domain - Запрошенный домен является премиальным или зарезервирован администрацией доменной зоны.
  • ERROR: Incorrect data - В переданном письме на выполнение операции с доменным именем обнаружена ошибка.

Изменение неймсерверов домена (NS)

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

Заголовок EMAIL:

%NSUPDATE DOMAIN%

Тело EMAIL:

DOMAIN=$DOMAIN_NAME
NS0=$NS0
NS1=$NS1
NS2=$NS2
NS3=$NS3
CLID=$CLID  
ACID=$ACID

Переменные запроса:

  • $DOMAIN_NAME - Название контакта.
  • $NS0 - DNS сервер домена №1.
  • $NS1 - DNS сервер домена №2.
  • $NS2- DNS сервер домена №3 (опционально) .
  • $NS3 - DNS сервер домена №4 (опционально).

Регистрация домена с новым контактом

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

Заголовок EMAIL:

%CREATE DOMAIN%

Тело EMAIL:

DOMAIN=$DOMAIN_NAME 
PERIOD=$REGISTRATION_PERIOD
NS0=$NS0
NS1=$NS1 
NS2=$NS2
NS3=$NS3
CONTACT_NAME=$CONTACT_NAME 
CONTACT_FIRSTNAME=$FIRSTNAME
CONTACT_LASTNAME=$LASTNAME
CONTACT_COMPANY=$COMPANY
CONTACT_EMAIL=$EMAIL
CONTACT_PHONE=$PHONE
CONTACT_FAX=  
CONTACT_COUNTRY=$LA_COUNTRY
CONTACT_STATE=$LA_STATE
CONTACT_POSTCODE=$LA_POSTCODE
CONTACT_CITY=$LA_POSTCODE
CONTACT_ADDRESS=$LA_ADDRESS
CLID=$CLID  
ACID=$ACID

Переменные запроса:

  • $DOMAIN_NAME - Имя регистрируемого доменного имени с доменной зоной (пример thehost.com.ua).
  • $REGISTRATION_PERIOD - Количество лет, на которое регистрируется домен (пример 1). Минимальное значение - 1, максимальное - 10.
  • $NS0 - DNS сервер домена №1.
  • $NS1 - DNS сервер домена №2.
  • $NS2 - DNS сервер домена №3 (опционально).
  • $NS3 - DNS сервер домена №4 (опционально).
  • $CONTACT_NAME - Название контакта (пример test domain contact).
  • $COMPANY - Название компании контакта. Для физических лиц необходимо указывать Private Person.
  • $FIRSTNAME- Имя контактной особы в латинице (пример Ivan).
  • $LASTNAME - Фамилия контактной особы в латинице (пример Ivanov).
  • $EMAIL - Электронная почта контакта (пример test@test.com).
  • $PHONE- Телефон контактного лица в нужном формате - в номере обязательно должны присутствовать + и 2 пробела (пример +380 67 1234567).
  • $LA_COUNTRY - Название страны в латинице (пример Ukraine).
  • $LA_STATE- Название области в латинице (пример Kyiv region).
  • $LA_POSTCODE - Почтовый код (пример 01001).
  • $LA_CITY - Название города в латинице (пример Kyiv).
  • $LA_ADDRESS - Адрес в латинице (пример Kreschatik 1).

Регистрация домена с существующим контактом

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

Заголовок EMAIL:

%CREATE DOMAIN%

Тело EMAIL:

DOMAIN=$DOMAIN_NAME 
PERIOD=$REGISTRATION_PERIOD
NS0=$NS0
NS1=$NS1
NS2=$NS2
NS3=$NS3 
CONTACT_ID=$CONTACT_ID
CONTACT_NAME=$CONTACT_NAME
 CLID=$CLID  
ACID=$ACID

Переменные запроса:

  • $DOMAIN_NAME - Имя регистрируемого доменного имени с доменной зоной (пример thehost.com.ua).
  • $REGISTRATION_PERIOD - Количество лет, на которое регистрируется домен (пример 1). Минимальное значение - 1, максимальное - 10.
  • $NS0 - DNS сервер домена №1.
  • $NS1 - DNS сервер домена №2.
  • $NS2 - DNS сервер домена №3 (опционально).
  • $NS3 - DNS сервер домена №4 (опционально).
  • $CONTACT_ID - Код контакта (актуализируется в разделе Клиент -> Контакты доменов.
  • $CONTACT_NAME - Название контакта (актуализируется в разделе Клиент -> Контакты доменов.

Продление доменного имени

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

Заголовок EMAIL:

%RENEW DOMAIN%

Тело EMAIL:

DOMAIN=$DOMAIN_NAME
EXPIRE=$EXPIRE_DATE
PERIOD=$RENEW_PERIOD
CLID=$CLID  
ACID=$ACID

Переменные запроса:

  • $DOMAIN_NAME - Имя регистрируемого доменного имени с доменной зоной (пример thehost.com.ua).
  • $EXPIRE_DATE - Текущий срок действия домена (пример 2034-01-14).
  • $RENEW_PERIOD - Количество лет, на которое продлевается домен (пример 1). Минимальное значение - 1, максимальное - 10.

Трансфер доменного имени с новым контактом

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

Заголовок EMAIL:

%TRANSFER DOMAIN%

Тело EMAIL:

DOMAIN=$DOMAIN_NAME
TRANSFER_CODE=$TRANSFER_CODE
NS0=$NS0
NS1=$NS1
NS2=$NS2 
NS3=$NS3 
CONTACT_NAME=$CONTACT_NAME
CONTACT_FIRSTNAME=$FIRSTNAME
CONTACT_LASTNAME=$LASTNAME
CONTACT_COMPANY=$COMPANY
CONTACT_EMAIL=$EMAIL
CONTACT_PHONE=$PHONE
CONTACT_FAX=  
CONTACT_COUNTRY=<$LA_COUNTRY
CONTACT_STATE=$LA_STATE
CONTACT_POSTCODE=$LA_POSTCODE
CONTACT_CITY=$LA_POSTCODE
CONTACT_ADDRESS=$LA_ADDRESS
CLID=$CLID  
ACID=$ACID

Переменные запроса:

  • $DOMAIN_NAME - Имя регистрируемого доменного имени с доменной зоной (пример thehost.com.ua).
  • $TRANSFER_CODE - Числобуквенный код трансфера (переноса) доменного имени.
  • $NS0 - DNS сервер домена №1.
  • $NS1 - DNS сервер домена №2.
  • $NS2 - DNS сервер домена №3 (опционально).
  • $NS3 - DNS сервер домена №4 (опционально).
  • $CONTACT_NAME - Название контакта (пример Test domain contact).
  • $COMPANY - Название компании контакта. Для физических лиц необходимо указывать Private Person.
  • $FIRSTNAME - Имя контактной особы в латинице (пример Ivan).
  • $LASTNAME - Фамилия контактной особы в латинице (пример Ivanov).
  • $EMAIL - Электронная почта контакта (пример test@test.com).
  • $PHONE - Телефон контактного лица в нужном формате - в номере обязательно должны присутствовать + и 2 пробела (пример +380 67 1234567).
  • $LA_COUNTRY - Название страны в латинице (пример Ukraine).
  • $LA_STATE- Название области в латинице (пример Kyiv region).
  • $LA_POSTCODE - Почтовый код (пример 01001).
  • $LA_CITY - Название города в латинице (пример Kyiv).
  • $LA_ADDRESS - Адрес в латинице (пример Kreschatik 1).

Трансфер доменного имени с существующим контактом

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

Заголовок EMAIL:

%TRANSFER DOMAIN%

Тело EMAIL:

DOMAIN=$DOMAIN_NAME
TRANSFER_CODE=$TRANSFER_CODE
NS0=$NS0
NS1=$NS1
NS2=$NS2
NS3=$NS3
CONTACT_ID=$CONTACT_ID  
CONTACT_NAME=$CONTACT_NAME
CLID=$CLID  
ACID=$ACID

Переменные запроса:

  • $DOMAIN_NAME - Имя регистрируемого доменного имени с доменной зоной (пример thehost.com.ua)
  • $TRANSFER_CODE - Числобуквенный код трансфера (переноса) доменного имени.
  • $NS0 - DNS сервер домена №1.
  • $NS1 - DNS сервер домена №2.
  • $NS2 - DNS сервер домена №3 (опционально) .
  • $NS3 - DNS сервер домена №4 (опционально).
  • $CONTACT_ID - Код контакта (актуализируется в разделе Клиент -> Контакты доменов).
  • $CONTACT_NAME - Название контакта (актуализируется в разделе Клиент -> Контакты доменов).