Войти

Добавление записи

Метод HTTP

POST

URL ресурса

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

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

Параметр

Описание

domain_name

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

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_name

Имя записи. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате. Обязательно должно содержать в себе доменное имя. Например: foo.example.com, при добавлении записи в домен example.com.

record_value

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

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

  • 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

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

record_status

Сообщение об успешном добавлении записи

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

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

record_name=www.example.com&record_type=A&record_value=203.0.113.1&record_ttl=3600

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

{
"status": "ok",
"response": {
"record_id": 1,
"record_status": "added"
}
}