Описание HTTP-шлюза к системе регистрации доменов RU - RegMy.ru |
Это справочное руководство описывает HTTP-шлюз к системе распределённой
регистрации
HTTP-шлюз — это метод взаимодействия с системой распределённой
регистрации , позволяющий осуществлять операции в реальном времени за
один шаг.
Для осуществления одношаговых (одноэтапных) операций, вся информация должна
быть представлена в одном единственном HTTP-запросе. В интерфейсе нет
понятия "состояния" и все запросы независимы друг от друга. HTTP-интерфейс
поддерживает такие операции как регистрация домена, смена DNS серверов домена,
проверка доступности домена, смена регистрационных данных домена и т.п.
Доступные операции описаны ниже в этом документе.
Запросы к HTTP-шлюзу должны направляться на URL
https://www.RegMy.ru/regonline.phpили
http://www.RegMy.ru/regonline.php
Среднее время ответа при нормальных нагрузках сервера должно быть не более 5 или 10 секунд.
В Regmy.ru предоставляет тестовый доступ к своему шлюзу для тестирования системы регистрации. Отличия тестового доступа от реального таковы:
Для использования тестовой системы, HTTP-Post запросы должны направляться на тот же URL, что и для реальной системы. При этом используются следующие авторизационные данные:
login: test
password: test
При использовании интерфейса RegTimeSRS клиентом должен быть соблюдён ряд ограничений.
HTTP-шлюз позволяет осуществлять различные операции. В таблице ниже приведён список операций, которые могут быть осуществлены с использованием HTTP-шлюза. Для каждой операции требуется указание различных параметров (полей), которые описаны ниже в этом документе.
| Операция |
Описание | Реали- зовано |
|---|---|---|
| Операции по регистрации и переносу (см. раздел 4) | ||
| Reg_Dom_RU_PP | Подать заявку на регистрацию домена для зон RU или SU | Да |
| Reg_Dom_COM | Подать заявку на регистрацию домена для всех остальных зон | Да |
Прочие операции (см. раздел 5) | ||
| Trans_Create | Проверка доступности домена для регистрации | Да |
| Edit_Srok_Deg | Продление регистрации домена | Да |
| Edit_NS | Смена списка DNS-серверов домена | Да |
| Edit_Dom_RU_PP | Смена данных владельца домена для зон RU или SU | Да |
| Edit_Dom_COM | Смена данных владельца домена для всех остальных зон | Да |
Команды на осуществление операций передаются в виде стандартного запроса HTTP/1.0 POST. Параметры операции передаются в виде HTTP параметров. При этом действуют следующие правила:
В таблице перечислены все обязательные поля, которые должны присутствовать в КАЖДОМ запросе.
| Имя поля | Макс. длина | Описание |
|---|---|---|
| tipzapr | 80 | Определяет операцию, которая должна быть произведена, например Reg_Dom_RU_PP |
| login | 80 | Имя пользователя (login) в системе регистрации regmy.ru. |
| password | 80 | Пароль пользователя (password) в системе регистрации regmy.ru. |
| domain_name | 67 | Полное имя домена, с которым производится операция, например example.com. Максимальная длина - 67 символов (63 + 4). Допустимы алфавитно-цифровые символы и символ дефиса. Русские имена доменов указываются в кодировке windows-1251 (CP1251). |
Ниже перечислены сообщения об ошибках системы, общие для всех операций:
| Текст ошибки | Описание |
|---|---|
| Error: login/password Incorrect | Значения полей "login" и/или "password" не указаны, указаны неверно, либо такого пользователя не существует. |
| Error: Domain Name is invalid | Значение поля "domain_name" не указано или указано неверно: т.е. содержит недопустимые символы, превышает допустимую длину и т.п. |
| Error: System Unavailable | Шлюз RegTimeSRS не доступен. Операция не была произведена и запрос должен быть подан повторно. |
| Error: The following fields are invalid: <fields list> | Значения перечисленных полей неверны. Исправьте данные и повторите запрос. |
| Имя поля | Мин. длина | Макс. длина | Описание поля |
|---|---|---|---|
| period | 1 | 2 | Период, на который производится регистрация домена. Единственное допустимое значение для доменов .ru и .su: 1. |
| Контактные данные частного лица (только при регистрации домена на частное лицо!) | |||
| person | 8 | 64 | Имя, первая буква отчества (без точки) и фамилия администратора
домена, записанные латинскими буквами. Предназначено для использования
сервисом 'whois'. Для иностранцев поле содержит имя в оригинальном
написании (или в английской транскрипции). Пример: Vassily N Pupkin |
| person_r | 9 | 64 | Фамилия, имя и отчество администратора домена на русском языке в
соответствии с паспортными данными. Для иностранцев поле содержит имя в
оригинальном написании (при невозможности в английской
транскрипции). Пример1: Пупкин Василий Николаевич Пример2: John Smith |
| passport | 15 | 255 много- строчное |
Серия и номер паспорта, а также наименование органа, выдавшего
паспорт, и дата выдачи (в указанной последовательности, с разделением
пробелами). В написании римских цифр допустимо использование только
латинских букв. Дата записывается в формате ДД.ММ.ГГГГ. Знак номера перед
номером паспорта не ставится. Паспорта СССР (паспорта старого образца) не
принимаются. В случае использования документа, отличного от паспорта
(допустимо ТОЛЬКО для нерезидентов России), в начале строки указывается
наименование вида документа. Запись может быть
многострочной. Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990 |
| residence | 20 | 255 много- строчное |
Адрес места проживания администратора домена на русском языке. Адрес
аналогичен ранее существовашей прописке и адресу регистрации, указываемого
в паспорте. Запись может быть многострочной. Пример: 101000, Москва, ул.Воробьянинова, 15,\n кв.22, В. Лоханкину. |
| birth_date | 10 | 10 | Дата рождения администратора домена в формате
ДД.ММ.ГГГГ. Пример: 07.11.1917 |
| country | 2 | 2 | Двухбуквенный ISO-код страны, гражданином которой является частное
лицо Пример: RU |
| p_address | 15 | 255 много- строчное |
Почтовый адрес администратора домена на русском языке. (Адрес может не
совпадать с указанным в паспорте местом регистрации.) Запись может быть
многострочной. Пример: 101000, Москва, ул.Воробьянинова, 15,\n кв.22, В. Лоханкину. |
| phone | 8 | 255 много- строчное |
Номер телефона администратора домена. Телефон указывается с
международным кодом (включая символ +); международный код, код города и
местный номер разделяются пробелами. Скобки и тире не допускаются. Запись
может быть многострочной. Пример: +7 495 8102233\n+7 3432 811221 |
| fax | 8 | 255 много- строчное |
Номер телефакса администратора домена. Номер телефакса указывается с
международным кодом (включая символ +); международный код, код города и
местный номер разделяются пробелами. Скобки и тире не допускаются. Запись
может быть многострочной. Пример: +7 3432 811221\n+7 495 5555342 |
| e_mail | 6 | 255 много- строчное |
Адрес электронной почты администратора домена в формате RFC-822.
Запись может быть многострочной. Пример: ncc@test.ru\ntest@test.ru |
| code | 12 | 12 | Идентификационный номер налогоплательщика (ИНН), присвоенный
администратору домена. Параметр указывается только в том случае, если
администратор выступает как индивидуальный предприниматель. Пример: 789012345678 |
| DNS-серверы домена | |||
| ns0 | 6 | 80 | Имя хоста первого DNS-сервера. |
| ns1 | 6 | 80 | Имя хоста второго DNS-сервера. |
| ns2 | 6 | 80 | Имя хоста третьего DNS-сервера. |
| ns3 | 6 | 80 | Имя хоста четвёртого DNS-сервера. |
| ns0ip | 8 | 15 | IP-адрес первого DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns1ip | 8 | 15 | IP-адрес второго DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns2ip | 8 | 15 | IP-адрес третьего DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns3ip | 8 | 15 | IP-адрес четвёртого DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
Примечание:
Для поддержки DNS могут быть бесплатно использованы сервера
RegTime.Net. Если не заполнить поля ns0, ns1 - то автоматически будут использованы эти сервера.
При этом на данных
серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии
можно будет через web-интерфейс портала regmy.ru.
| Имя поля | Мин. длина | Макс. длина | Описание поля |
|---|---|---|---|
| period | 1 | 2 | Период, на который производится регистрация домена. Интервал допустимых значений: 1 - 10 |
| Данные владельца домена | |||
| o_company | 5 | 80 | Название организации - владельца домена. Указывать "Private person" в случае, если владельцем является частное лицо. |
| o_first_name | 2 | 40 | Имя контактного лица |
| o_last_name | 2 | 40 | Фамилия контактного лица |
| o_email | 6 | 90 | Контактный email-адрес владельца домена. |
| o_phone | 8 | 20 | Номер телефона владельца домена в международном формате (Пример: +7.4952171179). |
| o_fax | 8 | 20 | Номер факса владельца домена в международном формате (Пример: +7.4952171179). Необязательное поле. |
| o_addr | 8 | 80 | Адрес владельца домена: улица, дом, офис (квартира) |
| o_city | 2 | 80 | Адрес владельца домена: город |
| o_state | 2 | 40 | Адрес владельца домена: область/край/штат |
| o_postcode | 3 | 10 | Почтовый индекс владельца домена |
| o_country_code | 2 | 2 | Двухбуквенный ISO-код страны владельца домена. Список всех кодов стран можно найти тут |
| Данные администратора домена | |||
| a_company | 5 | 80 | Организация - администратор домена. Указывать "Private person" в случае, если администратором является частное лицо. |
| a_first_name | 2 | 40 | Имя контактного лица |
| a_last_name | 2 | 40 | Фамилия контактного лица |
| a_email | 6 | 80 | Email-адрес контактного лица |
| a_phone | 8 | 20 | Номер телефона контактного лица в международном формате (Пример: +7.4952171179). |
| a_fax | 8 | 20 | Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле. |
| a_addr | 8 | 80 | Адрес контактного лица: улица, дом, офис (квартира) |
| a_city | 2 | 80 | Адрес контактного лица: город |
| a_state | 2 | 40 | Адрес контактного лица: область/край/штат |
| a_postcode | 3 | 10 | Почтовый индекс контактного лица |
| a_country_code | 2 | 2 | Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут |
| Данные техподдержки домена | |||
| t_company | 5 | 80 | Организация, осуществляющая техподдержку домена. Указывать "Private person" в случае, если техподдержку осуществляет частное лицо. |
| t_first_name | 2 | 40 | Имя контактного лица |
| t_last_name | 2 | 40 | Фамилия контактного лица |
| t_email | 6 | 80 | Email-адрес контактного лица |
| t_phone | 8 | 20 | Номер телефона контактного лица в международном формате (Пример: +7.4952171179). |
| t_fax | 8 | 20 | Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле. |
| t_addr | 8 | 80 | Адрес контактного лица: улица, дом, офис (квартира) |
| t_city | 2 | 80 | Адрес контактного лица: город |
| t_state | 2 | 40 | Адрес контактного лица: область/край/штат |
| t_postcode | 3 | 10 | Почтовый индекс контактного лица |
| t_country_code | 2 | 2 | Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут |
| DNS-серверы домена (должно быть указано не менее двух серверов) | |||
| ns0 | 6 | 80 | Имя хоста первого DNS-сервера. |
| ns1 | 6 | 80 | Имя хоста второго DNS-сервера. |
| ns2 | 6 | 80 | Имя хоста третьего DNS-сервера. |
| ns3 | 6 | 80 | Имя хоста четвёртого DNS-сервера. |
| ns0ip | 8 | 15 | IP-адрес первого DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns1ip | 8 | 15 | IP-адрес второго DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns2ip | 8 | 15 | IP-адрес третьего DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns3ip | 8 | 15 | IP-адрес четвёртого DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
Примечание:
Для поддержки DNS могут быть бесплатно использованы сервера
RegTime.Net. Если не заполнить поля ns0, ns1 - то автоматически будут использованы эти сервера.
При этом на данных
серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии
можно будет через web-интерфейс портала Regmy.ru.
| Ответ системы | Описание |
|---|---|
| Success: Registered <domain name> for <years> years | Заявка на регистрацию домена была успешно принята. |
| Success: Transfer request accepted for <domain name> | Заявка на перенос домена была успешно принята. |
| Error: Unavailable Domain Name | Домен уже зарегистрирован или не соответствует формальным требованиям, предъявляемым к доменам в этой зоне. |
| Error: Invalid name servers | Указанные DNS-сервера не верны (например, указан всего один DNS-сервер или сервера не зарегистрированы в базе NSI-registry). |
| Error: Domain already ordered | Заявка на регистрацию этого домена уже присутствует в системе. Повторная заявка на одно и то же имя не допускается. |
См. также: Общие сообщения об ошибках
Далее описаны различные операции по обслуживанию / изменению настроек доменов, которые могут быть осуществлены через HTTP-шлюз.
Эта операция позволяет проверить доступность доменного имени для
регистрации.
В качестве значения параметра tipzapr для этой операции
должно быть указано Trans_Create.
Дополнительных полей кроме общих обязательных полей для этой операции не требуется.
Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:
| Ответ системы | Описание |
|---|---|
| Success: <domain name> is Available | Означает, что домен доступен для регистрации. |
| Success: <domain name> is Unavailable | Означает, что домен НЕ доступен для регистрации. |
См. также: Общие сообщения об ошибках
Эта операция позволяет подать заявку на продление регистрации домена.
В
качестве значения параметра tipzapr для этой операции должно быть
указано Edit_Srok_Deg.
Ниже перечислены дополнительные поля,
которые наряду с общими
обязательными полями требуются для этой операции.
| Имя поля | Мин. длина | Макс. длина | Описание поля |
|---|---|---|---|
| period | 1 | 2 | Период продления регистрации домена. Для доменов .ru и .su единственное допустимое значение: 1, для прочих доменов интервал допустимых значений: 1 - 10. Заявка на продление домена .ru или .su может быть подана не ранее чем за два месяца до окончания делегирования домена. |
Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:
| Ответ системы | Описание |
|---|---|
| Success: Renewed <domain name> for <years> years | Заявка на продление домена успешно принята. |
См. также: Общие сообщения об ошибках
Эта операция позволяет сменить список DNS-серверов домена, находящегося под Вашим управлением. В качестве значения параметра tipzapr для этой операции должно быть указано Edit_NS.
Важно: Как минимум два DNS-сервера должно быть указано. Максимальное количество DNS-серверов - 4. Если имена хостов DNS-серверов содержат имя самого домена (например, домен example.com обслуживается на DNS-серверах ns1.example.com и ns2.example.com), то для этих серверов обязательно должны быть указаны IP-адреса.
Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями
| Имя поля | Мин. длина | Макс. длина | Описание поля |
|---|---|---|---|
| ns0 | 6 | 80 | Имя хоста первого DNS-сервера. |
| ns1 | 6 | 80 | Имя хоста второго DNS-сервера. |
| ns2 | 6 | 80 | Имя хоста третьего DNS-сервера. |
| ns3 | 6 | 80 | Имя хоста четвёртого DNS-сервера. |
| ns0ip | 8 | 15 | IP-адрес первого DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns1ip | 8 | 15 | IP-адрес второго DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns2ip | 8 | 15 | IP-адрес третьего DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
| ns3ip | 8 | 15 | IP-адрес четвёртого DNS-сервера. Необязательное поле. Используется только если имя DNS-сервера содержит имя регистрируемого домена |
Примечание:
Для поддержки DNS могут быть бесплатно использованы сервера
RegTime.Net. Если не заполнить поля ns0, ns1 - то автоматически будут использованы эти сервера.
При этом на данных
серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии
можно будет через web-интерфейс портала regmy.ru.
Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:
| Ответ системы | Описание |
|---|---|
| Success: Redelegated <domain name> to <name server list> | Означает, что домен успешно переделегирован на новые сервера имён |
| Error: Invalid name servers | Сервера имён не существуют или указаны неверно |
См. также: Общие сообщения об ошибках
Эта операция позволяет изменить контактные данные владельца домена.
В
качестве значения параметра tipzapr для этой операции должно быть
указано Edit_Dom_RU_PP.
| Имя поля | Мин. длина | Макс. длина | Описание поля |
|---|---|---|---|
| descr | 5 | 255 | Описание домена. Заполняется по-английски (для доменов .SU). Необязательное поле. |
| Контактные данные частного лица (только при регистрации домена на частное лицо!) | |||
| person | 8 | 64 | Имя, первая буква отчества (без точки) и фамилия администратора
домена, записанные латинскими буквами. Предназначено для использования
сервисом 'whois'. Для иностранцев поле содержит имя в оригинальном
написании (или в английской транскрипции). Пример: Vassily N Pupkin |
| person_r | 9 | 64 | Фамилия, имя и отчество администратора домена на русском языке в
соответствии с паспортными данными. Для иностранцев поле содержит имя в
оригинальном написании (при невозможности в английской
транскрипции). Пример1: Пупкин Василий Николаевич Пример2: John Smith |
| passport | 15 | 255 много- строчное |
Серия и номер паспорта, а также наименование органа, выдавшего
паспорт, и дата выдачи (в указанной последовательности, с разделением
пробелами). В написании римских цифр допустимо использование только
латинских букв. Дата записывается в формате ДД.ММ.ГГГГ. Знак номера перед
номером паспорта не ставится. Паспорта СССР (паспорта старого образца) не
принимаются. В случае использования документа, отличного от паспорта
(допустимо ТОЛЬКО для нерезидентов России), в начале строки указывается
наименование вида документа. Запись может быть
многострочной. Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990 |
| residence | 20 | 255 много- строчное |
Адрес места проживания администратора домена на русском языке. Адрес
аналогичен ранее существовашей прописке и адресу регистрации, указываемого
в паспорте. Запись может быть многострочной. Пример: 101000, Москва, ул.Воробьянинова, 15,\n кв.22, В. Лоханкину. |
| birth_date | 10 | 10 | Дата рождения администратора домена в формате
ДД.ММ.ГГГГ. Пример: 07.11.1917 |
| country | 2 | 2 | Двухбуквенный ISO-код страны, гражданином которой является частное
лицо Пример: RU |
| p_address | 15 | 255 много- строчное |
Почтовый адрес администратора домена на русском языке. (Адрес может не
совпадать с указанным в паспорте местом регистрации.) Запись может быть
многострочной. Пример: 101000, Москва, ул.Воробьянинова, 15,\n кв.22, В. Лоханкину. |
| phone | 8 | 255 много- строчное |
Номер телефона администратора домена. Телефон указывается с
международным кодом (включая символ +); международный код, код города и
местный номер разделяются пробелами. Скобки и тире не допускаются. Запись
может быть многострочной. Пример: +7 495 8102233\n+7 3432 811221 |
| fax | 8 | 255 много- строчное |
Номер телефакса администратора домена. Номер телефакса указывается с
международным кодом (включая символ +); международный код, код города и
местный номер разделяются пробелами. Скобки и тире не допускаются. Запись
может быть многострочной. Пример: +7 3432 811221\n+7 495 5555342 |
| e_mail | 6 | 255 много- строчное |
Адрес электронной почты администратора домена в формате RFC-822.
Запись может быть многострочной. Пример: ncc@test.ru\ntest@test.ru |
| code | 12 | 12 | Идентификационный номер налогоплательщика (ИНН), присвоенный
администратору домена. Параметр указывается только в том случае, если
администратор выступает как индивидуальный предприниматель. Пример: 789012345678 |
| Имя поля | Мин. длина | Макс. длина | Описание поля |
|---|---|---|---|
| Данные владельца домена | |||
| o_first_name | 2 | 40 | Имя контактного лица |
| o_last_name | 2 | 40 | Фамилия контактного лица |
| o_email | 6 | 90 | Контактный email-адрес владельца домена. |
| o_phone | 8 | 20 | Номер телефона владельца домена в международном формате (Пример: +7.4952171179). |
| o_fax | 8 | 20 | Номер факса владельца домена в международном формате (Пример: +7.4952171179). Необязательное поле. |
| o_addr | 8 | 80 | Адрес владельца домена: улица, дом, офис (квартира) |
| o_city | 2 | 80 | Адрес владельца домена: город |
| o_state | 2 | 40 | Адрес владельца домена: область/край/штат |
| o_postcode | 3 | 10 | Почтовый индекс владельца домена |
| o_country_code | 2 | 2 | Двухбуквенный ISO-код страны владельца домена. Список всех кодов стран можно найти тут |
| Данные администратора домена | |||
| a_company | 5 | 80 | Организация - администратор домена. Указывать "Private person" в случае, если администратором является частное лицо. |
| a_first_name | 2 | 40 | Имя контактного лица |
| a_last_name | 2 | 40 | Фамилия контактного лица |
| a_email | 6 | 80 | Email-адрес контактного лица |
| a_phone | 8 | 20 | Номер телефона контактного лица в международном формате (Пример: +7.4952171179). |
| a_fax | 8 | 20 | Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле. |
| a_addr | 8 | 80 | Адрес контактного лица: улица, дом, офис (квартира) |
| a_city | 2 | 80 | Адрес контактного лица: город |
| a_state | 2 | 40 | Адрес контактного лица: область/край/штат |
| a_postcode | 3 | 10 | Почтовый индекс контактного лица |
| a_country_code | 2 | 2 | Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут |
| Данные техподдержки домена | |||
| t_company | 5 | 80 | Организация, осуществляющая техподдержку домена. Указывать "Private person" в случае, если техподдержку осуществляет частное лицо. |
| t_first_name | 2 | 40 | Имя контактного лица |
| t_last_name | 2 | 40 | Фамилия контактного лица |
| t_email | 6 | 80 | Email-адрес контактного лица |
| t_phone | 8 | 20 | Номер телефона контактного лица в международном формате (Пример: +7.4952171179). |
| t_fax | 8 | 20 | Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле. |
| t_addr | 8 | 80 | Адрес контактного лица: улица, дом, офис (квартира) |
| t_city | 2 | 80 | Адрес контактного лица: город |
| t_state | 2 | 40 | Адрес контактного лица: область/край/штат |
| t_postcode | 3 | 10 | Почтовый индекс контактного лица |
| t_country_code | 2 | 2 | Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут |
Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:
| Ответ системы | Описание |
|---|---|
| Success: Modified contact details for <domain name> | Операция произведена успешно |
См. также: Общие сообщения об ошибках