Описание HTTPS-шлюза к системе RegTimeSRS

English version

(c) RegTime.Net Ltd, 2002-2007


Содержание

  1. Введение
  2. Описание HTTPS-Post шлюза
  3. Отправка HTTPS-Post запросов
  4. Операции по регистрации и переносу доменов
  5. Прочие операции
  6. Операции управления зоной домена
  7. Примеры

1. Введение

Это справочное руководство описывает HTTPS-шлюз к системе распределённой регистрации RegTime (RegTime Shared Registry System — RegTimeSRS), версии 1.0.1.
HTTPS-шлюз — это метод взаимодействия с системой распределённой регистрации RegTimeSRS, позволяющий осуществлять операции в реальном времени за один шаг.

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

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

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

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

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

https://www.webnames.ru:81/RegTimeSRS.pl

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

Предупреждение:
Не устанавливайте для Ваших клиентов web-формы, содержащие Ваши авторизационные данные, т.к. клиенты могут легко узнать Ваш login и пароль. Для обеспечения безопасности, запросы должны отправляться программой на стороне сервера.
Все запросы должны удовлетворять спецификации HTTP/1.0 (использование HTTP/1.1 не рекомендуется) описанной в RFC 1945:
http://www.ics.uci.edu/pub/ietf/http/rfc1945.html

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

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

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

username: test
password: test

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

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

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


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

3.1. Операции

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

Операция
(значение thisPage)
Описание Реали-
зовано
Операции по регистрации и переносу (см. раздел 4)
pispRegistration Подать заявку на регистрацию домена Да
pispInitiateTransfer Подать заявку на перенос домена от другого регистратора Да

Прочие операции (см. раздел 5)
pispCheckDomain Проверка доступности домена для регистрации Да
pispWhois Получение данных WHOIS домена Да
pispRenewDomain Продление регистрации домена Да
pispRedelegation Смена списка DNS-серверов домена Да
pispContactDetails Смена данных владельца домена Да
pispBalance Получить значение текущего баланса Да
pispDomainMove Передача управления доменом на другой аккаунт Да
pispDomainRevoke Запрет управления доменом другого аккаунта Да
pispDomainInfo Информация о домене Да
pispGetContactDetails Контактная информация домена Да
pispCancelDomain Отмена регистрации домена Нет
pispRegistryKey Получение регистрационного ключа домена Нет
pispGetDelegation Получение списка DNS-серверов домена Нет
pispAddNameServer Зарегистрировать DNS-сервер в NSI-registry (для .com, .net, .org) Нет
pispDeleteNameServer Удалить DNS-сервер из NSI-registry (для .com, .net, .org) Нет

Операции работы с зоной (см. раздел 6)
pispDomainZoneAddAlias Добавление записи 'ALIAS' Да
pispDomainZoneAddCname Добавление записи 'CNAME' Да
pispDomainZoneAddMX Добавление записи 'MX' Да
pispDomainZoneAddNS Добавление записи 'NS' Да
pispDomainZoneAddTXT Добавление записи 'TXT' Да
pispDomainZoneSRV Добавление записи SRV Да
pispDomainZoneRmRR Удаление записи Да
pispDomainZoneUpdate Обновление зоны Да
pispDomainZoneTuneFwd Настройка зоны для парковки Да
pispDomainZoneTuneHost Настройка зоны для хостинга Да
pispDomainZoneInfo Получение информации о зоне Да


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

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


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

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

Имя поля Макс. длина Описание
thisPage 80 Определяет операцию, которая должна быть произведена, например pispCheckDomain
username 80 Имя пользователя (login) в системе регистрации RegTimeSRS.
password 80 Пароль пользователя (password) в системе регистрации RegTimeSRS.
domain_name * 67 Полное имя домена, с которым производится операция, например example.com. Максимальная длина - 67 символов (63 + 4). Допустимы алфавитно-цифровые символы и символ дефиса. Русские имена доменов указываются в кодировке windows-1251 (CP1251).
interface_revision 5 Номер версии интерфейса. Подробности см. в разделе 3.5
interface_lang 2 Язык сообщений об ошибках ('ru' или 'en'). Подробности см. в разделе 3.5. По умолчанию язык английский ('en').

* - поля обязательные для операций с доменами


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

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

