Описание API системы регистрации доменов REG.RU

by Walery Studennikov <despair@cpan.org>

Содержание

Введение
Описание HTTP-Post шлюза
Отправка HTTP-Post запросов
3.1. Операции

3.2. Формат входных данных

3.3. Общие поля запросов

3.4. Общие сообщения об ошибках

3.5. Расширенные ответы системы
Операции с доменами
4.1. Регистрация и перенос доменов

4.1.1. Регистрация доменов .ru и .su

4.1.2. Регистрация в других зонах

4.1.3. Перенос домена от другого регистратора

4.1.4. Ответы системы

4.2. Продление регистрации домена

4.3. Проверка доступности домена для регистрации

4.4. Получение данных WHOIS домена

4.5. Смена списка DNS-серверов домена

4.6. Смена данных владельца домена

4.7. Получение информации о статусе домена

4.8. Дать полномочия по управлению доменом другому пользователю

4.9. Забрать полномочия по управлению доменом от другого пользователя

4.10. Получение информации о домене

4.11. Получение данных владельца домена

4.12. Получение списка DNS-серверов домена
Операции по работе с зоной
5.1. Добавление ресурсной записи

5.2. Удаление записи

5.3. Обновление зоны

5.4. Настройка зоны для парковки

5.5. Настройка зоны для хостинга

5.6. Получение информации о зоне
Прочие операции
6.1. Проверка баланса пользователя

6.2. Выписка счёта на предоплату (пополнение баланса)
Примеры

1. Введение

Это справочное руководство описывает HTTP-шлюз к системе распределённой регистрации Reg.Ru (далее RegruSRS) версии 1.0.0.
HTTP-шлюз — это метод взаимодействия с системой распределённой регистрации RegRuSRS, позволяющий осуществлять операции в реальном времени за один шаг.

Для осуществления одношаговых (одноэтапных) операций, вся информация должна быть представлена в одном единственном HTTP-запросе. В интерфейсе RegRuSRS нет понятия "состояния" и все запросы независимы друг от друга. HTTP-интерфейс поддерживает такие операции как регистрация домена, смена DNS серверов домена, проверка доступности домена, смена регистрационных данных домена и т.п. Доступные операции описаны ниже в этом документе.

2. Описание HTTP-Post шлюза

Компания REG.RU предоставляет не только "боевой" доступ к HTTP-шлюзу для осуществления реальных операций, но также и тестовый доступ для отладки взаимодействия с системой RegRuSRS.

2.1. Реальный ("боевой") доступ

Запросы к HTTP-шлюзу должны направляться на URL

https://www.reg.ru/api/regru

или

http://www.reg.ru/api/regru

Среднее время ответа при нормальных нагрузках сервера должно быть не более 5 или 10 секунд.

Предупреждение:: Не устанавливайте для Ваших клиентов web-формы, содержащие Ваши авторизационные данные, т.к. клиенты могут легко узнать Ваш login и пароль. Для обеспечения безопасности, запросы должны отправляться программой на стороне сервера.

Все запросы должны удовлетворять спецификации HTTP/1.0 или HTTP/1.1, описанной в RFC 1945:

http://www.ics.uci.edu/pub/ietf/http/rfc1945.html

2.2. Тестовый доступ

REG.RU предоставляет тестовый доступ к своему шлюзу для тестирования системы регистрации. Отличия тестового доступа от реального таковы:

Плата за операции не взимается
Операции с доменами реально не производятся, домены не регистрируются
Тестовая система не содержит информации о доменах, которая присутствует в реальном реестре.

Для использования тестовой системы, HTTP-Post запросы должны направляться на тот же URL, что и для реальной системы. При этом используются следующие авторизационные данные:

username: test
password: test

2.3. Ограничения по использованию интерфейса

При использовании интерфейса RegRuSRS клиентом должен быть соблюдён ряд ограничений.

Количество запросов, отправляемых через шлюз одним пользователем, а также подаваемых с одного IP-адреса ограничено: может быть подано не более 1200 запросов в час. В случае превышения лимита — последующие заявки отклоняются на соответствующий период (1 час).
Одновременная (параллельная) подача нескольких запросов одного пользователя через шлюз запрещена.
Создание чрезмерной нагрузки на оборудование Регистратора (посредством чрезмерно интенсивных запросов к интерфейсу или любым иным образом) является основанием для прекращения предоставления доступа к сервису. В случае, если чрезмерная нагрузка на оборудование повлекла за собой сбои в его работе, и, как следствие, прямые или косвенные убытки для Регистратора — Регистратор оставляет за собой право для юридического преследования лиц, ответственных за действия, приведшие к сбоям.

3. Отправка HTTP-Post запросов

3.1. Операции

HTTP-шлюз позволяет осуществлять различные операции. В таблице ниже приведён список операций, которые могут быть осуществлены с использованием HTTP-шлюза. Для каждой операции требуется указание различных параметров (полей), которые описаны ниже в этом документе.

Операция
(значение action) Описание Примеры Разрешения

Операции с доменами (см. раздел 4)

domain_create Подать заявку на регистрацию домена gtld, ru_org, ru_pp

domain_trans_in Подать заявку на перенос домена от другого регистратора gtld, ru

domain_check Проверка доступности домена для регистрации Пример Все

domain_whois Получение данных WHOIS для домена Пример Все

domain_renew Продление регистрации домена Пример Вл.

domain_update_nss Смена списка DNS-серверов домена Пример Вл., ПЧУ

domain_update_contacts Смена данных владельца домена gtld, ru_org, ru_pp Вл., ПЧУ

domain_delete Отмена регистрации домена Не реализовано Вл.

domain_owner_change Смена владельца домена Не реализовано Вл.

domain_partcontrol_grant Дать полномочия по управлению доменом другому пользователю Пример Вл.

domain_partcontrol_revoke Забрать полномочия по управлению доменом от другого пользователя Пример Вл.

domain_get_approval_status Получение статуса ручной проверки данных владельца Пример Вл., ПЧУ

domain_get_info Получение информации о домене Пример Вл., ПЧУ

domain_get_contacts Получение данных владельца домена Пример Вл., ПЧУ

domain_get_nss Получение списка DNS-серверов домена Пример Вл., ПЧУ

domain_ns_register Зарегистрировать DNS-сервер в NSI-registry (для .com, .net, .org) Не реализовано Вл., ПЧУ

