Відмінності між версіями «SMTP»
Admin (обговорення • внесок) |
Admin (обговорення • внесок) (→Відповіді) |
||
Рядок 244: | Рядок 244: | ||
'''<code>INFO:0300</code>''' — вказує на номер заявки назначений системою автоматично | '''<code>INFO:0300</code>''' — вказує на номер заявки назначений системою автоматично | ||
− | + | '''<code>OK:0203</code>''' — заявка успішно прийнята в чергу і ще не завершена | |
− | <code>OK:0203</code> — заявка успішно прийнята в чергу і ще не завершена | + | |
− | + | '''<code>OK:0200</code>''' — заявка успішно виконана та завершена | |
− | <code>OK:0200</code> — заявка успішно виконана та завершена | + | |
− | + | '''<code>ERROR:0098</code>''' — заявка відхилена та завершена | |
− | <code>ERROR:0098</code> — заявка відхилена та завершена | + | |
Після коду може бути зазначена причина скасування запиту. | Після коду може бути зазначена причина скасування запиту. |
Версія за 17:20, 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
— вказує на номер заявки назначений системою автоматично
OK:0203
— заявка успішно прийнята в чергу і ще не завершена
OK:0200
— заявка успішно виконана та завершена
ERROR:0098
— заявка відхилена та завершена
Після коду може бути зазначена причина скасування запиту.
Наприклад ERROR:0098
Low account balance or any billing error — повідомляє про брак коштів на балансі для здійснення платної операції.
Або в доменах .PP.UA може бути відхилена заявка з результатом ERROR:0098
Invalid phone number in registrant contact — що вказує на некоректність номера телефона реєстранта, на який відправляється sms.