Текст ошибки Описание
Error: username/password Incorrect Значения полей "username" и/или "password" не указаны, указаны неверно, либо такого пользователя не существует.
Error: Domain Name is invalid Значение поля "domain_name" не указано или указано неверно: т.е. содержит недопустимые символы, превышает допустимую длину и т.п.
Error: System Unavailable Шлюз RegTimeSRS не доступен. Операция не была произведена и запрос должен быть подан повторно.
Error: Internal error Внутренняя ошибка системы RegTimeSRS. Пожалуйста, свяжитесь с RegTime.Net для решения проблемы.
Error: The following fields are invalid: <fields list> Значения перечисленных полей неверны. Исправьте данные и повторите запрос.
Error: Incorrect request <request> Некорректное значение поля thisPage

3.5. Версии интерфейса

Шлюз RegTimeSRS может действовать в нескольких режимах в зависимости от того, какая версия интерфейса используется. Версия интерфейса передаётся в запросе в поле "interface_revision". Если поле "interface_revision" отсутствует в запросе, то версия интерфейса принимается за "0".

В таблице ниже перечислены версии интерфейса, которые поддерживаются в настоящий момент.

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


4. Операции по регистрации и переносу доменов

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

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

Имя поля Мин. длина Макс. длина Описание поля
period 1 2 Период, на который производится регистрация домена. Единственное допустимое значение для доменов .ru и .su: 1.
descr 5 255 Описание домена. Заполняется по-английски (для доменов .SU). Необязательное поле.
Контактные данные организации (только при регистрации домена на организацию!)
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
private_person 0 1 Необязательный флаг, может иметь значения 0 или 1.
Если 1, в ответе Whois вместо реального значения поля person будет выводиться "Private person".
Если 0, то при обновлении данных домена ранее поставленный флаг будет снят, и в ответе Whois будет выводиться реальное значение поля person.
person_r 9 64 Фамилия, имя и отчество администратора домена на русском языке в соответствии с паспортными данными. Для иностранцев поле содержит имя в оригинальном написании (при невозможности в английской транскрипции).
Пример1: Пупкин Василий Николаевич
Пример2: John Smith
passport 15 255
много-
строчное
Серия и номер паспорта, а также наименование органа, выдавшего паспорт, и дата выдачи (в указанной последовательности, с разделением пробелами). В написании римских цифр допустимо использование только латинских букв. Дата записывается в формате ДД.ММ.ГГГГ. Знак номера перед номером паспорта не ставится. Паспорта СССР (паспорта старого образца) не принимаются. В случае использования документа, отличного от паспорта (допустимо ТОЛЬКО для нерезидентов России), в начале строки указывается наименование вида документа. Запись может быть многострочной.
Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990
residence 20 255
много-
строчное
Адрес места проживания администратора домена на русском языке. Адрес аналогичен ранее существовашей прописке и адресу регистрации, указываемого в паспорте. Запись может быть многострочной.
Пример: 101000, Москва, ул.Воробьянинова, 15, кв.22
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-сервера.
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. Для этого в качестве DNS-серверов необходимо указать сервера ns1.nameself.com и ns2.nameself.com.
При этом на данных серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии можно будет через web-интерфейс портала WebNames.ru.

4.2. Регистрация доменов в зонах .INFO, .BIZ, .MOBI, .ORG, .COM, .NET

Поля для этой операции аналогичны п.4.5, за исключением того, что добавлена секция контактов финансового администратора с префиксом "b_". В случае отсутствия этой секции она заполняется автоматически на основе контактов владельца домена.
Все поля заполняются на английском.
В качестве значения параметра thisPage для этой операции должно быть установлено pispRegistration.

Имя поля Мин. длина Макс. длина Описание поля
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-код страны контактного лица. Список всех кодов стран можно найти тут
Данные финансового администратора домена
b_company 5 80 Организация. Указывать "Private person" в случае, если финансовым администратором является частное лицо.
b_first_name 2 40 Имя контактного лица
b_last_name 2 40 Фамилия контактного лица
b_email 6 80 Email-адрес контактного лица
b_phone 8 20 Номер телефона контактного лица в международном формате (Пример: +7.4952171179).
b_fax 8 20 Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле.
b_addr 8 80 Адрес контактного лица: улица, дом, офис (квартира)
b_city 2 80 Адрес контактного лица: город
b_state 2 40 Адрес контактного лица: область/край/штат. Необязательное поле
b_postcode 3 10 Почтовый индекс контактного лица
b_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. Для этого в качестве DNS-серверов необходимо указать сервера ns1.nameself.com и ns2.nameself.com.
При этом на данных серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии можно будет через web-интерфейс портала WebNames.ru.

