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 - Название контакта (актуализируется в разделе “Клиент” - “Контакты доменов”