Программный интерфейс (API)

Запросы к 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

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

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

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

username: test
password: test

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

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

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

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

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

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

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

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

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

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

Эта операция позволяет проверить доступность доменного имени для регистрации.

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

Дополнительных полей кроме общих обязательных полей для этой операции могут использоваться дополнительные параметры tlds и price. Также возможна проверка сразу до 50 доменных имен, передаваемых в параметрах domain_name, domain_name1, domain_name2 и т.д.

В случае проверки сразу нескольких имен каждому домену соответствует одна строка в ответе сервера.

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

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

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

Эта операция позволяет получить данные WHOIS домена.

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

Дополнительных полей кроме общих обязательных полей для этой операции не требуется.

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

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

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

Эта операция позволяет подать заявку на продление регистрации домена.

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

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

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

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

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

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

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

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

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

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

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

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

Эта операция позволяет изменить контактные данные владельца домена.

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

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

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

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

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

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

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

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

Изменение полей с префиксом o_ возможен только через web-интерфейс. При изменении через API будет ошибка Update owner fail

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

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

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

Эта операция позволяет получить статус ручной проверки данных владельца домена (для доменов .RU, .SU, .РФ).

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

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

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

Эта операция позволяет получить информацию о размере предоплаты находящейся на счету пользователя.

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

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

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

Эта операция позволяет передать права на управление доменом другому пользователю.

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

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

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

Эта операция позволяет отменить права на управление доменом другим пользователем.

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

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

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

Эта операция позволяет получить информацию(статус домена, дата регистрации, дата удаления, дата условного продления) о домене пользователя.

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

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

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

Эта операция позволяет получить контактную информацию домена.

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

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

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

Эта операция позволяет создать новый аккаунт пользователя на сайте WebNames.RU

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

Дополнительные поля, используемые в этой операции наряду с общими обязательными полями:

(Пример: +7.4952171179).

(Пример: +7.4952171179). Необязательное поле.

Пример: Vassily N Pupkin

Пример1: Пупкин Василий Николаевич
Пример2: John Smith

Пример: 34 02 651241 выдан 48 о/м г.Москвы 26.12.1990

Пример: 101000, Москва, ул.Воробьянинова, 15, кв.22

Пример: 07.11.1917

Пример1: Karla-Marla Uryupinsk State University
Пример2: "ROGA I KOPYTA", LTD.

Пример1: Урюпинский государственный университет\nимени Карлы-Марлы
Пример2: Общество с ограниченной ответственностью "Рога и Копыта"

Пример: 101000, Москва, ул.Пупкина, 1, стр. 2

Пример: 101000, Москва, ул.Воробьянинова, 15,\n кв.22, В. Лоханкину.

Пример: +7 495 8102233\n+7 3432 811221

Пример: +7 3432 811221\n+7 495 5555342

Пример: 789012345678

Пример: 632946014

Обязательные поля: * - для любых пользователей, ** - для частных лиц, *** - для организаций.

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

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

Эта операция позволяет получить информацию (имя домена, статус домена, дата регистрации, дата удаления, дата условного продления) о всех доменах пользователя.

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

Функция поддерживается в версии 1 и выше (многострочный вывод).

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

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

Эта операция позволяет получить информацию о цене на регистрацию и продление доменов.

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

Параметры операции:

tld - не обязательный, позволяет выбрать цены только для указанного TLD.

currency - не обязательный, позволяет получит цены в указанной валюте.
Если параметр не указан, цены выдаются в текущей валюте пользователя.
Доступные значения параметра: 'RUR', 'EUR', 'USD'.

Функция поддерживается в версии 1 и выше (многострочный вывод).

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

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

Эта операция позволяет получить информацию о пользователе (email, подписка на новости, оборот, тип пользователя, пользовательская анкета, анкеты по-умолчанию).

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

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

См. общие сообщения об ошибках.

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

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

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

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

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

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

*r1; r2 - номер ревизии интерфейса. Может быть задан параметром interface_revision в запросе. Принимает значения 1 ( по умолчанию ) или 2.

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

Команда pispRegNS включает в себя все поля для pispCheckNS. Также могут присустввовать поля:

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

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

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

Команда pispRmNS включает в себя все поля для pispCheckNS.

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

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

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

Описание полей:

Важно! К сведениям, необходимым для идентификации Администратора домена, относятся:

Для физического лица

ФИО, место жительства, а также сведения о документе, удостоверяющем личность. Сведения необходимо подтвердить цветными, хорошо читаемыми скан-копиями соответствующих страниц документа, удостоверяющего личность.