4.3. Регистрация доменов в зонe .ASIA

Поля для этой операции аналогичны п.4.2, кроме того, добавляется секция CED-контактa. Эта секция должна присутствовать обязательно. Все поля заполняются на английском и описаны ниже.
CED-контакт станет вторым техническим контактом домена.

Имя поля Мин. длина Макс. длина Описание поля
CED-контакт
default_ced 0 2 Если указано значение 'on' - использовать CED-контакт ООО "Регтайм" по умолчанию. В этом случае все остальные поля этой секции опускаются. Если данное поле отсутствует в запросе, необходимо заполнить все нижеследующие поля.
company 5 80 Название организации. Указывать "Private person" в случае, если частного лица.
first_name 2 40 Имя контактного лица
last_name 2 40 Фамилия контактного лица
email 6 90 Контактный email-адрес
phone 8 20 Номер телефона в международном формате (Пример: +7.4952171179).
fax 8 20 Номер факса в международном формате (Пример: +7.4952171179). Необязательное поле.
addr 8 80 Адрес: улица, дом, офис (квартира)
city 2 80 Адрес: город
state 2 40 Адрес: область/край/штат. Необязательное поле
postcode 3 10 Почтовый индекс
country_code 2 2 Двухбуквенный ISO-код страны Список всех кодов стран можно найти тут
cclocality 2 2 Код страны из Азиатско-Тихоокеанского региона, где зарегистрирован CED-контакт
entity_type 2 13 Тип CED-контакта (возможные значения: naturalPerson|corporation|cooperative|partnership|government|politicalParty|society|institution|other)
ident_form 5 22 Форма идентификации (возможные значения: passport|certificate|legislation|societiesRegistry|politicalPartyRegistry|other)
ident_number 2 255 Идентификационный номер

4.4. Регистрация доменов в зонах .KZ, .UZ, .TJ

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