domain_ns_unregister Удалить регистрацию DNS-сервера из NSI-registry (для .com, .net, .org) Не реализовано Вл., ПЧУ

Операции по управлению зоной (см. раздел 5)

zone_add_rr Добавление ресурсной записи A, CNAME, MX, NS, TXT Вл., ПЧУ

zone_rm_rr Удаление записи Пример Вл., ПЧУ

zone_update Обновление зоны Пример Вл., ПЧУ

zone_tune_park Настройка зоны для парковки Не реализовано Вл., ПЧУ

zone_tune_host Настройка зоны для хостинга Не реализовано Вл., ПЧУ

zone_get_info Получение информации о зоне Не реализовано Вл., ПЧУ

Прочие операции (см. раздел 6)

balance_refill Выписка счёта на предоплату (пополнение баланса) Пример Польз./td>

balance_get Получение значения текущего баланса Пример Польз./td>

Операция (значение action)	Описание	Примеры	Разрешения
Операции с доменами (см. раздел 4)
domain_create	Подать заявку на регистрацию домена	gtld, ru_org, ru_pp
domain_trans_in	Подать заявку на перенос домена от другого регистратора	gtld, ru
domain_check	Проверка доступности домена для регистрации	Пример	Все
domain_whois	Получение данных WHOIS для домена	Пример	Все
domain_renew	Продление регистрации домена	Пример	Вл.
domain_update_nss	Смена списка DNS-серверов домена	Пример	Вл., ПЧУ
domain_update_contacts	Смена данных владельца домена	gtld, ru_org, ru_pp	Вл., ПЧУ
domain_delete	Отмена регистрации домена	Не реализовано	Вл.
domain_owner_change	Смена владельца домена	Не реализовано	Вл.
domain_partcontrol_grant	Дать полномочия по управлению доменом другому пользователю	Пример	Вл.
domain_partcontrol_revoke	Забрать полномочия по управлению доменом от другого пользователя	Пример	Вл.
domain_get_approval_status	Получение статуса ручной проверки данных владельца	Пример	Вл., ПЧУ
domain_get_info	Получение информации о домене	Пример	Вл., ПЧУ
domain_get_contacts	Получение данных владельца домена	Пример	Вл., ПЧУ
domain_get_nss	Получение списка DNS-серверов домена	Пример	Вл., ПЧУ
domain_ns_register	Зарегистрировать DNS-сервер в NSI-registry (для .com, .net, .org)	Не реализовано	Вл., ПЧУ
domain_ns_unregister	Удалить регистрацию DNS-сервера из NSI-registry (для .com, .net, .org)	Не реализовано	Вл., ПЧУ
Операции по управлению зоной (см. раздел 5)
zone_add_rr	Добавление ресурсной записи	A, CNAME, MX, NS, TXT	Вл., ПЧУ
zone_rm_rr	Удаление записи	Пример	Вл., ПЧУ
zone_update	Обновление зоны	Пример	Вл., ПЧУ
zone_tune_park	Настройка зоны для парковки	Не реализовано	Вл., ПЧУ
zone_tune_host	Настройка зоны для хостинга	Не реализовано	Вл., ПЧУ
zone_get_info	Получение информации о зоне	Не реализовано	Вл., ПЧУ
Прочие операции (см. раздел 6)
balance_refill	Выписка счёта на предоплату (пополнение баланса)	Пример	Польз./td>
balance_get	Получение значения текущего баланса	Пример	Польз./td>

Пояснения по колонке "Разрешения":

"Все" — Любой пользователь, в т.ч. с использованием полномичий тестового экканута
"Польз." — Любой зарегистрированный пользователь
"Вл." — Только владелец домена (владелец эккаунта, на котором зарегистрирован домен, для которого совершается операция)
"ПЧУ" — Пользователь, которому данный домен дан в частичное управление.

3.2. Формат входных данных

Команды на осуществление операций передаются в виде стандартного запроса HTTP/1.0 POST. Параметры операции передаются в виде HTTP параметров. При этом действуют следующие правила:

Значения всех полей, если не указано особо, являются строками.
Значения полей передаются в кодировке windows-1251.
Все требуемые поля должны присутствовать в запросе и должны содержать как минимум один символ.
Значения полей не должны превышать допустимую длину.
Названия параметров HTTP-запроса должны в точности соответствовать названиям полей с учётом регистра символов.
Некоторые поля могут быть "многострочными" (состоящими из нескольких строк, отделённых друг от друга символом возврата каретки). В примерах, приводимых в этом документе, символ возврата каретки обозначен последовательностью символов "\n".

3.3. Общие поля запросов

В таблице перечислены все обязательные поля, которые должны присутствовать в КАЖДОМ запросе.

Имя поля Макс. длина Описание

action 80 Определяет операцию, которая должна быть произведена, например domain_check

username 80 Имя пользователя (login) в системе регистрации RegRuSRS.

password 80 Пароль пользователя (password) в системе регистрации RegRuSRS.

domain_name 67 Полное имя домена, с которым производится операция, например example.com. Максимальная длина - 67 символов (63 + 4). Допустимы алфавитно-цифровые символы и символ дефиса. Русские имена доменов указываются в кодировке windows-1251 (CP1251).

extended_message_lang 2 Язык расширенных сообщений об ошибках ('ru', 'en' либо не указывается). Подробности см. разделе 3.5

fail_if_no_money 1 Возвращать ошибку, если денег на лицевом счёте для исполнения заявки недостаточно. По умолчанию (если данный флаг не выставлен) заявка в системе создаётся, однако эта заявка будет исполнена только после выполнения операции "сменить способ оплаты счёта" через web-интерфейс системы.

no_bill_notify 1 Не высылать уведомление по электронной почте о заказе.
По умолчанию для каждого нового заказа (любая операция по регистрации, переносу и продлению домена регистрируется как отдельный заказ в системе регистрации) отсылвается уведомление на email, указанный в настройках эккаунта партнёра. Если выставлен флаг no_bill_notify — уведомление по email не отсылается.