• Для граждан Российской Федерации: цветные, хорошо читаемые скан-копии страниц гражданского паспорта: 2, 3, 5-й (или всех страниц с пропиской, если их несколько), 19–й (если паспорт менялся).
• Для граждан Белоруссии: цветные, хорошо читаемые скан-копии 22, 31, 32 и 33-й страниц гражданского паспорта;
• Для граждан Украины: цветные, хорошо читаемые скан-копии 1, 2, 3, 11-й (или всех страниц с пропиской, если их несколько) страниц гражданского паспорта;

Для ИП

ФИО, место жительства и сведения о документе, удостоверяющем личность; а также данные о постановке на учет в налоговом органе (ИНН). Сведения необходимо подтвердить цветными, хорошо читаемыми скан-копиями соответствующих страниц таких документов.

Для юридического лица

Полное наименование юридического лица, место нахождения и сведения о государственной регистрации. Сведения необходимо подтвердить цветными, хорошо читаемыми скан-копиями:

• свидетельства о государственной регистрации юридического лица;
• свидетельства о постановке юридического лица на учет в налоговом органе (для юридического лица, зарегистрированного на территории Российской Федерации);
• иного документа, подтверждающего государственную регистрацию (для юридического лица, зарегистрированного на территории иного государства).

Обратите внимание: согласно правилами регистрации доменов (независимо от доменной зоны), Администратор (владелец доменного имени) должен самостоятельно следить за актуальностью данных, указанных в анкете домена. Сразу после изменения данных, Администратор обязан предоставить Регистратору достоверную информацию об изменениях.

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

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

Эта операция позволяет добавить тип записи alias

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

Дополнительные поля, которые используются наряду с общими обязательными полями:

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

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

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

Эта операция позволяет добавить тип записи CNAME

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

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

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

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

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

Эта операция позволяет добавить тип записи MX

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

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

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

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

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

Эта операция позволяет добавить тип записи NS

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

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

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

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

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

Эта операция позволяет добавить тип записи TXT

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

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

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

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

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

Эта операция позволяет добавить тип записи SRV

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

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

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

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

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

Эта операция позволяет удалить запись зоны

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

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

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

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

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

Эта операция позволяет обновить зону

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

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

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

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

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

Эта операция позволяет настроить зону для парковки

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

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

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

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

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

Эта операция позволяет настроить зону для хостинга

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

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

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

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

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

Эта операция позволяет получить информацию о зоне

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

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

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

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

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

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

7.2.1 Указание тарифа, если он требуется

Пример: web16 (для хостинга)
Пример: rapidssl (для SSL)
Пример: 1 (для выделенных серверов)

7.2.2.1 Поддержка DNS

Пример: yandex.mobi

7.2.2.2 GeoTrust SSL

Пример: regtime.net

Пример: freessl
Пример: rapidssl

Пример: CEO

Пример: +7 495 8102233

Пример: +7 3432 811221

Пример: CTO

Пример: +7 495 8102233

Пример: +7 3432 811221

Пример: CBO

Пример: +7 495 8102233

Пример: +7 3432 811221

Пример1: Karla-Marla Uryupinsk State University
Пример2: "ROGA I KOPYTA", LTD.

Пример1: Uryupinsk

Пример: Uryupinskaya obl.

Пример: 632946014

Пример: RU

Пример: 10100,  Moscow, Pupkin str., 1, office 433

Пример: 443000

Пример: +7 495 8102233\n+7 3432 811221

Пример: +7 3432 811221\n+7 495 8102233

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

Пример: srv_hostisp
Пример: srv_ssl
Пример: srv_certificate

Пример: web16 (для хостинга)
Пример: rapidssl (для SSL)
Пример: 1 (для выделенных серверов)

Общие параметры для команд управления сервисами указаны в таблице ниже.

Пример: srv_hostisp
Пример: srv_ssl
Пример: srv_certificate

Пример: web16 (для хостинга)

Пример: rapidssl (для SSL)

Пример: 1 (для выделенных серверов)

addalias - добавить алиас,

rewrite - добавить переадресацию,

clear - удалить все правила

error_page - в случае ошибки переходить на указанный адрес

srv_hostisp

mail4, web08, web09, web16, web17, web45

install

Доступные CMS: joomla, wordpress, drupal, hostcms

Общие параметры для команды pispServiceList указаны в таблице ниже. Поля необязательны для заполнения - если поля не заполнены, то будет выведен список всех сервисов.

Пример: srv_hostisp
Пример: srv_ssl

curl -k 'https://www.webnames.ru:81/RegTimeSRS.pl' --compressed -X POST --data-raw 'thisPage=pispServiceList&utf8=1&interface_revision=1&username=${login}&password=${password}&servtype=srv_privacy' > service_list.csv && xdg-open ./service_list.csv

curl -k 'https://www.webnames.ru:81/RegTimeSRS.pl' --compressed -X POST --data-raw 'thisPage=pispServiceList&utf8=1&interface_revision=2&username=${login}&password=${password}&servtype=srv_privacy' > service_list.json && firefox ./service_list.json