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

Внешний API

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

API REGERY

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

Список доменов под управлением

Позволяет получить список доменов с пагинацией

Параметры URL 

•︎ offset number | default = 0 
Смещение относится к начальной точке, с которой данные должны быть получены в ответе страницы. Оно указывает на количество элементов, которые должны быть пропущены с самого начала, прежде чем будут возвращены фактические данные
•︎ limit number | default = 50 
Параметр задает максимальное количество элементов, возвращаемых на страницу или в ответ. Он контролирует размер подмножества данных, которые API возвращает для конкретного запроса

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

•︎ total number 
Общее количество доменов, доступных для запроса
•︎ domains object[] 
Массив доменов под управлением. Ниже перечислены общие свойства для всех записей
•︎ name string 
Полное доменное имя FQDN
•︎ expiration date (ISO 8601) 
Текущая дата окончания срока действия домена
•︎ dueDate date (ISO 8601) 
Окончательная дата продления доменного имени. Многие доменные зоны требуют, чтобы операция продления была выполнена до реальной даты истечения срока действия
•︎ statuses enum[] 
Массив статусов домена
pendingCreate Домен находится в процессе регистрации. Сообщение о завершении регистрации будет добавлено в очередь
•︎ autoRenew boolean 
Если true, то доменное имя будет автоматически продлено
•︎ nameservers object 
Серверы имен, которые доменное имя использует для делегирования
•︎ list string[] 
Массив серверов имен. Для большинства зон доменных имен требуется указать не менее двух серверов имен
•︎ provider enum 
Если список серверов имен не указан, то указывается один из провайдеров. Если указан список серверов имен, то провайдера следует опустить
basic базовые серверы имен Regery
blackHole серверы имен black hole. Такие серверы всегда возвращают NXDOMAIN
•︎ contacts object 
Во время регистрации необходимо указать ссылку как минимум на контактные данные регистранта
•︎ registrant string 
Ссылка на контактные данные владельца доменного имени
•︎ admin string 
Ссылка на контактные данные
•︎ tech string 
Ссылка на контактные данные
•︎ billing string 
Ссылка на контактные данные
•︎ services enum[] 
Для каждой доменной зоны могут использоваться дополнительные сервисы, которые помогают в регистрации. Такие сервисы могут быть объединены в зависимости от правил конкретной доменной зоны
proxy контактные данные не отправляются в реестр, вместо этого отправляются контакты прокси. Это помогает скрыть информацию о владельце домена от общедоступного WHOIS
trustedRegistrant если зона доменного имени предъявляет особые требования к владельцу доменного имени, то эта услуга поможет выполнить требования реестра, предоставив доверенный контакт
trustedAdmin если зона доменного имени предъявляет особые требования к контакту администратора доменного имени, то эта услуга поможет выполнить требования реестра, предоставив доверенный контакт
trustedTech если зона доменного имени предъявляет особые требования к контакту технического специалиста доменного имени, то эта услуга поможет выполнить требования реестра, предоставив доверенный контакт
•︎ disclose boolean 
Некоторые реестры имеют возможность скрывать/раскрывать контактную информацию из общедоступных ресурсов WHOIS. Эта опция может управляться этим флагом, если реестр поддерживает ее
HTTP ENDPOINT
GET v1/domains?offset=:offset&limit=:limit
ПРИМЕР ЗАПРОСА: GET /v1/domains
ПРИМЕР ОТВЕТА: HTTP 200 OK
{
    "total": 1,
    "domains": [
         {
            "name": "example.com",
            "expiration": "2000-06-15T10:00:00.0000000+00:00",
            "dueDate": "2000-06-15T10:00:00.0000000+00:00",
            "autoRenew": false,
            "nameservers": {
                "provider": null,
                "list": [
                    "ns1.nameservers.net",
                    "ns2.nameservers.net"
                ]
            },
            "contacts": {
                "services": [],
                "registrant": "ABCDEFGHIJ",
                "admin": "ABCDEFGHIJ",
                "tech": "ABCDEFGHIJ",
                "billing": "ABCDEFGHIJ",
                "disclose": false
            }
        }
    ]
}