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