Имя поля Мин. длина Макс. длина Описание поля
period 1 2 Период, на который производится регистрация домена. Интервал допустимых значений: 1 - 10
Данные владельца домена
o_name_ru 2 80 Имя и фамилия контактного лица по-русски
o_name_en 2 80 Имя и фамилия контактного лица по-английски
o_email 6 90 Контактный email-адрес владельца домена.
o_phone 8 20 Номер телефона владельца домена в международном формате (Пример: +7.4952171179).
o_fax 8 20 Номер факса владельца домена в международном формате (Пример: +7.4952171179). Необязательное поле.
o_addr_ru 8 80 Адрес владельца домена: улица, дом, офис (квартира) по-русски
o_addr_en 8 80 Адрес владельца домена: улица, дом, офис (квартира) по-английски
o_city_ru 2 80 Адрес владельца домена: город по-русски
o_city_en 2 80 Адрес владельца домена: город по-английски
o_state_ru 2 40 Адрес владельца домена: область/край/штат по-русски. Необязательное поле
o_state_en 2 40 Адрес владельца домена: область/край/штат по-английски. Необязательное поле
o_postcode 3 10 Почтовый индекс владельца домена
o_country_code 2 2 Двухбуквенный ISO-код страны владельца домена. Список всех кодов стран можно найти тут
Дополнительные поля, указываемые в случае регистрации домена на юридическое лицо
o_company_ru 5 80 Название организации - владельца домена - по-русски.
o_company_en 5 80 Название организации - владельца домена - по-английски.
o_code 10 10 ИНН
o_bank 3 80 Наименование банка
o_bank_account 3 40 Номер расчётного счёта
o_mfo 3 10 МФО (БИК)
o_okonh 3 10 ОКОНХ
Данные администратора домена
a_name_ru 2 80 Имя и фамилия контактного лица по-русски
a_name_en 2 80 Имя и фамилия контактного лица по-английски
a_nick 2 80 Идентификатор контакта (цифры и латинские символы)
a_email 6 90 Контактный email-адрес контактного лица.
a_phone 8 20 Номер телефона контактного лица в международном формате (Пример: +7.4952171179).
a_fax 8 20 Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле.
a_addr_ru 8 80 Адрес контактного лица: улица, дом, офис (квартира) по-русски
a_addr_en 8 80 Адрес контактного лица: улица, дом, офис (квартира) по-английски
a_city_ru 2 80 Адрес контактного лица: город по-русски
a_city_en 2 80 Адрес контактного лица: город по-английски
a_state_ru 2 40 Адрес контактного лица: область/край/штат по-русски. Необязательное поле
a_state_en 2 40 Адрес контактного лица: область/край/штат по-английски. Необязательное поле
a_postcode 3 10 Почтовый индекс контактного лица
a_country_code 2 2 Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут
Дополнительные поля, указываемые в случае регистрации домена на юридическое лицо
a_company_ru 5 80 Название организации по-русски.
a_company_en 5 80 Название организации по-английски.
Данные техподдержки домена
t_name_ru 2 80 Имя и фамилия контактного лица по-русски
t_name_en 2 80 Имя и фамилия контактного лица по-английски
t_nick 2 80 Идентификатор контакта (цифры и латинские символы)
t_email 6 90 Контактный email-адрес контактного лица.
t_phone 8 20 Номер телефона контактного лица в международном формате (Пример: +7.4952171179).
t_fax 8 20 Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле.
t_addr_ru 8 80 Адрес контактного лица: улица, дом, офис (квартира) по-русски
t_addr_en 8 80 Адрес контактного лица: улица, дом, офис (квартира) по-английски
t_city_ru 2 80 Адрес контактного лица: город по-русски
t_city_en 2 80 Адрес контактного лица: город по-английски
t_state_ru 2 40 Адрес контактного лица: область/край/штат по-русски. Необязательное поле
t_state_en 2 40 Адрес контактного лица: область/край/штат по-английски. Необязательное поле
t_postcode 3 10 Почтовый индекс контактного лица
t_country_code 2 2 Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут
Дополнительные поля, указываемые в случае регистрации домена на юридическое лицо
t_company_ru 5 80 Название организации по-русски.
t_company_en 5 80 Название организации по-английски.
Данные финансового администратора домена
b_name_ru 2 80 Имя и фамилия контактного лица по-русски
b_name_en 2 80 Имя и фамилия контактного лица по-английски
b_nick 2 80 Идентификатор контакта (цифры и латинские символы)
b_email 6 90 Контактный email-адрес контактного лица.
b_phone 8 20 Номер телефона контактного лица в международном формате (Пример: +7.4952171179).
b_fax 8 20 Номер факса контактного лица в международном формате (Пример: +7.4952171179). Необязательное поле.
b_addr_ru 8 80 Адрес контактного лица: улица, дом, офис (квартира) по-русски
b_addr_en 8 80 Адрес контактного лица: улица, дом, офис (квартира) по-английски
b_city_ru 2 80 Адрес контактного лица: город по-русски
b_city_en 2 80 Адрес контактного лица: город по-английски
b_state_ru 2 40 Адрес контактного лица: область/край/штат по-русски. Необязательное поле
b_state_en 2 40 Адрес контактного лица: область/край/штат по-английски. Необязательное поле
b_postcode 3 10 Почтовый индекс контактного лица
b_country_code 2 2 Двухбуквенный ISO-код страны контактного лица. Список всех кодов стран можно найти тут
Дополнительные поля, указываемые в случае регистрации домена на юридическое лицо
b_company_ru 5 80 Название организации по-русски.
b_company_en 5 80 Название организации по-английски.
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. Для этого в качестве DNS-серверов необходимо указать сервера ns1.nameself.com и ns2.nameself.com.
При этом на данных серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии можно будет через web-интерфейс портала WebNames.ru.

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

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

Имя поля Мин. длина Макс. длина Описание поля
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. Для этого в качестве DNS-серверов необходимо указать сервера ns1.nameself.com и ns2.nameself.com.
При этом на данных серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии можно будет через web-интерфейс портала WebNames.ru.

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

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

4.5.1. Перенос доменов .INFO .BIZ .MOBI .ORG

