Проверить и Купить Доменное Имя, Бесплатно SSL Сертификаты для Сайта и Сервера

Список записей ресурсов DNS

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

Параметры URL

•︎ domain string

Полное доменное имя FQDN

•︎ offset номер | default = 0

Смещение относится к начальной точке, из которой данные должны быть извлечены в постраничном ответе. Оно указывает количество элементов, которые должны быть пропущены с начала перед возвратом фактических данных

•︎ limit номер | default = 50

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

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

•︎ records объект[]

Массив записей ресурсов DNS. Общие свойства для всех записей перечислены ниже

•︎ name string

Имя записи DNS относится к доменному имени, связанному с определенной записью DNS. Это самая левая часть доменного имени, которая указывает хост или поддомен, к которому применяется запись. Если имя относится к корневому домену, а часть хоста/поддомена должна быть пустой, то используется значение @.

•︎ type string

Типы записей DNS — это определенные записи в файле зоны DNS, которые помогают сопоставлять доменные имена с соответствующими IP-адресами или предоставляют другие типы информации.

•︎ ttl number

DNS TTL означает время жизни (секунды). Это параметр в записи системы доменных имен (DNS), который определяет, как долго DNS-резолвер должен кэшировать информацию, прежде чем она должна быть обновлена с авторитетных DNS-серверов. Он указывается в секундах и помогает управлять кэшированием DNS и обеспечивать эффективное разрешение DNS в Интернете. Минимальное значение: 60. Максимальное значение: 32767

Определения типов

•︎ A object

A - 32-битный адрес IPv4, обычно используется для задания соответствия между именем хоста и IP адресом.

•︎ address string

Адрес IPv4

•︎ AAAA object

AAAA - 128-битный адрес IPv6, используется для задания соответствия между именем хоста и IP адресом.

•︎ address string

Адрес IPv6

•︎ CNAME object

CNAME - тип ресурсной записи в Системе Доменных Имен (DNS), которая используется для указания того, что данное имя является псевдонимом для другого имени (канонический домен).

CNAME запись должна всегда указывать на другое доменное имя и никогда на IP адрес.

Вся информация о других записях домена-псеводонима, включая записи MX и другие, будет получена с канонического домена. Запись CNAME должна быть единственной для данного доменного имени и, согласно спецификации, CNAME запрещено использовать для корневого домена зоны.

•︎ target string

Полное доменное имя. Значение может содержать @ для ссылки на корневое доменное имя. Например, для домена example.com CNAME target www.@ приведет к значению, отображаемому как www.example.com

•︎ MX object

MX (почтовый сервис) - тип ресурсной записи Системы Доменных Имен (DNS), которая указывает на почтовые серверы, ответственные за обработку почты данного доменного имени, а также приоритет серверов если их несколько.

•︎ priority number

Поле priority указывает порядок, в котором почтовые серверы должны использоваться для доставки почты на определенный домен. Сначала пробуются почтовые серверы с более низкими значениями приоритета, и если они недоступны или недоступны, то пробуются серверы с более высокими значениями приоритета.

•︎ exchange string

Поле exchange указывает доменное имя почтового сервера, который отвечает за прием сообщений электронной почты от имени домена.

•︎ TXT object

TXT (текстовая запись) тип ресурсной записи Системы Доменных Имен (DNS), которая используется для указания дополнительных сведений о домене, часто эти данные предназначены не только для программного обеспечения, но и для людей.

Например, данная запись испольузется для указания политик SPF (Sender Policy Framework) почтовых серверов.

•︎ value string

Относится к текстовым данным, связанным с записью. Эти текстовые данные могут содержать любую произвольную информацию, которую владелец домена хочет включить в запись DNS. Записи TXT обычно используются для различных целей, таких как проверка домена для служб электронной почты, записи SPF для аутентификации электронной почты, записи DKIM для безопасности электронной почты и другие типы текстовой информации, необходимые для настройки или проверки домена.

•︎ SRV object

