Відмінності між версіями «SMTP»
Admin (обговорення • внесок) (→Відповіді) |
Admin (обговорення • внесок) |
||
Рядок 242: | Рядок 242: | ||
Відповідь містить статус обробки, номер заявки та цитату отриманого оригіналу. | Відповідь містить статус обробки, номер заявки та цитату отриманого оригіналу. | ||
− | + | '''<code>INFO:0300</code>''' — вказує на номер заявки назначений системою автоматично | |
− | <code>INFO:0300</code> — вказує на номер заявки назначений системою автоматично | + | |
==== 0203 ==== | ==== 0203 ==== |
Версія за 17:19, 28 жовтня 2022
Опис | Характеристика |
---|---|
auto-dbm@drs.ua | |
Формат | text/plain |
SMTP (Simple Mail Transfer Protocol) – це протокол взаємодії реєстру доменної зони та реєстраторів доменів по email. SMTP DRS дозволяє здійснювати реєстрацію, зміну, продовження, трансфер та відновлення доменів.
Зміст
Вимоги
Команди приймаються електронною поштою за умови:
- Надсилання реєстратором запиту лише на адресу auto-dbm@drs.ua
- Тільки з авторизованих email адрес акредитованих реєстраторів.
- Ідентифікатор реєстратора, який надіслав заявку, має бути обов'язково зазначений у тексті електронного листа-заявки в полі "mnt-by".
- Лист має бути в text/plain (utf-8, koi8-r, koi8-u, windows-1251 якщо містить кириличні символи). Усі формати MIME відкидаються.
- Неприпустимі вкладення, HTML форматування та Base-64 або Quoted-Printable перекодування.
- Заборонено використання в листі-заявці різних підписів, оскільки автоматична система може прийняти весь підпис або її частину за фрагмент заявки із синтаксичною помилкою.
- В одному листі має бути не більше однієї заявки.
Команди, які не відповідають вищезазначеним вимогам, можуть бути не розпізнані системою як заявки та бути проігноровані.
Опис
Заявка складається з набору рядків, які в свою чергу складаються з імен полів та їх значень, розділених символом ':' та пробілом.
Значення полів має відповідати вимогам відповідного доменного імені.
Поля можуть бути таких типів:
domain:
Повне ім'я домену. Не повинно починатися та закінчуватися на символ '-'. Обов'язкове поле.
license:
Номер свідоцтва ТМ для реєстрації доменів .UA.
period:
Період продовження домену, від 0 до 10. В запиті на трансфер використовується значення = 0 для реєстрів із безплатним трансфером та значення = 1 для реєстрів із платним трансфером. Використовується у заявках TRANSFER
та RENEW
.
auth-code:
Код трансферу домену, використовується лише у заявках TRANSFER
та UPDATE
.
status:
Статус домену, використовується лише у заявках UPDATE
.
Реєстратор може встановлювати такі статуси: "clientUpdateProhibited", "clientDeleteProhibited", "clientTransferProhibited", "clientRenewProhibited" та "clientHold". Зазначене в запиті одне поле "status: ok" — скидає усі попередньо встановлені реєстратором статуси.
registrant-c:
Персональний контакт CUNIC організації або особи на користь якого зареєстрований домен.
admin-c:
Персональний контакт CUNIC організації або особи, яка займається питаннями реєстрації.
tech-c:
Персональний контакт CUNIC організації або особи, відповідальної за технічну роботу домену (експлуатація nameservers, ліквідація аварійних ситуацій та ін.)
billing-c:
Персональний контакт CUNIC організації або особи, яка займається питаннями оплати реєстрації.
nserver:
Ім'я сервера, який обслуговуватиме домен. Має бути як мінімум два nserver, що вказують на фізично різні сервера імен. IP-адреса nameserver'а обов'язкова у випадку, якщо його ім'я — у зоні, що делегується (наприклад, ns.www.biz.ua для домену www.biz.ua). А якщо ні, то зазначення IP помилкою не вважається, але ігнорується.
Формат: Повне ім'я сервера, за необхідності через пропуск IP адреси nameserver'a.
mnt-by:
Ідентифікатор реєстратора (mnt-cunic). Обов'язкове поле.
source:
Вказує джерело інформації про домен. На DRS — завжди CUNIC.
Обов'язкове поле. Маркер кінця заявки
Увага! При використанні заявки UPDATE
необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад - "tech-c"), це означатиме його видалення. Виняток – відсутність поля статусу — "status: ok". У заявках інших типів вказувати поля крім необхідних для її обробки не обов'язково, вказані ж будуть проігноровані.
Типи команд
З об'єктом domain можна виконувати наступні операції:
CREATE
– реєстрація нового об'єкта
UPDATE
– зміна властивостей об'єкта
RENEW
– збільшення часу життя об'єкта
TRANSFER
– зміна реєстратора, що обслуговує об'єкт
RESTORE
– відновлення об'єкта
DELETE
– видалення об'єкта з бази DRS
Нижче наведено приклади правильно оформлених заявок (за Subject: слідує тема електронного листа, що відповідає заявці, а після Message body: — сам зміст запиту).
CREATE
Subject:
create ***.biz.ua
Message body:
domain: ***.biz.ua
registrant-c: ***-CUNIC
admin-c: ***-CUNIC
tech-c: ***-CUNIC
billing-c: ***-CUNIC
nserver: ns1.***.com
nserver: ns2.***.com
mnt-by: ***-MNT-CUNIC
source: CUNIC
Subject:
create ***.ua
Message body:
domain: ***.ua
license: 12345
registrant-c: ***-CUNIC
admin-c: ***-CUNIC
tech-c: ***-CUNIC
nserver: ns1.***.ua 62.149.0.157
nserver: ns1.***.com
mnt-by: ***-MNT-CUNIC
source: CUNIC
Subject:
create ***.com.ua
Message body:
domain: ***.com.ua
registrant-c: ***-CUNIC
admin-c: ***-CUNIC
tech-c: ***-CUNIC
nserver: ns1.***.ua 62.149.0.157
nserver: ns1.***.com
mnt-by: ***-MNT-CUNIC
source: CUNIC
UPDATE
Увага! При використанні заявки UPDATE
необхідно заповнювати всі поля, які планується зберегти для об'єкта. Якщо якийсь тип поля не вказати (наприклад - tech-c
), це означатиме його видалення. Виняток – відсутність поля статусу чи коду трансферу.
Subject:
update ***.biz.ua
Message body:
domain: ***.biz.ua
registrant-c: ***-CUNIC
admin-c: ***-CUNIC
tech-c: ***-CUNIC
billing-c: ***-CUNIC
nserver: ns3.***.biz.ua 62.149.0.157
nserver: ns4.***.com
mnt-by: ***-MNT-CUNIC
source: CUNIC
Subject:
update ***.com.ua
Message body:
domain: ***.com.ua
auth-code: код трансферу
status: ok
registrant-c: ***-CUNIC
admin-c: ***-CUNIC
tech-c: ***-CUNIC
nserver: ns3.***.com
nserver: ns4.***.com
mnt-by: ***-MNT-CUNIC
source: CUNIC
RENEW
Subject:
renew ***.co.ua
Message body:
domain: ***.co.ua
mnt-by: ***-MNT-CUNIC
source: CUNIC
Відсутність поля period
означає продовження домену на 1 рік.
TRANSFER
Subject:
transfer ***.co.ua
Message body:
domain: ***.co.ua
period: 0
auth-code: код трансфера
mnt-by: ***-MNT-CUNIC
source: CUNIC
Subject:
transfer ***.com.ua
Message body:
domain: ***.com.ua
period: 1
auth-code: код трансфера
mnt-by: ***-MNT-CUNIC
source: CUNIC
Subject:
transfer ***.com
Message body:
domain: ***.com
auth-code: код трансфера
mnt-by: ***-MNT-CUNIC
source: CUNIC
Відсутність поля "period"
означає що в заявці буде використане значення за замовчуванням: 0 для реєстрів із безплатним трансфером та значення 1 для реєстрів із платним трансфером.
RESTORE
Subject:
restore ***.biz.ua
Message body:
domain: ***.biz.ua
mnt-by: ***-MNT-CUNIC
source: CUNIC
Відновлення доменів командою RESTORE
наразі доступне для доменів .BIZ.UA, .CO.UA та .PP.UA.
DELETE
Заявка DELETE
видаляє лише запис з бази DRS і не видаляє домен з реєстру.
Subject:
delete ***.com.ua
Message body:
domain: ***.com.ua
mnt-by: ***-MNT-CUNIC
source: CUNIC
Відповіді
Система автоматично відповідає на листи надіслані на електрону пошту auto-dbm@drs.ua. Відповідь містить статус обробки, номер заявки та цитату отриманого оригіналу.
INFO:0300
— вказує на номер заявки назначений системою автоматично
0203
OK:0203
— заявка успішно прийнята в чергу і ще не завершена
0200
OK:0200
— заявка успішно виконана та завершена
0098
ERROR:0098
— заявка відхилена та завершена
Після коду може бути зазначена причина скасування запиту.
Наприклад ERROR:0098
Low account balance or any billing error — повідомляє про брак коштів на балансі для здійснення платної операції.
Або в доменах .PP.UA може бути відхилена заявка з результатом ERROR:0098
Invalid phone number in registrant contact — що вказує на некоректність номера телефона реєстранта, на який відправляється sms.