Получение списка GEO-записей - Документация по API

Метод HTTP

GET

URL ресурса

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

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

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

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

Параметр	Описание
offset	Пропуск заданного количества записей в ответе
limit	Ограничение количества записей в ответе
order_by	Параметр сортировки, принимает значение: idn_record_name — Имя записи в Unicode формате record_type — Тип записи idn_record_value — Значение записи в Unicode формате record_ttl — Максимальное разрешенное время кеширования записи record_region — GEO-идентификатор записи
order_param	Параметр сортировки, принимает значение: asc — по алфавиту / возрастанию (A-Z) desc — по алфавиту в обратном порядке / убыванию (Z-A)
search_text	Подстрока для поиска

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

Поиск осуществляется по названию, значению, ttl, типу и geo идентификатору (совпадение в любом из полей)

Поля ответа

Параметр	Описание
record_id	Идентификатор записи
record_name	Имя записи в Unicode формате
record_status	Статус записи: enabled — Активна disabled — Неактивна
record_type	Тип записи: A — Устанавливает соответствие между доменным именем/субдоменом и его IPv4-адресом AAAA — Устанавливает соответствие между доменным именем/субдоменом и его IPv6-адресом CNAME — Устанавливает соответствие между субдоменом и другим доменным именем (не применимо для доменного имени непосредственно) ALIAS — Устанавливает соответствие между доменным именем/субдоменом и другим доменным именем (применимо без ограничений)
record_value	Значение записи в Unicode формате
record_ttl	Максимальное разрешенное время кеширования записи
geo_region	GEO-идентификатор записи
geo_full_region	Полное название GEO-региона
default_records	Массив одноименных записей по умполчиню с полями: record_id — Идентификатор записи record_value — Значение записи в Unicode формате record_status — Статус записи (enabled\|disabled)
is_failover	Настроен ли Фэйловер для записи? yes — Да no — Нет

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

GET https://api.zilore.com/dns/v1/domains/example.com/geo
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0

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

{
"status": "ok",
"response": [{
"record_id": "13853",
"record_status": "enabled",
"record_name": "example.com",
"record_type": "A",
"record_value": "1.1.1.1",
"record_ttl": "3600",
"geo_region": "EU",
"geo_full_region": "Europe",
"default_records": [{
"record_id": "13852",
"record_value": "2.2.2.2",
"record_status": "1"
}],
"is_failover": "no"
}, {
"record_id": "65373",
"record_status": "enabled",
"record_name": "www.example.com",
"record_type": "A",
"record_value": "1.1.1.3",
"record_ttl": "60",
"geo_region": "_AF",
"geo_full_region": "Africa",
"default_records": [{
"record_id": "65370",
"record_value": "1.1.1.1",
"record_status": "1"
}, {
"record_id": "65371",
"record_value": "1.1.1.2",
"record_status": "1"
}],
"is_failover": "no"
}]
}