SRV (Сервисная запись) часто используется для обнаружения сервисов, связанных с доменом. Данная запись содержит имя хоста, порт и другие данные необходимые для обнаружения сервиса.

•︎ service string

Указывает символическое имя нужной службы, для которой создается запись. Значение должно начинаться с подчеркивания _. Это поле идентифицирует конкретную службу или протокол, которые определяет запись SRV. Примеры общих имен служб, используемых в записях SRV, включают "_sip" для служб SIP (Session Initiation Protocol), "_ldap" для служб LDAP (Lightweight Directory Access Protocol), "_xmpp" для служб XMPP (Extensible Messaging and Presence Protocol) и т. д.

•︎ proto string

Поле указывает транспортный протокол, используемый для сервиса, определенного в записи. Значение должно начинаться с подчеркивания _, например _tcp. Это поле указывает, использует ли сервис TCP (Transmission Control Protocol), UDP (User Datagram Protocol) или другой транспортный протокол для связи.

•︎ priority number

Указывает приоритет целевого хоста в записи SRV. Он указывает порядок, в котором следует использовать целевые хосты, когда для определенной службы доступно несколько хостов

•︎ weight number

Используется вместе с полем priority для предоставления способа балансировки нагрузки между несколькими записями SRV с одинаковым приоритетом. Поле "weight" указывает относительный вес записи SRV по сравнению с другими записями SRV с одинаковым приоритетом

•︎ port number

Указывает номер порта TCP или UDP, на котором доступна указанная в записи служба.

•︎ target string

Указывает доменное имя целевого хоста, предоставляющего услугу. Это поле содержит имя хоста сервера, который предлагает услугу, указанную в записи SRV

•︎ CAA object

CAA позволяет владельцу доменного имени DNS указать один или несколько центров сертификации (CA), уполномоченных выдавать сертификаты для домена.

•︎ value string

Указывает доменное имя CA (центра сертификации), который уполномочен выдавать сертификаты SSL/TLS для соответствующего домена.

•︎ tag enum

Указывает тип свойства

issue определяет центры сертификации, уполномоченные выдавать сертификаты для домена

issuewild определяет центры сертификации, уполномоченные выдавать универсальные сертификаты для домена

iodef указывает адрес электронной почты, на который центры сертификации должны сообщать о нарушении политикиs

•︎ NS object

NS - данный тип записи указывает авторитативный DNS сервер для доменного имени (данный сервер содержит актуальные записи DNS). Зачастую домен делегируется нескольким серверам DNS и имеет несколько NS записей, которые указывают на primary и backup серверы.

Regery запрещает создание NS записи для корневого домена зоны. Для этого воспользуйтесь инструментом смены Провайдер DNS.

•︎ ns string

Сервера доменных имен

•︎ ALIAS object

ALIAS - как и запись CNAME связывает имя-псевдоним с другим доменным именем (канонический домен).

Данный тип записи напрямую не описан в спецификации DNS и, в отличие от CNAME, позволяет указывать дополнительно записи других типов. Например, если запись AAAA запрашивается клиентом DNS, но не существует для домена-псевдонима, то она будет рекурсивно запрошена у канонического домена. Если запись AAAA существует, то её значение будет возвращено без рекурсивного запроса.

•︎ target string

Полное доменное имя. Значение может содержать @ для ссылки на корневое (apex) доменное имя. Например, для apex example.com цель www.@ приведет к значению, отображаемому как www.example.com

HTTP ENDPOINT
GET /v1/domains/:domain/records?offset=:offset&limit=:limit

ПРИМЕР ЗАПРОСА: GET /v1/domains/example.com/records?offset=50

ПРИМЕР ОТВЕТА: HTTP 200 OK
{ "records": [ { "type": "A", "name": "@", "address": "192.168.0.1", "ttl": 3600 }, { "type": "CNAME", "name": "www", "target": "@", "ttl": 3600 } ] }

Внешний API

Список записей ресурсов DNS

Параметры URL

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

Определения типов