Войти

Получение списка записей

Метод HTTP

GET

URL ресурса

https://api.zilore.com/dns/v1/domains/{domain_name}/records

Параметры запроса

Параметр

Описание

domain_name

Доменное имя. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате.

Дополнительные параметры

Параметр

Описание

offset

Пропуск заданного количества записей в ответе

limit

Ограничение количества записей в ответе

order_by

Параметр сортировки, принимает значение:

  • record_id — Идентификатор записи
  • idn_record_name — Имя записи в Unicode формате
  • record_type — Тип записи
  • idn_record_value — Значение записи в Unicode формате
  • record_ttl — Максимальное разрешенное время кеширования записи

order_param

Параметр сортировки, принимает значение:

  • asc — по алфавиту / возрастанию (A-Z)
  • desc — по алфавиту в обратном порядке / убыванию (Z-A)

search_text

Поиск по имени записи в Unicode формате, типу записи, значению записи в Unicode формате, времени жизни записи.

Для точного совпадения необходимо дополнительно использовать параметр strict_search=yes. Для поиска по определенному типу записи — search_record_type=A/AAAA/CNAME/ALIAS/MX/TXT/NS/SRV/PTR/CAA.

Поля ответа

Параметр

Описание

record_id

Идентификатор записи

record_name

Имя записи в Unicode формате

record_status

Статус записи:

  • enabled — Активна
  • disabled — Неактивна

record_type

Тип записи:

  • A — Устанавливает соответствие между доменным именем/субдоменом и его IPv4-адресом
  • AAAA — Устанавливает соответствие между доменным именем/субдоменом и его IPv6-адресом
  • CNAME — Устанавливает соответствие между субдоменом и другим доменным именем (не применимо для доменного имени непосредственно)
  • ALIAS — Устанавливает соответствие между доменным именем/субдоменом и другим доменным именем (применимо без ограничений)
  • MX — Указывает на почтовые сервера для доменного имени/субдомена
  • TXT — Содержит произвольную текстовую информацию для доменного имени/субдомена
  • NS — Указывает на авторитативные DNS-сервера для доменного имени/субдомена
  • SRV — Указывает месторасположение серверов для различных сервисов/субдомена
  • PTR — Устанавливает соответствие между IP-адресом и его доменным именем/субдоменом
  • CAA — Определяет политику выпуска SSL/TLS-сертификатов для доменного имени/субдомена
  • SOA — Содержит набор системных параметров, необходимых для корректного функционирования доменного имени (нередактируемая запись, поддерживается автоматически)

record_value

Значение записи в Unicode формате

record_ttl

Максимальное разрешенное время кеширования записи

is_geo

Является ли запись GEO-записью по умолчанию?

  • yes — Да
  • no — Нет

is_failover

Настроен ли Фэйловер для записи?

  • yes — Да
  • no — Нет

Пример запроса

GET https://api.zilore.com/dns/v1/domains/example.com/records?offset=0&limit=5&order_by=idn_record_name&order_param=asc
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0

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

{
"status": "ok",
"response": [{
"record_id": "1",
"record_status": "enabled",
"record_name": "foo.example.com",
"record_type": "CNAME",
"record_value": "example.com",
"record_ttl": "3600",
"is_geo": "no",
"is_failover": "no"
}, {
"record_id": "2",
"record_status": "enabled",
"record_name": "www.example.com",
"record_type": "CNAME",
"record_value": "example.com",
"record_ttl": "3600",
"is_geo": "no",
"is_failover": "no"
}, {
"record_id": "3",
"record_status": "enabled",
"record_name": "example.com",
"record_type": "A",
"record_value": "8.8.8.8",
"record_ttl": "60",
"is_geo": "no",
"is_failover": "no"
}, {
"record_id": "4",
"record_status": "enabled",
"record_name": "example.com",
"record_type": "TXT",
"record_value": "\"hello\"",
"record_ttl": "3600",
"is_geo": "no",
"is_failover": "no"
}, {
"record_id": "5",
"record_status": "disabled",
"record_name": "example.com",
"record_type": "A",
"record_value": "8.8.4.4",
"record_ttl": "3600",
"is_geo": "yes",
"is_failover": "no"
}]
}