Имя поля Мин. длина Макс. длина Описание поля
period 1 1 Период, на который продляется домен при переносе. Интервал допустимых значений: 1 - 9
authinfo 3 40 Пароль (authinfo) домена. Может быть получен от прежнего регистратора.

4.5.2. Перенос прочих доменов

Поля для этой операции полностью соответствуют полям, указываемым при регистрации домена (см. разделы 4.1, 4.2 и 4.5). Единственное исключение - для доменов .ru и .su поле "period" может принимать значение "0" (перенос доменов без продления).

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

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

Ответ системы Описание
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 Заявка на регистрацию этого домена уже присутствует в системе. Повторная заявка на одно и то же имя не допускается.

См. также: Общие сообщения об ошибках


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

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


5.1. Проверка доступности домена

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

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

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

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

См. также: Общие сообщения об ошибках


5.2. Получить информацию WHOIS домена

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

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

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

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

См. также: Общие сообщения об ошибках


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

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

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

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

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

Ответ системы Описание
Success: Renewed <domain name> for <years> years Заявка на продление домена успешно принята.

См. также: Общие сообщения об ошибках


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

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

Важно: Как минимум два 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. Для этого в качестве DNS-серверов необходимо указать сервера ns1.nameself.com и ns2.nameself.com.
При этом на данных серверах будет прописана зона для Вашего домена. Управлять зоной впоследствии можно будет через web-интерфейс портала WebNames.ru.

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

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

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

См. также: Общие сообщения об ошибках


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

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

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

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

Имя поля Мин. длина Макс. длина Описание поля
descr 5 255 Описание домена. Заполняется по-английски (для доменов .SU). Необязательное поле.
Контактные данные организации (только при регистрации домена на организацию!)
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
private_person 0 1 Необязательный флаг, может иметь значения 0 или 1.
Если 1, в ответе Whois вместо реального значения поля person будет выводиться "Private person".
Если 0, то при обновлении данных домена ранее поставленный флаг будет снят, и в ответе Whois будет выводиться реальное значение поля person.
person_r 9 64 Фамилия, имя и отчество администратора домена на русском языке в соответствии с паспортными данными. Для иностранцев поле содержит имя в оригинальном написании (при невозможности в английской транскрипции).
Пример1: Пупкин Василий Николаевич
Пример2: John Smith
passport 15 255
много-
строчное
Серия и номер паспорта, а также наименование органа, выдавшего паспорт, и дата выдачи (в указанной последовательности, с разделением пробелами). В написании римских цифр допустимо использование только латинских букв. Дата записывается в формате ДД.ММ.ГГГГ. Знак номера перед номером паспорта не ставится. Паспорта СССР (паспорта старого образца) не принимаются. В случае использования документа, отличного от паспорта (допустимо ТОЛЬКО для нерезидентов России), в начале строки указывается наименование вида документа. Запись может быть многострочной.
Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990
residence 20 255
много-
строчное
Адрес места проживания администратора домена на русском языке. Адрес аналогичен ранее существовашей прописке и адресу регистрации, указываемого в паспорте. Запись может быть многострочной.
Пример: 101000, Москва, ул.Воробьянинова, 15, кв.22
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


5.5.2. Смена данных владельца домена в зонах .INFO .BIZ .MOBI .ORG .COM .NET

Список полей контактов

5.5.3. Смена данных владельца домена в других зонах .KZ .UZ .TJ

Список полей контактов

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

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

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


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

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

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

См. также: Общие сообщения об ошибках


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

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

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

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

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


5.7. Получение информации о состоянии баланса

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

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

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

Ответ системы Описание
Success: balance - <XXXX> RUR' Сумма на балансе клиента


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

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

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

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

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


5.9. Отмена прав на управление доменом другим пользователем

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

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

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

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


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

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

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

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

Ответ системы Описание
Success: Status <Status>; CreationDate <YYYY-MM-DD>; ExpirationDate <YYYY-MM-DD>; FutureExpDate <YYYY-MM-DD>; Статус домена:
  • Y активен;
  • N неактивен;
  • T переноситься;
  • B заблокирован.


5.11. Получение контактной информации домена

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

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

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

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


6. Операции управления зоной домена

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


6.1. Добавление записи 'ALIAS'

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

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

Имя поля Мин. длина Макс. длина Описание поля
subname 2 50 Имя поддомена
ipaddr 8 16 IP-адрес

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

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

