Добавление записи в шаблон - Документация по API

Метод HTTP

POST

URL ресурса

https://api.zilore.com/dns/v1/templates/{template_id}/records

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

Параметр	Описание
template_id	Идентификатор шаблона
record_name	Имя записи. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате. Обязательно должно содержать в себе переменную {domain_name}. Например: foo.{domain_name}.
record_type	Тип записи: A — Устанавливает соответствие между доменным именем/субдоменом и его IPv4-адресом AAAA — Устанавливает соответствие между доменным именем/субдоменом и его IPv6-адресом CNAME — Устанавливает соответствие между субдоменом и другим доменным именем (не применимо для доменного имени непосредственно) ALIAS — Устанавливает соответствие между доменным именем/субдоменом и другим доменным именем (применимо без ограничений) MX — Указывает на почтовые сервера для доменного имени/субдомена TXT — Содержит произвольную текстовую информацию для доменного имени/субдомена NS — Указывает на авторитативные DNS-сервера для доменного имени/субдомена SRV — Указывает месторасположение серверов для различных сервисов/субдомена PTR — Устанавливает соответствие между IP-адресом и его доменным именем/субдоменом CAA — Определяет политику выпуска SSL/TLS-сертификатов для доменного имени/субдомена
record_ttl	Максимальное разрешенное время кеширования записи. Список допустимых значений зависит от тарифного плана и доступен в методе list_valid_record_ttl.
record_value	Значение записи. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате. Формат значения зависит от типа записи.

Параметр record_name обязательно должен содержать в себе шаблон {domain_name}, куда будет подставляться имя домена, к которому применяется шаблон. Например: name.{domain_name}

{domain_name} может также использоваться и в record_value в записях допускающих в значении имя домена

Формат значения в зависимости от типа записи:

A - Формат: IPv4 адрес,
Пример: 203.0.113.1
AAAA - Формат: IPv6 адрес,
Пример: 2001:0db8:0000:0000:0000:0000:0000:0000
CNAME - Формат: Доменное имя,
Пример: www.example.com
ALIAS - Формат: Доменное имя,
Пример: www.example.com
MX - Формат: [Приоритет] [Доменное имя],
Пример: 10 mail.example.com
TXT - Формат: Текст, заключенный в двойные кавычки
Пример: "v=spf1 mx -all"
NS - Формат: Доменное имя,
Пример: ns1.example.com
SRV - Формат: [Приоритет] [Вес] [Порт] [Доменное имя],
Пример: 1 10 5269 xmpp.example.com
PTR - Формат: Доменное имя,
Пример: www.example.com
CAA - Формат: [Флаги] [Тег] [Значение],
Пример: 0 issue "example.com; param=value"

Значение параметра record_value TXT записей необходимо заключить в двойные кавычки.

Значение параметра record_value MX, CAA и SRV-записей необходимо разделить пробелом.

Поля ответа

Параметр	Описание
record_id	Идентификатор новой записи в шаблоне

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

POST https://api.zilore.com/dns/v1/templates/193/records
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0
Content-Type: application/x-www-form-urlencoded

record_name=example.{domain_name}&record_type=A&record_value=1.1.1.1&record_ttl=3600

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

{
"status": "ok",
"response": {
"record_status": "Custom template record added",
"record_id": 31
}
}