DOMAIN:CHECK
Команда EPP <check>
domain призначена для перевірки існування домену
в реєстрі або перевірки можливості реєстрації нового домену із заданим ім'ям
Команда <check>
містить один або декілька (але не більше 10) елементів:
<domain:name>
- повністю визначене доменне ім'я.
Приклад команди <check>
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
<command>
<check>
<domain:check
xmlns:domain="http://hostmaster.ua/epp/domain-1.1">
<domain:name>example1.epp1.ua</domain:name>
<domain:name>examle-123.epp1.ua</domain:name>
</domain:check>
</check>
<clTRID>USER-1275850648</clTRID>
</command>
</epp>
Приклад відповіді сервера на команду <check>
При успішному обробленні команди <check>
у відповіді сервера елемент <resData>
містить під-елемент <domain:chkData>
,
у якому присутні елементи <domain:cd>
- поодинці на кожен <domain:name>
у запиті.
<domain:cd>
містить наступні під-елементи:
<domain:name avail="0/1">
- задане доменне ім'я і атрибут "avail",
який може набувати значень "0" або "1". "0" означає,
що такий домен не може бути створений, "1" означає, що домен синтаксично коректний і вільний для реєстрації.
<domain:reason>
- необов'язковий елемент. Задається при avail="0"
та описує причину, з якої домен не може бути зареєстрований.
Причини можуть бути наступні:
- Некоректне ім'я домена
- Об'єкт уже існує
- Даний публічний домен не обслуговується
<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
<response>
<result code="1000">
<msg lang="en">Command completed successfully</msg>
</result>
<resData>
<domain:chkData
xmlns:domain="http://hostmaster.ua/epp/domain-1.1">
<domain:cd>
<domain:name avail="0">example1.epp1.ua</domain:name>
<domain:reason>Object exists</domain:reason>
</domain:cd>
<domain:cd>
<domain:name avail="1">example-123.epp1.ua</domain:name>
</domain:cd>
</domain:chkData>
</resData>
<trID>
<clTRID>USER-1275850648</clTRID>
<svTRID>UA-20100606215846-157155-00002</svTRID>
</trID>
</response>
</epp>
Коди відповідей сервера на команду <check>
1000 "Command completed successfully"
"Команду виконано успішно"
2001 "Command syntax error"
"Синтаксична помилка команди"
Помилка виникає при числі об'єктів, що перевіряються, більшому максимально допустимого (10)