Домени
Безпека
Інструменти
Компанія
USD
УКР
api access

Зовнішній API

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

REGERY API

ОглядВступАутентифікаціяРежим тестуванняДоменні зониШтати/регіони
АккаунтОтримати баланс
Черга повідомленьЧитанняПідтвердження
ДомениПеревіркаСписокІнформаціяРеєстраціяТрансферОновленняПродовженняВідновленняМасова перевіркаПреміум ціни
КонтактиЗбереженняЧитання
ХостиСтворитиЧитанняОновленняВидалення
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
premium преміальні сервери імен
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
            }
        }
    ]
}