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 - Назва контакту (актуалізується в розділі Клієнт -> Контакти доменів).