Ответ системы Описание
Success: Record added Означает, что запись добавлена.
Error: Incorrect subdomain Означает, что был введен некорректный поддомен.
Error: Incorrect IP Означает, что был введен некорректный IP адрес.
Error: Conflict with CNAME record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями

См. также: Общие сообщения об ошибках


6.2. Добавление записи 'CNAME'

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

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

Имя поля Мин. длина Макс. длина Описание поля
subname 2 50 Имя поддомена
hostname 2 50 Canonical name

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

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

Ответ системы Описание
Success: Record added Означает, что запись добавлена.
Error: Incorrect subdomain Означает, что был введен некорректный поддомен.
Error: Incorrect hostname Означает, что был введен некорректный Canonical Name.
Error: Conflict with other record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями

См. также: Общие сообщения об ошибках


6.3. Добавление записи 'MX'

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

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

Имя поля Мин. длина Макс. длина Описание поля
subname 2 50 Имя поддомена
hostname 2 50 Почтовый сервер
priority 1 2 Приоритет записи

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

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

Ответ системы Описание
Success: Record added Означает, что запись добавлена.
Error: Incorrect subdomain Означает, что был введен некорректный поддомен.
Error: Incorrect hostname Означает, что был введен некорректный почтовый сервер.
Error: Incorrect priority Означает, что был введен некорректный приоритет.
Error: Conflict with CNAME record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями

См. также: Общие сообщения об ошибках


6.4. Добавление записи 'NS'

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

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

Имя поля Мин. длина Макс. длина Описание поля
subname 2 50 Имя поддомена
hostname 2 50 DNS сервер
nsnum 1 1 номер NS сервера

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

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

Ответ системы Описание
Success: Record added Означает, что запись добавлена.
Error: Incorrect subdomain Означает, что был введен некорректный поддомен.
Error: Incorrect hostname Означает, что был введен некорректный Canonical Name.
Error: Conflict with CNAME record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями

См. также: Общие сообщения об ошибках


6.5. Добавление записи 'TXT'

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

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

Имя поля Мин. длина Макс. длина Описание поля
subname 2 50 Имя поддомена
text 1 253 Текст

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

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

Ответ системы Описание
Success: Record added Означает, что запись добавлена.
Error: Incorrect subdomain Означает, что был введен некорректный поддомен.
Error: Incorrect text Означает, что введенный текст некорректной длины.
Error: Conflict with CNAME record Для одного поддомена нельзя указывать записи CNAME совместно с другими записями

См. также: Общие сообщения об ошибках


6.6. Добавление записи 'SRV'

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

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

Имя поля Мин. длина Макс. длина Описание поля
priority 1 2 Приоритет
service 1 253 Название сервиса
target 1 253 Target
port 1 6 Порт
weight 1 2 Вес

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

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

Ответ системы Описание
Success: Record added Означает, что запись добавлена.
Error: incorrect symbols in Service Означает, что были переданы некорректные данные в поле service
Error: Incorrect port Означает, что что были переданы некорректные данные в поле port
Error: Incorrect target Означает, что что были переданы некорректные данные в поле target
Error: Incorrect weight Означает, что что были переданы некорректные данные в поле weight

См. также: Общие сообщения об ошибках


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

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

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

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

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

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

Ответ системы Описание
Success: Record removed Означает, что запись удалена.

См. также: Общие сообщения об ошибках


6.8. обновление зоны

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

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

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

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

Ответ системы Описание
Success: Zone updated Означает, что зона будет обновлена.

См. также: Общие сообщения об ошибках


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

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

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

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

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

Ответ системы Описание
Success: Zone updated Означает, что зона будет обновлена.

См. также: Общие сообщения об ошибках


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

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

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

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

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

Ответ системы Описание
Success: Zone updated Означает, что зона будет обновлена.

См. также: Общие сообщения об ошибках


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

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

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

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

Кроме общих сообщений об ошибках 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 записей зоны

См. также: Общие сообщения об ошибках


7. Примеры

Примеры HTML-форм, иллюстрирующих HTTP-запросы к шлюзу RegtimeSRS могут быть загружены с адреса http://www.webnames.ru/downloads/RegTimeSRS-examlpes.zip