Домены
Безопасность
Хостинг
Компания
USD
РУС
api access

Внешний API

  1. Главная › 
  2. Доступ к программному интерфейсу

API REGERY

ОбзорВведениеАутентификацияРежим тестированияДоменные зоныШтаты/регионы
АккаунтПолучить баланс
Очередь сообщенийЧтениеПодтверждение
ДоменыПроверкаИнформацияРегистрацияТрансферОбновлениеПродлениеВосстановлениеМассова проверкаПремиум цены
КонтактыСохранениеЧтение
ХостыСоздатьЧтениеОбновлениеУдаление
DNSДобавлениеЧтениеУдаление
ДокументыЗагрузка

Регистрация домена

Регистрация доменного имени — это процесс резервирования уникального имени в Интернете на определенный период, обычно один год или более

Параметры URL 

•︎ domain string 
Полное доменное имя FQDN

Параметры POST 

•︎ period number 
Количество лет для регистрации домена. Для большинства зон доменных имен это значение находится между 1 годом и 10 годами
•︎ autoRenew boolean | default = false 
Если true, то доменное имя будет автоматически продлено
•︎ nameservers object | default = {"provider": "basic"} 
Серверы имен, которые доменное имя использует для делегирования
•︎ list string[] 
Массив серверов имен. Для большинства зон доменных имен требуется указать не менее двух серверов имен
•︎ provider enum 
Если список серверов имен не указан, то указывается один из провайдеров. Если указан список серверов имен, то провайдера следует опустить
basic базовые серверы имен Regery
premium премиальные серверы имен
blackHole серверы имен black hole. Такие серверы всегда возвращают NXDOMAIN
•︎ contacts object 
Во время регистрации необходимо указать ссылку как минимум на контактные данные регистранта
•︎ registrant string 
Ссылка на контактные данные владельца доменного имени
•︎ admin string | default = same as registrant 
Ссылка на контактные данные
•︎ tech string | default = same as registrant 
Ссылка на контактные данные
•︎ billing string | default = same as registrant 
Ссылка на контактные данные
•︎ services enum[] 
Для каждой доменной зоны могут использоваться дополнительные сервисы, которые помогают в регистрации. Такие сервисы могут быть объединены в зависимости от правил конкретной доменной зоны
proxy контактные данные не отправляются в реестр, вместо этого отправляются контакты прокси. Это помогает скрыть информацию о владельце домена от общедоступного WHOIS
trustedRegistrant если зона доменного имени предъявляет особые требования к владельцу доменного имени, то эта услуга поможет выполнить требования реестра, предоставив доверенный контакт
trustedAdmin если зона доменного имени предъявляет особые требования к контакту администратора доменного имени, то эта услуга поможет выполнить требования реестра, предоставив доверенный контакт
trustedTech если зона доменного имени предъявляет особые требования к контакту технического специалиста доменного имени, то эта услуга поможет выполнить требования реестра, предоставив доверенный контакт
•︎ disclose boolean | default = false 
Некоторые реестры имеют возможность скрывать/раскрывать контактную информацию из общедоступных ресурсов WHOIS. Эта опция может управляться этим флагом, если реестр поддерживает ее
•︎ idnTag string 
Требуется для регистрации доменных имен IDN. Домен IDN относится к интернационализированному доменному имени. Эти домены поддерживают символы, отличные от ASCII, что позволяет регистрировать доменные имена на языках, отличных от английского, например, на арабском, китайском или кириллице

Параметры ответа 

•︎ pending boolean 
Указывает, был ли запрос завершен или помещен в очередь на обработку
HTTP ENDPOINT
POST /v1/domains/:domain
ПРИМЕР ЗАПРОСА: POST /v1/domains/example.com
{
    "period": 1,
    "nameservers": {
        "list": ["ns1.nameserver.com", "ns2.nameserver.com"]
    },
    "contacts": {
        "registrant": "ABCDEFGHIJ"
    }
}
ПРИМЕР ОТВЕТА: HTTP 200 OK
{
    "pending": false
}