Имя поля	Макс. длина	Описание
action	80	Определяет операцию, которая должна быть произведена, например domain_check
username	80	Имя пользователя (login) в системе регистрации RegRuSRS.
password	80	Пароль пользователя (password) в системе регистрации RegRuSRS.
domain_name	67	Полное имя домена, с которым производится операция, например example.com. Максимальная длина - 67 символов (63 + 4). Допустимы алфавитно-цифровые символы и символ дефиса. Русские имена доменов указываются в кодировке windows-1251 (CP1251).
extended_message_lang	2	Язык расширенных сообщений об ошибках ('ru', 'en' либо не указывается). Подробности см. разделе 3.5
fail_if_no_money	1	Возвращать ошибку, если денег на лицевом счёте для исполнения заявки недостаточно. По умолчанию (если данный флаг не выставлен) заявка в системе создаётся, однако эта заявка будет исполнена только после выполнения операции "сменить способ оплаты счёта" через web-интерфейс системы.
no_bill_notify	1	Не высылать уведомление по электронной почте о заказе. По умолчанию для каждого нового заказа (любая операция по регистрации, переносу и продлению домена регистрируется как отдельный заказ в системе регистрации) отсылвается уведомление на email, указанный в настройках эккаунта партнёра. Если выставлен флаг no_bill_notify — уведомление по email не отсылается.

3.4. Общие сообщения об ошибках

Ниже перечислены сообщения об ошибках системы RegRuSRS, общие для всех операций:

Текст ошибки Описание

Error: no username given Значение поля "username" не указано.

Error: no password given Значение поля "password" не указано.

Error: no action given Значение поля "action" не указано.

Error: username/password Incorrect Такого пользователя не существует либо пароль пользователя указан неверно.

Error: domain_name is invalid Значение поля "domain_name" не указано или указано неверно: т.е. содержит недопустимые символы, превышает допустимую длину и т.п.

Error: <domain name> not found Домен не существует или информация WHOIS по этому домену ещё не доступна.

Error: Domain name <domain name> not found or not owned by you Указанный домен не найден в системе, либо принадлежит другому пользователю.

Error: The following fields are invalid: <fields list> Значения перечисленных полей неверны. Исправьте данные и повторите запрос.

Error: Unknown action: <action> Неверный / несуществующий код операции (функции).

Error: System Unavailable Шлюз RegRuSRS не доступен. Операция не была произведена и запрос должен быть подан повторно.

Error: Internal error\n<error msg> Внутренняя ошибка системы RegRuSRS. Пожалуйста, свяжитесь с REG.RU (support@reg.ru) для решения проблемы.

Текст ошибки	Описание
Error: no username given	Значение поля "username" не указано.
Error: no password given	Значение поля "password" не указано.
Error: no action given	Значение поля "action" не указано.
Error: username/password Incorrect	Такого пользователя не существует либо пароль пользователя указан неверно.
Error: domain_name is invalid	Значение поля "domain_name" не указано или указано неверно: т.е. содержит недопустимые символы, превышает допустимую длину и т.п.
Error: <domain name> not found	Домен не существует или информация WHOIS по этому домену ещё не доступна.
Error: Domain name <domain name> not found or not owned by you	Указанный домен не найден в системе, либо принадлежит другому пользователю.
Error: The following fields are invalid: <fields list>	Значения перечисленных полей неверны. Исправьте данные и повторите запрос.
Error: Unknown action: <action>	Неверный / несуществующий код операции (функции).
Error: System Unavailable	Шлюз RegRuSRS не доступен. Операция не была произведена и запрос должен быть подан повторно.
Error: Internal error\n<error msg>	Внутренняя ошибка системы RegRuSRS. Пожалуйста, свяжитесь с REG.RU (support@reg.ru) для решения проблемы.

3.5. Расширенные ответы системы

Если указано значение поля "extended_message_lang", система выдаёт расширенные сообщения об успешных операциях и ошибках на указанном языке ('ru' или 'en') Если поле "extended_message_lang" отсутствует в запросе, то расширенные сообщения не возвращаются.

Подробности о режиме расширенных сообщений:
В данном режиме поддерживаются многострочные сообщения о выполненных операциях и об ошибках. Первая строчка имеет строгий формат, описанный в этом документе в списке возможных ответов системы для каждой команды.
За первой строчкой могут следовать (но не обязательно следуют) дополнительные строчки с развёрнутым описанием ошибки системы или комментария к операции. Формат описания свободный (не регламентирован) и предназначен для расшифровки ответов системы в удобной для восприятия человеком форме.
Язык развёрнутых сообщений об зависит от значения поля "extended_message_lang", присутствующего в запросе. Допускаются русский ('ru') и английский ('en') языки.

4. Операции с доменами

4.1. Регистрация и перенос доменов

4.1.1. Регистрация доменов .ru и .su

<> Эта операция служит для регистрации доменов в зонах .ru и .su. В качестве значения поля action для этой операции должно быть указано domain_create.
Ниже перечислены значения других полей для этой операции.
Обратите внимание, что в этой операции допустимо использовать один из двух взаимоисключающих наборов полей — данные организации (если домен регистрируется на организацию) либо данные частного лица (если домен регистрируется на частное лицо).
Некоторые поля, обозначенные особо, могут быть многострочными.

