Поддержка абонентов: support@thehost.ua
Ваши отзывы и предложения: #feedback

2.14. Реселлинг доменов: 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 - Название контакта (актуализируется в разделе "Клиент" - "Контакты доменов"