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