[% BLOCK ru_contacts %] [% END # ru_contacts %] [% PROCESS ru_contacts %] [% BLOCK dns_servers %] [% UNLESS chgdns %] [% END %] [% END # dns_servers %] [% PROCESS dns_servers %]

Имя поля Мин. длина Макс. длина Описание поля

period 1 2 Период, на который производится регистрация домена. Единственное допустимое значение для доменов .ru и .su: 1.
descr 5 255 Описание домена. Заполняется по-английски. Необязательное поле.

Контактные данные организации (только при регистрации домена на организацию!)

org 6 255
много-
строчное Полное наименование организации - администратора домена латинскими буквами, предназначенное для использования сервисом 'whois'. Запись может быть многострочной.
Пример1: Karla-Marla Uryupinsk State University
Пример2: "ROGA I KOPYTA", LTD.

org_r 10 255
много-
строчное Полное наименование организации - администратора домена на русском языке в соответствии с учредительными документами. Для нерезидентов указывается написание на национальном языке (либо на английском языке). Запись может быть многострочной.
Пример1: Урюпинский государственный университет\nимени Карлы-Марлы
Пример2: Общество с ограниченной ответственностью "Рога и Копыта"

code 10 10 Идентификационный номер налогоплательщика (ИНН), присвоенный организации-администратору. Запись может содержать пустую строку, если администратором является нерезидент РФ, не имеющий идентификационного номера налогоплательщика.
Пример: 7701107259

kpp 9 9 КПП организации (для Российских организаций). Необязательное поле.
Пример: 632946014

country 2 2 Двухбуквенный ISO-код страны, в которой зарегистрирована организация
Пример: RU

address_r 15 255
много-
строчное Юридический адрес организации в соответствии с учредительными документами. Запись может быть многострочной.
Пример: 101000, Москва, ул.Пупкина, 1, стр. 2

p_addr 15 255
много-
строчное Почтовый адрес организации - администратора домена. Запись может быть многострочной.
Пример: 101000, Москва, ул.Пупкина, 1, стр. 2, отдел мебели,\n офис 433 (для В. Лоханкина)

phone 8 255
много-
строчное Номер телефона администратора домена. Телефон указывается с международным кодом (включая символ +); международный код, код города и местный номер разделяются пробелами. Скобки и дефисы не допускаются. Запись может быть многострочной.
Пример: +7 495 8102233\n+7 3432 811221

fax 8 255
много-
строчное Номер телефакса администратора домена. Номер телефакса указывается с международным кодом (включая символ +); международный код, код города и местный номер разделяются пробелами. Скобки и тире не допускаются. Запись может быть многострочной. Запись не является обязательной. Пример: +7 3432 811221\n+7 495 8102233

e_mail 6 255
много-
строчное Адрес электронной почты администратора домена в формате RFC-822. Запись может быть многострочной. Пример: ncc@test.ru\ntest@test.ru

Контактные данные частного лица (только при регистрации домена на частное лицо!)

person 8 64 Имя, первая буква отчества (без точки) и фамилия администратора домена, записанные латинскими буквами. Предназначено для использования сервисом 'whois'. Для иностранцев поле содержит имя в оригинальном написании (или в английской транскрипции).
Пример: Vassily N Pupkin

person_r 9 64 Фамилия, имя и отчество администратора домена на русском языке в соответствии с паспортными данными. Для иностранцев поле содержит имя в оригинальном написании (при невозможности в английской транскрипции).
Пример1: Пупкин Василий Николаевич
Пример2: John Smith

passport 20 255
много-
строчное Серия и номер паспорта, а также наименование органа, выдавшего паспорт, и дата выдачи (в указанной последовательности, с разделением пробелами). В написании римских цифр допустимо использование только латинских букв. Дата записывается в формате ДД.ММ.ГГГГ. Знак номера перед номером паспорта не ставится. Паспорта СССР (паспорта старого образца) не принимаются. В случае использования документа, отличного от паспорта (допустимо ТОЛЬКО для нерезидентов России), в начале строки указывается наименование вида документа. Запись может быть многострочной.
Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990

birth_date 10 10 Дата рождения администратора домена в формате ДД.ММ.ГГГГ.
Пример: 07.11.1917

country 2 2 Двухбуквенный ISO-код страны, гражданином которой является частное лицо
Пример: RU

p_addr 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-сервера. [% UNLESS chgdns %][% END %]

ns1 6 80 Имя хоста второго DNS-сервера. [% UNLESS chgdns %][% END %]

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-сервера содержит имя регистрируемого домена
[% BLOCK dns_rdap %]

Имя поля	Мин. длина	Макс. длина	Описание поля
period	1	2	Период, на который производится регистрация домена. Единственное допустимое значение для доменов .ru и .su: 1.
descr	5	255	Описание домена. Заполняется по-английски. Необязательное поле.
Контактные данные организации (только при регистрации домена на организацию!)
org	6	255 много- строчное	Полное наименование организации - администратора домена латинскими буквами, предназначенное для использования сервисом 'whois'. Запись может быть многострочной. Пример1: Karla-Marla Uryupinsk State University Пример2: "ROGA I KOPYTA", LTD.
org_r	10	255 много- строчное	Полное наименование организации - администратора домена на русском языке в соответствии с учредительными документами. Для нерезидентов указывается написание на национальном языке (либо на английском языке). Запись может быть многострочной. Пример1: Урюпинский государственный университет\nимени Карлы-Марлы Пример2: Общество с ограниченной ответственностью "Рога и Копыта"
code	10	10	Идентификационный номер налогоплательщика (ИНН), присвоенный организации-администратору. Запись может содержать пустую строку, если администратором является нерезидент РФ, не имеющий идентификационного номера налогоплательщика. Пример: 7701107259
kpp	9	9	КПП организации (для Российских организаций). Необязательное поле. Пример: 632946014
country	2	2	Двухбуквенный ISO-код страны, в которой зарегистрирована организация Пример: RU
address_r	15	255 много- строчное	Юридический адрес организации в соответствии с учредительными документами. Запись может быть многострочной. Пример: 101000, Москва, ул.Пупкина, 1, стр. 2
p_addr	15	255 много- строчное	Почтовый адрес организации - администратора домена. Запись может быть многострочной. Пример: 101000, Москва, ул.Пупкина, 1, стр. 2, отдел мебели,\n офис 433 (для В. Лоханкина)
phone	8	255 много- строчное	Номер телефона администратора домена. Телефон указывается с международным кодом (включая символ +); международный код, код города и местный номер разделяются пробелами. Скобки и дефисы не допускаются. Запись может быть многострочной. Пример: +7 495 8102233\n+7 3432 811221
fax	8	255 много- строчное	Номер телефакса администратора домена. Номер телефакса указывается с международным кодом (включая символ +); международный код, код города и местный номер разделяются пробелами. Скобки и тире не допускаются. Запись может быть многострочной. Запись не является обязательной. Пример: +7 3432 811221\n+7 495 8102233
e_mail	6	255 много- строчное	Адрес электронной почты администратора домена в формате RFC-822. Запись может быть многострочной. Пример: ncc@test.ru\ntest@test.ru
Контактные данные частного лица (только при регистрации домена на частное лицо!)
person	8	64	Имя, первая буква отчества (без точки) и фамилия администратора домена, записанные латинскими буквами. Предназначено для использования сервисом 'whois'. Для иностранцев поле содержит имя в оригинальном написании (или в английской транскрипции). Пример: Vassily N Pupkin
person_r	9	64	Фамилия, имя и отчество администратора домена на русском языке в соответствии с паспортными данными. Для иностранцев поле содержит имя в оригинальном написании (при невозможности в английской транскрипции). Пример1: Пупкин Василий Николаевич Пример2: John Smith
passport	20	255 много- строчное	Серия и номер паспорта, а также наименование органа, выдавшего паспорт, и дата выдачи (в указанной последовательности, с разделением пробелами). В написании римских цифр допустимо использование только латинских букв. Дата записывается в формате ДД.ММ.ГГГГ. Знак номера перед номером паспорта не ставится. Паспорта СССР (паспорта старого образца) не принимаются. В случае использования документа, отличного от паспорта (допустимо ТОЛЬКО для нерезидентов России), в начале строки указывается наименование вида документа. Запись может быть многострочной. Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990
birth_date	10	10	Дата рождения администратора домена в формате ДД.ММ.ГГГГ. Пример: 07.11.1917
country	2	2	Двухбуквенный ISO-код страны, гражданином которой является частное лицо Пример: RU
p_addr	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-сервера. [% UNLESS chgdns %][% END %]
ns1	6	80	Имя хоста второго DNS-сервера. [% UNLESS chgdns %][% END %]
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 могут быть бесплатно использованы сервера REG.RU. Для этого в качестве DNS-серверов необходимо указать сервера ns1.nameself.com и ns2.nameself.com.
При этом на данных серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии можно будет через web-интерфейс портала reg.ru. [% END # dns_rdap %] [% PROCESS dns_rdap %]

4.1.2. Регистрация доменов в других зонах

Эта операция позволяет подавать заявки на регистрацию доменов .COM .NET .ORG .BIZ .INFO .BE .CC .TV .РУ .КОМ .НЕТ .ОРГ. Ниже перечислены поля, участвующие в запросе для этой операции.
В качестве значения параметра action для этой операции должно быть установлено domain_create.

[% BLOCK gtld_contacts %] [% END # gtld_contacts %] [% PROCESS gtld_contacts %] [% PROCESS dns_servers %]

Имя поля Мин. длина Макс. длина Описание поля

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-код страны контактного лица. Список всех кодов стран можно найти тут
[% PROCESS dns_rdap %]

Имя поля	Мин. длина	Макс. длина	Описание поля
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-код страны контактного лица. Список всех кодов стран можно найти тут

4.1.3. Перенос домена от другого регистратора

Эта операция позволяет подавать заявки на перенос доменов .COM .NET .ORG .BIZ .INFO .US .RU и .SU от других регистраторов к ООО "Регистратор доменных имён РЕГ.РУ". В качестве значения параметра action для этой операции должно быть установлено domain_trans_in.

Для доменов .RU и .SU данные владельца домена и DNS-сервера не указываются. Эти данные будут автоматически получены из реестра в момент принятия домена. Также для доменов .RU и .SU поле "period" может принимать значение "0" (перенос доменов без продления). Для всех прочих доменов, при переносе указываются все поля, что и для операции регистрации доменов (см. раздел 4.1.2).

4.1.4. Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Registration request accepted for <domain name> for <period> years Заявка на регистрацию домена была успешно принята. При установленном флаге "extended_message_lang" возвращаются дополнительные комментарии о том, достаточно ли средств на лицевом счёте для выполнения операции.
Возможные форматы сообщений: "<XXX> USD (including VAT <YYY> USD) successfully charged", "Order not payed - not enough money at account".

Success: Transfer request accepted for <domain name> Заявка на перенос домена была успешно принята. При установленном флаге "extended_message_lang" возвращаются дополнительные комментарии о том, достаточно ли средств на лицевом счёте для выполнения операции либо сообщение о том, что оплаты не требуется.
Возможные форматы сообщений: "No charge required", "<XXX> USD (including VAT <YYY> USD) successfully charged", "Order not payed - not enough money at account".

Error: Unavailable Domain Name Домен уже зарегистрирован или регистрация домена недоступна по иным причинам.

Error: Registraion via the system unavailable in this TLD Регистрация в данной зоне в данный момент недоступна через систему регистрации RegRuSRS.

Error: Invalid name servers Указанные DNS-сервера не верны (например, указан всего один DNS-сервер или сервера не зарегистрированы в базе NSI-registry).

Error: Domain already ordered Заявка на регистрацию этого домена уже присутствует в системе. Повторная заявка на одно и то же имя не допускается.

Error: Not enough money for operation Недостаточно денег на балансе для выполнения операции. При установленном флаге "extended_message_lang" возвращается также дополнительный комментарий в формате "<XXX> USD needed".

Ответ системы	Описание
Success: Registration request accepted for <domain name> for <period> years	Заявка на регистрацию домена была успешно принята. При установленном флаге "extended_message_lang" возвращаются дополнительные комментарии о том, достаточно ли средств на лицевом счёте для выполнения операции. Возможные форматы сообщений: "`<XXX> USD (including VAT <YYY> USD) successfully charged`", "`Order not payed - not enough money at account`".
Success: Transfer request accepted for <domain name>	Заявка на перенос домена была успешно принята. При установленном флаге "extended_message_lang" возвращаются дополнительные комментарии о том, достаточно ли средств на лицевом счёте для выполнения операции либо сообщение о том, что оплаты не требуется. Возможные форматы сообщений: "`No charge required`", "`<XXX> USD (including VAT <YYY> USD) successfully charged`", "`Order not payed - not enough money at account`".
Error: Unavailable Domain Name	Домен уже зарегистрирован или регистрация домена недоступна по иным причинам.
Error: Registraion via the system unavailable in this TLD	Регистрация в данной зоне в данный момент недоступна через систему регистрации RegRuSRS.
Error: Invalid name servers	Указанные DNS-сервера не верны (например, указан всего один DNS-сервер или сервера не зарегистрированы в базе NSI-registry).
Error: Domain already ordered	Заявка на регистрацию этого домена уже присутствует в системе. Повторная заявка на одно и то же имя не допускается.
Error: Not enough money for operation	Недостаточно денег на балансе для выполнения операции. При установленном флаге "extended_message_lang" возвращается также дополнительный комментарий в формате "`<XXX> USD needed`".

4.2. Продление регистрации домена

Эта операция позволяет подать заявку на продление регистрации домена.
В качестве значения параметра action для этой операции должно быть указано domain_renew.
Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями требуются для этой операции.

Имя поля Мин. длина Макс. длина Описание поля

period 1 2 Период продления регистрации домена. Для доменов .ru и .su единственное допустимое значение: 1, для прочих доменов интервал допустимых значений: 1 - 10. Заявка на продление домена .ru или .su может быть подана не ранее чем за два месяца до окончания делегирования домена.

Имя поля	Мин. длина	Макс. длина	Описание поля
period	1	2	Период продления регистрации домена. Для доменов .ru и .su единственное допустимое значение: 1, для прочих доменов интервал допустимых значений: 1 - 10. Заявка на продление домена .ru или .su может быть подана не ранее чем за два месяца до окончания делегирования домена.

Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Renewed <domain name> for <years> years Заявка на продление домена успешно принята.
При установленном флаге "extended_message_lang" возвращаются дополнительные комментарии о том, достаточно ли средств на лицевом счёте для выполнения операции.
Возможные форматы сообщений: "<XXX> USD (including VAT <YYY> USD) successfully charged", "Order not payed - not enough money at account".

Ответ системы	Описание
Success: Renewed <domain name> for <years> years	Заявка на продление домена успешно принята. При установленном флаге "extended_message_lang" возвращаются дополнительные комментарии о том, достаточно ли средств на лицевом счёте для выполнения операции. Возможные форматы сообщений: "`<XXX> USD (including VAT <YYY> USD) successfully charged`", "`Order not payed - not enough money at account`".

4.3. Проверка доступности домена для регистрации

Эта операция позволяет проверить доступность доменного имени для регистрации.
В качестве значения параметра action для этой операции должно быть указано domain_check.
Дополнительных полей кроме общих обязательных полей для этой операции не требуется.

Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: <domain name> is Available Домен доступен для регистрации.

Success: <domain name> is Unavailable Домен НЕ доступен для регистрации.

Ответ системы	Описание
Success: <domain name> is Available	Домен доступен для регистрации.
Success: <domain name> is Unavailable	Домен НЕ доступен для регистрации.

4.4. Получение информации WHOIS для домена

Эта операция позволяет получить данные WHOIS домена.
В качестве значения параметра action для этой операции должно быть указано domain_whois.
Дополнительных полей кроме общих обязательных полей для этой операции не требуется.

Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Error: <domain name> not found Домен не существует или информация WHOIS по этому домену ещё не доступна.

<raw whois data> Текст с данными WHOIS, возвращаемый в формате HTML. Этот текст может быть без предварительной обработки включён в любую web-страницу без риска нарушения форматирования страницы.

Ответ системы	Описание
Error: <domain name> not found	Домен не существует или информация WHOIS по этому домену ещё не доступна.
<raw whois data>	Текст с данными WHOIS, возвращаемый в формате HTML. Этот текст может быть без предварительной обработки включён в любую web-страницу без риска нарушения форматирования страницы.

4.5. Смена списка DNS-серверов домена

Эта операция позволяет сменить список DNS-серверов домена, находящегося под Вашим управлением. В качестве значения параметра action для этой операции должно быть указано domain_update_nss.

Важно: Как минимум два DNS-сервера должно быть указано. Максимальное количество DNS-серверов — 4. Если имена хостов DNS-серверов содержат имя самого домена (например, домен example.com обслуживается на DNS-серверах ns1.example.com и ns2.example.com), то для этих серверов обязательно должны быть указаны IP-адреса.

Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями

[% PROCESS dns_servers chgdns = 1%]

Имя поля Мин. длина Макс. длина Описание поля
[% PROCESS dns_rdap %]

Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Redelegated <domain name> to <name server list> Домен успешно переделегирован на новые сервера имён

Error: Invalid name servers Сервера имён не существуют или указаны неверно

Ответ системы	Описание
Success: Redelegated <domain name> to <name server list>	Домен успешно переделегирован на новые сервера имён
Error: Invalid name servers	Сервера имён не существуют или указаны неверно

4.6. Смена данных владельца домена

Эта операция позволяет изменить контактные данные владельца домена.
В качестве значения параметра action для этой операции должно быть указано domain_update_contacts.

4.6.1. Смена данных владельца домена .ru или .su

После прохождения ручной проверки данных владельца домена Вы не сможете изменить значения полей "org", "org_r", "code", "address_r", "person", "person_r", "passport", "birth_date" с помощью этой операции. Все изменения в этих полях будут игнорироваться.

[% PROCESS ru_contacts %]

Имя поля Мин. длина Макс. длина Описание поля

4.6.2. Смена данных владельца домена в других зонах

Вы не можете изменить имя организации (o_company) с помощью этой операции. Изменение имени организации-владельца осуществляется с помощью операции domain_owner_change.

[% PROCESS gtld_contacts %]

Имя поля Мин. длина Макс. длина Описание поля

4.6.3. Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Modified contact details for <domain name> Операция произведена успешно

Ответ системы	Описание
Success: Modified contact details for <domain name>	Операция произведена успешно

4.7. Получение информации о статусе ручной проверки домена

Эта операция позволяет получить статус ручной проверки данных владельца домена (для доменов .RU и .SU).
В качестве значения параметра action для этой операции должно быть указано domain_get_approval_status.

Ответы системы

Кроме общих сообщений об ошибках HTTP-шлюз может возвращать следующий ответов:

Ответ системы Описание

Success: Domain approval status is '<status>' Код статуса ручной проверки домена. Возможные коды статуса:

'pending' — ожидает ручной проверки,
'approved' — проверка успешно пройдена,
'errsent' — в результате проверки обнаружены ошибки,
'N/A' — статус не определён (возвращается для доменов в зонах, отличных от .RU и .SU).

Ответ системы	Описание
Success: Domain approval status is '<status>'	Код статуса ручной проверки домена. Возможные коды статуса: 'pending' — ожидает ручной проверки, 'approved' — проверка успешно пройдена, 'errsent' — в результате проверки обнаружены ошибки, 'N/A' — статус не определён (возвращается для доменов в зонах, отличных от .RU и .SU).

4.8. Дать полномочия по управлению доменом другому пользователю

Эта операция позволяет передать права на управление доменом другому пользователю.
В качестве значения параметра action для этой операции должно быть указано domain_partcontrol_grant.
Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями требуются для этой операции.

Имя поля Мин. длина Макс. длина Описание поля

newlogin 4 32 Имя логина другого пользователя в системе, которому необходимо дать права на управление доменом

Имя поля	Мин. длина	Макс. длина	Описание поля
newlogin	4	32	Имя логина другого пользователя в системе, которому необходимо дать права на управление доменом

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

Success: Domain's management rights successfully granted to '<account>' Права на управление доменом переданы на аккаунт

Error: no newlogin given Значение поля newlogin не указано

Error: login '<newlogin>' not found Пользователь с указанным логином не найден

Ответ системы	Описание
Success: Domain's management rights successfully granted to '<account>'	Права на управление доменом переданы на аккаунт
Error: no newlogin given	Значение поля `newlogin` не указано
Error: login '<newlogin>' not found	Пользователь с указанным логином не найден

4.9. Забрать полномочия по управлению доменом от другого пользователя

Эта операция позволяет отменить права на управление доменом другим пользователем.
В качестве значения параметра action для этой операции должно быть указано domain_partcontrol_revoke.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

Success: Domain managment rights successfully revoked from another users Права на управление доменом были отменены для другого аккаунта

Ответ системы	Описание
Success: Domain managment rights successfully revoked from another users	Права на управление доменом были отменены для другого аккаунта

4.10. Получение информации о домене

Эта операция позволяет получить информацию(статус домена, дата регистрации, дата удаления, дата условного продления) о домене пользователя.
В качестве значения параметра action для этой операции должно быть указано domain_get_info.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

state: <state> creation_date: <YYYY-MM-DD> expiration_date: <YYYY-MM-DD> future_periods: <years>;
Статусы доменов:

"A" – активен;
"N" – не активен (не зарегистрирован);
"S" – приостановлен;
"T" – переносится;
"D" – удалён;
"O" – перенесён к другому регистратору;

Ответ системы	Описание
state: <state> creation_date: <YYYY-MM-DD> expiration_date: <YYYY-MM-DD> future_periods: <years>;	Статусы доменов: "A" – активен; "N" – не активен (не зарегистрирован); "S" – приостановлен; "T" – переносится; "D" – удалён; "O" – перенесён к другому регистратору;

4.11. Получение данных владельца домена

Эта операция позволяет получить контактную информацию владельца домена.
В качестве значения параметра action для этой операции должно быть указано domain_get_contacts.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

<field1>: <value1>;
<field2>: <value2>;
.....
<fieldN>: <valueN>;
Поля контактной информации домена в формате: поле: значение

Ответ системы	Описание
<field1>: <value1>; <field2>: <value2>; ..... <fieldN>: <valueN>;	Поля контактной информации домена в формате: поле: значение

4.12. Получение списка DNS-серверов домена

Эта операция позволяет получить список DNS-серверов Вашего домена.
В качестве значения параметра action для этой операции должно быть указано domain_get_nss.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

Success: <ns1.hostname>, <ns2.hostname>, ...
Список DNS-серверов домена, разделённый запятыми

Ответ системы	Описание
Success: <ns1.hostname>, <ns2.hostname>, ...	Список DNS-серверов домена, разделённый запятыми

5. Операции по управлению DNS-зоной домена

Далее описаны различные операции по обслуживанию / изменению настроек зоны домена, которые могут быть осуществлены через HTTPS-шлюз.

5.1. Добавление ресурсной записи

Эта операция позволяет добавить для указанного домена / поддомена DNS-запись тип записи A, MX, CNAME, NS, TXT, SRV
В качестве значения параметра action для этой операции должно быть указано zone_add_rr.

Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями

Имя поля Мин. длина Макс. длина Описание поля

subname 2 50 Имя поддомена. Для изменения записи основного домена указывать "@"

rectype 1 5 Тип ресурсной записи. Допустимые значения: A, MX, NS, CNAME, TXT, SRV.

Для записи типа A

ipaddr 8 16 IP-адрес

Для записи типа CNAME

hostname 2 50 Canonical name

Для записи типа MX

hostname 2 50 Почтовый сервер

priority 1 2 Приоритет записи

Для записи типа NS

hostname 2 50 DNS сервер

Для записи типа TXT

text 1 253 Текст

Для записи типа SRV

nsnum 1 1 номер NS сервера

service 1 253 Название сервиса

target 1 253 Target

port 1 6 Порт

weight 1 2 Вес

Имя поля	Мин. длина	Макс. длина	Описание поля
subname	2	50	Имя поддомена. Для изменения записи основного домена указывать "@"
rectype	1	5	Тип ресурсной записи. Допустимые значения: `A`, `MX`, `NS`, `CNAME`, `TXT`, `SRV`.
Для записи типа A
ipaddr	8	16	IP-адрес
Для записи типа CNAME
hostname	2	50	Canonical name
Для записи типа MX
hostname	2	50	Почтовый сервер
priority	1	2	Приоритет записи
Для записи типа NS
hostname	2	50	DNS сервер
Для записи типа TXT
text	1	253	Текст
Для записи типа SRV
nsnum	1	1	номер NS сервера
service	1	253	Название сервиса
target	1	253	Target
port	1	6	Порт
weight	1	2	Вес

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Record added Запись добавлена.

Error: Uninplemented rectype некорректный или неподдерживаемый тип записи

Error: Invalid subdomain Был введен некорректный поддомен

Error: Incorrect IP Был введен некорректный IP адрес (для записей A)

Error: Conflict with CNAME record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями (для записей кроме CNAME)

Error: Invalid hostname Некорректное имя хоста (для записей CNAME, MX, NS).

Error: CNAME conflict with other record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями (для записей CNAME)

Error: Incorrect text Введенный текст некорректной длины (для записей TXT)

Error: incorrect symbols in Service Были переданы некорректные данные в поле service (для записей SRV)

Error: Incorrect port Были переданы некорректные данные в поле port (для записей SRV)

Error: Incorrect target Были переданы некорректные данные в поле target (для записей SRV)

Error: Incorrect weight Были переданы некорректные данные в поле weight (для записей SRV)

Ответ системы	Описание
Success: Record added	Запись добавлена.
Error: Uninplemented rectype	некорректный или неподдерживаемый тип записи
Error: Invalid subdomain	Был введен некорректный поддомен
Error: Incorrect IP	Был введен некорректный IP адрес (для записей A)
Error: Conflict with CNAME record	Для одного поддомена нельзя указывать записи CNAME совместно с другими записями (для записей кроме CNAME)
Error: Invalid hostname	Некорректное имя хоста (для записей CNAME, MX, NS).
Error: CNAME conflict with other record	Для одного поддомена нельзя указывать записи CNAME совместно с другими записями (для записей CNAME)
Error: Incorrect text	Введенный текст некорректной длины (для записей TXT)
Error: incorrect symbols in Service	Были переданы некорректные данные в поле service (для записей SRV)
Error: Incorrect port	Были переданы некорректные данные в поле port (для записей SRV)
Error: Incorrect target	Были переданы некорректные данные в поле target (для записей SRV)
Error: Incorrect weight	Были переданы некорректные данные в поле weight (для записей SRV)

5.2. Удаление записи

Эта операция позволяет удалить запись зоны
В качестве значения параметра action для этой операции должно быть указано zone_rm_rr.

Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями

Имя поля Мин. длина Макс. длина Описание поля

subname 2 50 Имя поддомена

rectype 2 10 Тип записи

misc 1 6 Приоритет

Имя поля	Мин. длина	Макс. длина	Описание поля
subname	2	50	Имя поддомена
rectype	2	10	Тип записи
misc	1	6	Приоритет

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Record removed Запись удалена

Success: Record not found Запись не найдена

Ответ системы	Описание
Success: Record removed	Запись удалена
Success: Record not found	Запись не найдена

5.3. Обновление зоны

Эта операция позволяет обновить зону на DNS-серверах (обновить запись SOA).
В качестве значения параметра action для этой операции должно быть указано zone_update.

Никаких дополнительных параметров она не требует.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Zone updated Обновление зоны инициировано.

Error: Can't update zone Невозможно обновить зону. Возможно, домен не активен (не оплачен или заблокирован).

Ответ системы	Описание
Success: Zone updated	Обновление зоны инициировано.
Error: Can't update zone	Невозможно обновить зону. Возможно, домен не активен (не оплачен или заблокирован).

5.4. Настройка зоны для парковки

Эта операция позволяет настроить зону для парковки
В качестве значения параметра action для этой операции должно быть указано zone_tune_park.

Никаких дополнительных параметров она не требует.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Zone updated Обновление зоны инициировано.

Ответ системы	Описание
Success: Zone updated	Обновление зоны инициировано.

5.5. Настройка зоны для хостинга

Эта операция позволяет настроить зону для хостинга
В качестве значения параметра action для этой операции должно быть указано zone_tune_host.

Никаких дополнительных параметров она не требует.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

Success: Zone updated Обновление зоны инициировано.

Ответ системы	Описание
Success: Zone updated	Обновление зоны инициировано.

5.6. Получение информации о зоне

Эта операция позволяет получить информацию о зоне
В качестве значения параметра action для этой операции должно быть указано zone_get_info.

Никаких дополнительных параметров она не требует.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать один из следующих ответов:

Ответ системы Описание

RRs
subname: <subname>;priority: <priority>;address: <address>;rectype: <rectype>;
subname: <subname>;priority: <priority>;address: <address>;rectype: <rectype>;
....
subname: <subname>;priority: <priority>;address: <address>;rectype: <rectype>;
SRV
service: <service>;rectype: <rectype>;priority: <priority>;weight: <weight>;port: <port>;target: <target>; RRs вывод ресурсных данных зоны SRV вывод srv записей зоны

Ответ системы	Описание
RRs subname: <subname>;priority: <priority>;address: <address>;rectype: <rectype>; subname: <subname>;priority: <priority>;address: <address>;rectype: <rectype>; .... subname: <subname>;priority: <priority>;address: <address>;rectype: <rectype>; SRV service: <service>;rectype: <rectype>;priority: <priority>;weight: <weight>;port: <port>;target: <target>;	RRs вывод ресурсных данных зоны SRV вывод srv записей зоны

6. Прочие операции

Далее описаны различные операции по обслуживанию / изменению настроек доменов, которые могут быть осуществлены через HTTP-шлюз.

6.1. Проверка баланса пользователя

Эта операция позволяет получить информацию о размере предоплаты находящейся на счету пользователя.
В качестве значения параметра action для этой операции должно быть указано balance_get.

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

Success: account balance is <balance> USD without VAT Баланс пользователя в у. е. (без НДС)

Ответ системы	Описание
Success: account balance is <balance> USD without VAT	Баланс пользователя в у. е. (без НДС)

6.2. Выписка счёта на предоплату (пополнение баланса)

Эта операция позволяет выписать счёт на предоплату (для пополнения баланса). В качестве значения параметра action для этой операции должно быть указано balance_refill. В настоящее премя поддерживается только пополнение баланса по WebMoney.

Ниже перечислены дополнительные поля, которые наряду с общими обязательными полями

Имя поля Мин. длина Макс. длина Описание поля

pay_type 2 20 Способ оплаты счёта. В настоящее время поддерживается только WebMoney (значение поля — "WM")

amount 1 6 Сумма предоплаты в у.е. (указывается без НДС)

Поля для способа оплаты "WM"

wmid 12 12 WMID плательщика для выписки WM-счёта

Имя поля	Мин. длина	Макс. длина	Описание поля
pay_type	2	20	Способ оплаты счёта. В настоящее время поддерживается только WebMoney (значение поля — "`WM`")
amount	1	6	Сумма предоплаты в у.е. (указывается без НДС)
Поля для способа оплаты "WM"
wmid	12	12	WMID плательщика для выписки WM-счёта

Ответы системы

Кроме общих сообщений об ошибках HTTPS-шлюз может возвращать следующий ответов:

Ответ системы Описание

Success: account balance is <balance> USD without VAT Баланс пользователя в у. е. (без НДС)

Ответ системы	Описание
Success: account balance is <balance> USD without VAT	Баланс пользователя в у. е. (без НДС)

7. Примеры

Ссылки на HTML-формы, иллюстрирующие HTTP-запросы к шлюзу RegRuSRS даны в третьей колонке таблицы операций, приведённой в разделе 3.1 (список операций).

Внимание! Не устанавливайте для Ваших клиентов web-формы, содержащие Ваши авторизационные данные, т.к. клиенты могут легко узнать Ваш login и пароль. Для обеспечения безопасности, запросы должны отправляться программой на стороне сервера.