Функции услуги «DNS-Хостинг»

Модуль: dns_hosting

Доменная зона

Создать зону

Создание зоны проходит в два этапа: создание доменной зоны, делегирование домена.

От пользователя требуется:

  • Выполнить функцию create_dns_zone, которая создаст зону для домена
  • Делегировать домен при помощи инструментов регистратора домена. Для этого необходимо изменить NS сервера вашего домена на ns1.codeblast.ru, ns2.codeblast.ru

Делегирование долгий процесс и изменения не сразу вступят в силу. Проверить результаты делегирования можно с помощью функции whois_domain.

Примечание

DEFAULT TTL – Время жизни кэша. Рекомендуемое значение 86400 секунд.

Примечание

MINIMUM TTL - Время жизни кэша отрицательного ответа о не существующих в зоне ресурсных записях. Рекомендуемое значение 10800 секунд.

Функция: create_dns_zone

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

https://api.codeblast.ru/dns_hosting/create_dns_zone?token_data=data:string
                                                    &dns_hosting_id=1
                                                    &dns_zone_name=demo.ru
                                                    &dns_zone_default_ttl=86400
                                                    &dns_zone_minimum_ttl=10800

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_zone_id>425</dns_zone_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_zone_id": "425",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_hosting_id number id заказа услуги
dns_zone_name string доменное имя зоны
dns_zone_default_ttl number время жизни кэша для зоны
dns_zone_minimum_ttl number время жизни кэша отрицательного ответа

Поля ответа:

Поле Тип Описание
dns_zone_id number id зоны
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_HOSTING_ID ошибка ввода id заказа услуги
"[0-9]{1,20}"
REG_DNS_ZONE_NAME ошибка ввода доменного имени зоны
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_ZONE_DEFAULT_TTL ошибка ввода времени жизни кэша зоны
"[600, 2147483647]"
RNG_DNS_ZONE_MINIMUM_TTL ошибка ввода времени жизни кэша отрицательного ответа
"[300, 10800]"
AUTHORIZATION_FAIL ошибка авторизации
ORDER_NOT_EXISTS услуга не заказана
DNS_ZONE_EXISTS зона с таким именем домена уже существует
MANY_DNS_ZONES достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить зону

Удаляет зону и ресурсные записи относящиеся к ней.

Функция: delete_dns_zone

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

https://api.codeblast.ru/dns_hosting/delete_dns_zone?token_data=data:string
                                                    &dns_zone_id=425

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить зону

Изменяет SOA запись зоны.

Примечание

DEFAULT TTL – Время жизни кэша. Рекомендуемое значение 86400 секунд.

Примечание

MINIMUM TTL - Время жизни кэша отрицательного ответа о не существующих в зоне ресурсных записях. Рекомендуемое значение 10800 секунд.

Функция: change_dns_zone

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

https://api.codeblast.ru/dns_hosting/change_dns_zone?token_data=data:string
                                                    &dns_zone_id=425
                                                    &dns_zone_default_ttl=86400
                                                    &dns_zone_minimum_ttl=10800

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_zone_default_ttl number время жизни кэша для зоны
dns_zone_minimum_ttl number время жизни кэша отрицательного ответа

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
RNG_DNS_ZONE_DEFAULT_TTL ошибка ввода времени жизни кэша зоны
"[600, 2147483647]"
RNG_DNS_ZONE_MINIMUM_TTL ошибка ввода времени жизни кэша отрицательного ответа
"[300, 10800]"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перенести зону

Предоставляет возможность перенести зону и относящиеся к ней записи из одного заказа в другой.

Функция: transfer_dns_zone

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

https://api.codeblast.ru/dns_hosting/transfer_dns_zone?token_data=data:string
                                                      &dns_zone_id=425
                                                      &dns_hosting_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_hosting_id number id заказа услуги, куда осуществляется перенос

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_HOSTING_ID ошибка ввода id заказа услуги
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
ORDER_NOT_EXISTS услуга не заказана
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_ZONES тарифные параметры не покрывают число доменных зон
MANY_DNS_RECORDS тарифные параметры не покрывают число ресурсных записей
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать зону

Получение параметров SOA записи зоны, имени домена, даты и времени создания зоны.

Функция: show_dns_zone

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

https://api.codeblast.ru/dns_hosting/show_dns_zone?token_data=data:string
                                                  &dns_zone_id=425

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_zone_name>demo.ru</dns_zone_name>
    <dns_zone_default_ttl>86400</dns_zone_default_ttl>
    <dns_zone_minimum_ttl>10800</dns_zone_minimum_ttl>
    <dns_zone_datetime>2014-10-20 18:26:27</dns_zone_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_zone_name": "demo.ru",
  "dns_zone_default_ttl": "86400",
  "dns_zone_minimum_ttl": "10800",
  "dns_zone_datetime": "2014-10-20 18:26:27",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_zone_name string имя домена
dns_zone_default_ttl number время жизни кэша для зоны
dns_zone_minimum_ttl number время жизни кэша отрицательного ответа
dns_zone_datetime datetime дата и время создания зоны
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id зон

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

Функция: list_dns_zone_id

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

https://api.codeblast.ru/dns_hosting/list_dns_zone_id?token_data=data:string
                                                     &dns_hosting_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_zone_id>
        <dns_zone_id>425</dns_zone_id>
        <dns_zone_id>782</dns_zone_id>
    </list_dns_zone_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_zone_id": [
    "425",
    "782"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_hosting_id number id заказа услуги

Поля ответа:

Поле Тип Описание
dns_zone_id number id зоны
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_HOSTING_ID ошибка ввода id заказа услуги
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись A

Создать запись

Функция предназначена для создания записи A. Назначение записи: связать домен или поддомен с адресом IPv4. У всех записей типа А, относящихся к одному имени, значение TTL должно быть одинаковым.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_a

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

https://api.codeblast.ru/dns_hosting/create_dns_record_a?token_data=data:string
                                                        &dns_zone_id=284
                                                        &dns_record_a_name=demo.ru
                                                        &dns_record_a_ipv4=83.74.89.21
                                                        &dns_record_a_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_a_id>2632</dns_record_a_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_a_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_a_name string полное имя домена, которому назначается IPv4 адрес
dns_record_a_ipv4 string адрес записи в формате IPv4
dns_record_a_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_a_id number id записи A
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_A_NAME ошибка ввода полного имени домена
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_A_IPV4 ошибка ввода адреса записи в формате IPv4
"[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}"
RNG_DNS_RECORD_A_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_A_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись A.

Функция: delete_dns_record_a

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_a?token_data=data:string
                                                        &dns_record_a_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_a_id number id записи A

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_A_ID ошибка ввода id записи A
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_A_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи A.

Функция: change_dns_record_a

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

https://api.codeblast.ru/dns_hosting/change_dns_record_a?token_data=data:string
                                                        &dns_record_a_id=2632
                                                        &dns_record_a_name=demo.ru
                                                        &dns_record_a_ipv4=83.74.89.10
                                                        &dns_record_a_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_a_id number id записи A
dns_record_a_name string полное имя домена, которому назначается IPv4 адрес
dns_record_a_ipv4 string адрес записи в формате IPv4
dns_record_a_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_A_ID ошибка ввода id записи A
"[0-9]{1,20}"
REG_DNS_RECORD_A_NAME ошибка ввода полного имени домена
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_A_IPV4 ошибка ввода адреса записи в формате IPv4
"[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}"
RNG_DNS_RECORD_A_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_A_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_A_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_a

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

https://api.codeblast.ru/dns_hosting/show_dns_record_a?token_data=data:string
                                                      &dns_record_a_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_a_name>demo.ru</dns_record_a_name>
    <dns_record_a_ipv4>83.74.89.21</dns_record_a_ipv4>
    <dns_record_a_ttl>86400</dns_record_a_ttl>
    <dns_record_a_datetime>2014-10-22 18:30:12</dns_record_a_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_a_name": "demo.ru",
  "dns_record_a_ipv4": "83.74.89.21",
  "dns_record_a_ttl": "86400",
  "dns_record_a_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_a_id number id записи A

Поля ответа:

Поле Тип Описание
dns_record_a_name string полное имя домена, которому назначается IPv4 адрес
dns_record_a_ipv4 string адрес записи в формате IPv4
dns_record_a_ttl number время жизни записи в секундах
dns_record_a_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_A_ID ошибка ввода id записи A
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_A_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_a_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_a_id?token_data=data:string
                                                         &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_a_id>
        <dns_record_a_id>2632</dns_record_a_id>
        <dns_record_a_id>127</dns_record_a_id>
    </list_dns_record_a_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_a_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_a_id number id записи A
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись AAAA

Создать запись

Функция предназначена для создания записи AААА. Назначение записи: связать домен или поддомен с адресом IPv6. Сокращенная запись IPv6 не принимается, необходима полная запись адреса. У всех записей типа АAAA, относящихся к одному имени, значение TTL должно быть одинаковым.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_aaaa

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

https://api.codeblast.ru/dns_hosting/create_dns_record_aaaa?token_data=data:string
                                                           &dns_zone_id=284
                                                           &dns_record_aaaa_name=www.demo.ru
                                                           &dns_record_aaaa_ipv6=2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d
                                                           &dns_record_aaaa_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_aaaa_id>2632</dns_record_aaaa_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_aaaa_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_aaaa_name string полное имя домена, которому назначается IPv6 адрес
dns_record_aaaa_ipv6 string адрес записи в формате IPv6
dns_record_aaaa_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_aaaa_id number id записи AAAA
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_AAAA_NAME ошибка ввода полного имени домена
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_AAAA_IPV6 ошибка ввода адреса записи в формате IPv6
"([0-9A-Fa-f]{1,4}:){1,7}[0-9A-Fa-f]{1,4}"
RNG_DNS_RECORD_AAAA_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_AAAA_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись AAAA.

Функция: delete_dns_record_aaaa

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_aaaa?token_data=data:string
                                                           &dns_record_aaaa_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_aaaa_id number id записи AAAA

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_AAAA_ID ошибка ввода id записи AAAA
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_AAAA_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи AAAA.

Функция: change_dns_record_aaaa

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

https://api.codeblast.ru/dns_hosting/change_dns_record_aaaa?token_data=data:string
                                                           &dns_record_aaaa_id=2632
                                                           &dns_record_aaaa_name=www.demo.ru
                                                           &dns_record_aaaa_ipv6=2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d
                                                           &dns_record_aaaa_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_aaaa_id number id записи AAAA
dns_record_aaaa_name string полное имя домена, которому назначается IPv6 адрес
dns_record_aaaa_ipv6 string адрес записи в формате IPv6
dns_record_aaaa_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_AAAA_ID ошибка ввода id записи AAAA
"[0-9]{1,20}"
REG_DNS_RECORD_AAAA_NAME ошибка ввода полного имени домена
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_AAAA_IPV6 ошибка ввода адреса записи в формате IPv6
"([0-9A-Fa-f]{1,4}:){1,7}[0-9A-Fa-f]{1,4}"
RNG_DNS_RECORD_AAAA_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_AAAA_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_AAAA_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_aaaa

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

https://api.codeblast.ru/dns_hosting/show_dns_record_aaaa?token_data=data:string
                                                         &dns_record_aaaa_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_aaaa_name>www.demo.ru</dns_record_aaaa_name>
    <dns_record_aaaa_ipv6>2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d</dns_record_aaaa_ipv6>
    <dns_record_aaaa_ttl>86400</dns_record_aaaa_ttl>
    <dns_record_aaaa_datetime>2014-10-22 18:30:12</dns_record_aaaa_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_aaaa_name": "www.demo.ru",
  "dns_record_aaaa_ipv6": "2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d",
  "dns_record_aaaa_ttl": "86400",
  "dns_record_aaaa_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_aaaa_id number id записи AAAA

Поля ответа:

Поле Тип Описание
dns_record_aaaa_name string полное имя домена, которому назначается IPv6 адрес
dns_record_aaaa_ipv6 string адрес записи в формате IPv6
dns_record_aaaa_ttl number время жизни записи в секундах
dns_record_aaaa_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_AAAA_ID ошибка ввода id записи AAAA
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_AAAA_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_aaaa_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_aaaa_id?token_data=data:string
                                                            &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_aaaa_id>
        <dns_record_aaaa_id>2632</dns_record_aaaa_id>
        <dns_record_aaaa_id>127</dns_record_aaaa_id>
    </list_dns_record_aaaa_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_aaaa_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_aaaa_id number id записи AAAA
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись CNAME

Создать запись

Функция предназначена для создания записи CNAME. CNAME (каноническое имя или псевдоним) используется как ссылка на другое имя. Если запись создаётся для домена, то на него нельзя заносить записи любого другого типа. Если для поддомена, то указывается имя поддомена.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_cname

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

https://api.codeblast.ru/dns_hosting/create_dns_record_cname?token_data=data:string
                                                            &dns_zone_id=284
                                                            &dns_record_cname_name=blog.demo.ru
                                                            &dns_record_cname_alias=newdemo.ru
                                                            &dns_record_cname_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_cname_id>2632</dns_record_cname_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_cname_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_cname_name string полное имя домена, которому назначается псевдоним
dns_record_cname_alias string полное имя домена, на которое выполняется перенаправление
dns_record_cname_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_cname_id number id записи CNAME
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_CNAME_NAME ошибка ввода полного имени домена
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_CNAME_ALIAS ошибка ввода полного имени домена перенаправления
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_CNAME_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_CNAME_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись CNAME.

Функция: delete_dns_record_cname

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_cname?token_data=data:string
                                                            &dns_record_cname_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_cname_id number id записи CNAME

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_CNAME_ID ошибка ввода id записи CNAME
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_CNAME_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи CNAME.

Функция: change_dns_record_cname

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

https://api.codeblast.ru/dns_hosting/change_dns_record_cname?token_data=data:string
                                                            &dns_record_cname_id=2632
                                                            &dns_record_cname_name=blog.demo.ru
                                                            &dns_record_cname_alias=newdemo.ru
                                                            &dns_record_cname_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_cname_id number id записи CNAME
dns_record_cname_name string полное имя домена, которому назначается псевдоним
dns_record_cname_alias string полное имя домена, на которое выполняется перенаправление
dns_record_cname_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_CNAME_ID ошибка ввода id записи CNAME
"[0-9]{1,20}"
REG_DNS_RECORD_CNAME_NAME ошибка ввода полного имени домена
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_CNAME_ALIAS ошибка ввода полного имени домена перенаправления
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_CNAME_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_CNAME_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_CNAME_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_cname

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

https://api.codeblast.ru/dns_hosting/show_dns_record_cname?token_data=data:string
                                                          &dns_record_cname_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_cname_name>blog.demo.ru</dns_record_cname_name>
    <dns_record_cname_alias>newdemo.ru</dns_record_cname_alias>
    <dns_record_cname_ttl>86400</dns_record_cname_ttl>
    <dns_record_cname_datetime>2014-10-22 18:30:12</dns_record_cname_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_cname_name": "blog.demo.ru",
  "dns_record_cname_alias": "newdemo.ru",
  "dns_record_cname_ttl": "86400",
  "dns_record_cname_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_cname_id number id записи CNAME

Поля ответа:

Поле Тип Описание
dns_record_cname_name string полное имя домена, которому назначается псевдоним
dns_record_cname_alias string полное имя домена, на которое выполняется перенаправление
dns_record_cname_ttl number время жизни записи в секундах
dns_record_cname_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_CNAME_ID ошибка ввода id записи CNAME
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_CNAME_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_cname_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_cname_id?token_data=data:string
                                                             &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_cname_id>
        <dns_record_cname_id>2632</dns_record_cname_id>
        <dns_record_cname_id>127</dns_record_cname_id>
    </list_dns_record_cname_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_cname_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_cname_id number id записи CNAME
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись MX

Создать запись

Функция предназначена для создания записи MX. MX (почтовый сервер) определяет сервер обмена почтой для данного домена. Поле dns_record_mx_priority определяет значение приоритетности почтового сервера, где 0 означает самый высокий приоритет, а 10 самый низкий. По умолчанию значение приоритета равно 10.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_mx

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

https://api.codeblast.ru/dns_hosting/create_dns_record_mx?token_data=data:string
                                                         &dns_zone_id=284
                                                         &dns_record_mx_name=demo.ru
                                                         &dns_record_mx_server=mx.yandex.ru
                                                         &dns_record_mx_priority=10
                                                         &dns_record_mx_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_mx_id>2632</dns_record_mx_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_mx_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_mx_name string полное имя домена, которому назначается почтовый сервер
dns_record_mx_server string полное имя домена почтового сервера
dns_record_mx_priority number приоритет почтового сервера
dns_record_mx_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_mx_id number id записи MX
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_MX_NAME ошибка ввода полного имени домена, которому назначается почтовый сервер
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_MX_SERVER ошибка ввода полного имени домена почтового сервера
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_MX_PRIORITY ошибка ввода приоритета почтового сервера
"[0, 65535]"
RNG_DNS_RECORD_MX_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_MX_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись MX.

Функция: delete_dns_record_mx

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_mx?token_data=data:string
                                                         &dns_record_mx_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_mx_id number id записи MX

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_MX_ID ошибка ввода id записи MX
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_MX_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи MX.

Функция: change_dns_record_mx

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

https://api.codeblast.ru/dns_hosting/change_dns_record_mx?token_data=data:string
                                                         &dns_record_mx_id=2632
                                                         &dns_record_mx_name=demo.ru
                                                         &dns_record_mx_server=mx.yandex.ru
                                                         &dns_record_mx_priority=10
                                                         &dns_record_mx_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_mx_id number id записи MX
dns_record_mx_name string полное имя домена, которому назначается почтовый сервер
dns_record_mx_server string полное имя домена почтового сервера
dns_record_mx_priority number приоритет почтового сервера
dns_record_aaaa_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_MX_ID ошибка ввода id записи MX
"[0-9]{1,20}"
REG_DNS_RECORD_MX_NAME ошибка ввода полного имени домена, которому назначается почтовый сервер
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_MX_SERVER ошибка ввода полного имени домена почтового сервера
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_MX_PRIORITY ошибка ввода приоритета почтового сервера
"[0, 65535]"
RNG_DNS_RECORD_MX_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_MX_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_MX_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_mx

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

https://api.codeblast.ru/dns_hosting/show_dns_record_mx?token_data=data:string
                                                       &dns_record_mx_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_mx_name>demo.ru</dns_record_mx_name>
    <dns_record_mx_server>mx.yandex.ru</dns_record_mx_server>
    <dns_record_mx_priority>10</dns_record_mx_priority>
    <dns_record_mx_ttl>86400</dns_record_mx_ttl>
    <dns_record_mx_datetime>2014-10-22 18:30:12</dns_record_mx_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_mx_name": "demo.ru",
  "dns_record_mx_server": "mx.yandex.ru",
  "dns_record_mx_priority": "10",
  "dns_record_mx_ttl": "86400",
  "dns_record_mx_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_mx_id number id записи MX

Поля ответа:

Поле Тип Описание
dns_record_mx_name string полное имя домена, которому назначается почтовый сервер
dns_record_mx_server string полное имя домена почтового сервера
dns_record_mx_priority number приоритет почтового сервера
dns_record_mx_ttl number время жизни записи в секундах
dns_record_mx_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_MX_ID ошибка ввода id записи MX
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_MX_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_mx_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_mx_id?token_data=data:string
                                                          &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_mx_id>
        <dns_record_mx_id>2632</dns_record_mx_id>
        <dns_record_mx_id>127</dns_record_mx_id>
    </list_dns_record_mx_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_mx_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_mx_id number id записи MX
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись NS

Создать запись

Функция предназначена для создания записи NS (сервер имен). Позволяет передать обслуживание поддомена на другие DNS-сервера. Количество записей типа NS в файле зоны должно соответствовать количеству DNS-серверов, обслуживающих поддомен.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_ns

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

https://api.codeblast.ru/dns_hosting/create_dns_record_ns?token_data=data:string
                                                         &dns_zone_id=284
                                                         &dns_record_ns_name=blog.demo.ru
                                                         &dns_record_ns_server=ns1.mydns.ru
                                                         &dns_record_ns_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_ns_id>2632</dns_record_ns_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_ns_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_ns_name string полное имя домена, которому назначается DNS-сервер
dns_record_ns_server string полное имя домена DNS-сервера
dns_record_ns_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_ns_id number id записи NS
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_NS_NAME ошибка ввода полного имени домена, которому назначается DNS-сервер
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_NS_SERVER ошибка ввода полного имени домена DNS-сервера
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_NS_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_NS_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись NS.

Функция: delete_dns_record_ns

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_ns?token_data=data:string
                                                         &dns_record_ns_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_ns_id number id записи NS

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_NS_ID ошибка ввода id записи NS
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_NS_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи NS.

Функция: change_dns_record_ns

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

https://api.codeblast.ru/dns_hosting/change_dns_record_ns?token_data=data:string
                                                         &dns_record_ns_id=2632
                                                         &dns_record_ns_name=blog.demo.ru
                                                         &dns_record_ns_server=ns1.mydns.ru
                                                         &dns_record_ns_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_ns_id number id записи NS
dns_record_ns_name string полное имя домена, которому назначается DNS-сервер
dns_record_ns_server string полное имя домена DNS-сервера
dns_record_ns_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_NS_ID ошибка ввода id записи NS
"[0-9]{1,20}"
REG_DNS_RECORD_NS_NAME ошибка ввода полного имени домена, которому назначается DNS-сервер
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_NS_SERVER ошибка ввода полного имени домена DNS-сервера
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_NS_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_NS_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_NS_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_ns

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

https://api.codeblast.ru/dns_hosting/show_dns_record_ns?token_data=data:string
                                                       &dns_record_ns_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_ns_name>blog.demo.ru</dns_record_ns_name>
    <dns_record_ns_server>ns1.mydns.ru</dns_record_ns_server>
    <dns_record_ns_ttl>86400</dns_record_ns_ttl>
    <dns_record_ns_datetime>2014-10-22 18:30:12</dns_record_ns_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_ns_name": "blog.demo.ru",
  "dns_record_ns_server": "ns1.mydns.ru",
  "dns_record_ns_ttl": "86400",
  "dns_record_ns_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_ns_id number id записи NS

Поля ответа:

Поле Тип Описание
dns_record_ns_name string полное имя домена, которому назначается DNS-сервер
dns_record_ns_server string полное имя домена DNS-сервера
dns_record_ns_ttl number время жизни записи в секундах
dns_record_ns_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_NS_ID ошибка ввода id записи NS
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_NS_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_ns_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_ns_id?token_data=data:string
                                                          &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_ns_id>
        <dns_record_ns_id>2632</dns_record_ns_id>
        <dns_record_ns_id>127</dns_record_ns_id>
    </list_dns_record_ns_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_ns_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_ns_id number id записи NS
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись SRV

Создать запись

Функция предназначена для создания записи SRV. Используется для поиска серверов, обеспечивающих работу тех или иных служб данного домена. Поле dns_record_srv_name определяет имя службы (LDAP, KERBEROS, XMPP, …) и прокол передачи (TCP, UDP). Поле dns_record_srv_priority определяет приоритет записи. Чем меньше значение, тем выше приоритет. Поле dns_record_srv_weight определяет вес SRV-записи относительно других SRV-записей для того же домена, с тем же приоритетом. Поле dns_record_srv_port определяет порт, на котором запущена служба. Поле dns_record_srv_target определяет имя домена сервера, который предоставляет данную службу.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_srv

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

https://api.codeblast.ru/dns_hosting/create_dns_record_srv?token_data=data:string
                                                          &dns_zone_id=284
                                                          &dns_record_srv_name=_ldap._tcp.demo.ru
                                                          &dns_record_srv_priority=0
                                                          &dns_record_srv_weight=100
                                                          &dns_record_srv_port=389
                                                          &dns_record_srv_target=ldap.company.ru
                                                          &dns_record_srv_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_srv_id>2632</dns_record_srv_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_srv_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_srv_name string имя службы и протокол передачи
dns_record_srv_priority number приоритет службы
dns_record_srv_weight number вес службы
dns_record_srv_port number порт службы
dns_record_srv_target string имя домена сервера, который предоставляет службу
dns_record_srv_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_srv_id number id записи SRV
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_SRV_NAME ошибка ввода имени службы и протокола передачи
"\_[a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_SRV_PRIORITY ошибка ввода приоритета службы
"[0, 65535]"
RNG_DNS_RECORD_SRV_WEIGHT ошибка ввода веса службы
"[0, 65535]"
RNG_DNS_RECORD_SRV_PORT ошибка ввода порта службы
"[0, 65535]"
REG_DNS_RECORD_SRV_TARGET ошибка ввода полного имени домена сервера, который предоставляет службу
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_SRV_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_SRV_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись SRV.

Функция: delete_dns_record_srv

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_srv?token_data=data:string
                                                          &dns_record_srv_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_srv_id number id записи SRV

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_SRV_ID ошибка ввода id записи SRV
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_SRV_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи SRV.

Функция: change_dns_record_srv

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

https://api.codeblast.ru/dns_hosting/change_dns_record_srv?token_data=data:string
                                                          &dns_record_srv_id=2632
                                                          &dns_record_srv_name=_ldap._tcp.demo.ru
                                                          &dns_record_srv_priority=0
                                                          &dns_record_srv_weight=100
                                                          &dns_record_srv_port=389
                                                          &dns_record_srv_target=ldap.company.ru
                                                          &dns_record_srv_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_srv_id number id записи SRV
dns_record_srv_name string имя службы и протокол передачи
dns_record_srv_priority number приоритет службы
dns_record_srv_weight number вес службы
dns_record_srv_port number порт службы
dns_record_srv_target string имя домена сервера, который предоставляет службу
dns_record_srv_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_SRV_ID ошибка ввода id записи SRV
"[0-9]{1,20}"
REG_DNS_RECORD_SRV_NAME ошибка ввода имени службы и протокола передачи
"\_[a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_SRV_PRIORITY ошибка ввода приоритета службы
"[0, 65535]"
RNG_DNS_RECORD_SRV_WEIGHT ошибка ввода веса службы
"[0, 65535]"
RNG_DNS_RECORD_SRV_PORT ошибка ввода порта службы
"[0, 65535]"
REG_DNS_RECORD_SRV_TARGET ошибка ввода полного имени домена сервера, который предоставляет службу
"[a-zа-яё0-9][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
RNG_DNS_RECORD_SRV_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_SRV_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_srv

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

https://api.codeblast.ru/dns_hosting/show_dns_record_srv?token_data=data:string
                                                        &dns_record_srv_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_srv_name>_ldap._tcp.demo.ru</dns_record_srv_name>
    <dns_record_srv_priority>0</dns_record_srv_priority>
    <dns_record_srv_weight>100</dns_record_srv_weight>
    <dns_record_srv_port>389</dns_record_srv_port>
    <dns_record_srv_target>ldap.company.ru</dns_record_srv_target>
    <dns_record_srv_ttl>86400</dns_record_srv_ttl>
    <dns_record_srv_datetime>2014-10-22 18:30:12</dns_record_srv_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_srv_name": "_ldap._tcp.demo.ru",
  "dns_record_srv_priority": "0",
  "dns_record_srv_weight": "100",
  "dns_record_srv_port": "389",
  "dns_record_srv_target": "ldap.company.ru",
  "dns_record_srv_ttl": "86400",
  "dns_record_srv_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_srv_id number id записи SRV

Поля ответа:

Поле Тип Описание
dns_record_srv_name string имя службы и протокол передачи
dns_record_srv_priority number приоритет службы
dns_record_srv_weight number вес службы
dns_record_srv_port number порт службы
dns_record_srv_target string имя домена сервера, который предоставляет службу
dns_record_srv_ttl number время жизни записи в секундах
dns_record_srv_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_SRV_ID ошибка ввода id записи SRV
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_SRV_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_srv_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_srv_id?token_data=data:string
                                                           &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_srv_id>
        <dns_record_srv_id>2632</dns_record_srv_id>
        <dns_record_srv_id>127</dns_record_srv_id>
    </list_dns_record_srv_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_srv_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_srv_id number id записи SRV
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Ресурсная запись TXT

Создать запись

Функция предназначена для создания записи с типом TXT. TXT (текст) используется для текстового описания имени домена. Поддерживаются только ASCII символы.

Примечание

TTL - время жизни записи в секундах. Диапазон времени жизни от 600 до 2147483647. Рекомендуемое значение 86400 секунд.

Функция: create_dns_record_txt

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

https://api.codeblast.ru/dns_hosting/create_dns_record_txt?token_data=data:string
                                                          &dns_zone_id=284
                                                          &dns_record_txt_name=blog.demo.ru
                                                          &dns_record_txt_content=MyBlog
                                                          &dns_record_txt_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_txt_id>2632</dns_record_txt_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_txt_id": "2632",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны
dns_record_txt_name string полное имя домена, которому добавляется текстовая запись
dns_record_txt_content string текст
dns_record_txt_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
dns_record_txt_id number id записи TXT
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
REG_DNS_RECORD_TXT_NAME ошибка ввода полного имени домена, которому добавляется текстовая запись
"[a-zа-яё0-9\_][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_TXT_CONTENT ошибка ввода текста
".{1,255}"
RNG_DNS_RECORD_SRV_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_TXT_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Удалить запись

Удаляет ресурсную запись TXT.

Функция: delete_dns_record_txt

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

https://api.codeblast.ru/dns_hosting/delete_dns_record_txt?token_data=data:string
                                                          &dns_record_txt_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_txt_id number id записи TXT

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_TXT_ID ошибка ввода id записи TXT
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_TXT_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Изменить запись

Функция предназначена для изменения записи TXT.

Функция: change_dns_record_txt

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

https://api.codeblast.ru/dns_hosting/change_dns_record_txt?token_data=data:string
                                                          &dns_record_txt_id=2632
                                                          &dns_record_txt_name=blog.demo.ru
                                                          &dns_record_txt_content=MyBlog
                                                          &dns_record_txt_ttl=86400

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_txt_id number id записи TXT
dns_record_txt_name string полное имя домена, которому добавляется текстовая запись
dns_record_txt_content string текст
dns_record_txt_ttl number время жизни записи в секундах

Поля ответа:

Поле Тип Описание
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_TXT_ID ошибка ввода id записи TXT
"[0-9]{1,20}"
REG_DNS_RECORD_TXT_NAME ошибка ввода полного имени домена, которому добавляется текстовая запись
"[a-zа-яё0-9\_][a-zа-яё0-9\.\-\_]{0,125}[a-zа-яё]"
REG_DNS_RECORD_TXT_CONTENT ошибка ввода текста
".{1,255}"
RNG_DNS_RECORD_SRV_TTL ошибка ввода времени жизни записи
"[600, 2147483647]"
DNS_RECORD_TXT_NAME_FAIL ошибка ввода имени домена
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MANY_DNS_RECORDS достигнут лимит заказа
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Показать запись

Получение содержимого записи по id.

Функция: show_dns_record_txt

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

https://api.codeblast.ru/dns_hosting/show_dns_record_txt?token_data=data:string
                                                        &dns_record_txt_id=2632

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <dns_record_txt_name>blog.demo.ru</dns_record_txt_name>
    <dns_record_txt_content>MyBlog</dns_record_txt_content>
    <dns_record_txt_ttl>86400</dns_record_txt_ttl>
    <dns_record_txt_datetime>2014-10-22 18:30:12</dns_record_txt_datetime>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "dns_record_txt_name": "blog.demo.ru",
  "dns_record_txt_content": "MyBlog",
  "dns_record_txt_ttl": "86400",
  "dns_record_txt_datetime": "2014-10-22 18:30:12",
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_record_txt_id number id записи TXT

Поля ответа:

Поле Тип Описание
dns_record_txt_name string полное имя домена,которому добавляется текстовая запись
dns_record_txt_content string текст
dns_record_txt_ttl number время жизни записи в секундах
dns_record_txt_datetime datetime дата и время создания записи
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_RECORD_TXT_ID ошибка ввода id записи TXT
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_RECORD_TXT_NOT_EXISTS запись не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет

Перечислить id записей

Получение списка ресурсных записей.

Функция: list_dns_record_txt_id

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

https://api.codeblast.ru/dns_hosting/list_dns_record_txt_id?token_data=data:string
                                                           &dns_zone_id=1

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

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<response>
    <list_dns_record_txt_id>
        <dns_record_txt_id>2632</dns_record_txt_id>
        <dns_record_txt_id>127</dns_record_txt_id>
    </list_dns_record_txt_id>
    <error_code>OK</error_code>
    <error_text>ошибок нет</error_text>
</response>

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

{
  "list_dns_record_txt_id": [
    "2632",
    "127"
  ],
  "error_code": "OK",
  "error_text": "ошибок нет"
}

Поля запроса:

Поле Тип Описание
token_data string токен
dns_zone_id number id зоны

Поля ответа:

Поле Тип Описание
dns_record_txt_id number id записи TXT
error_code string код ошибки
error_text string расшифровка

Коды ошибок:

Код ошибки Расшифровка
REG_TOKEN_DATA ошибка ввода токена
"[a-z0-9\-]{36}"
REG_DNS_ZONE_ID ошибка ввода id зоны
"[0-9]{1,20}"
AUTHORIZATION_FAIL ошибка авторизации
DNS_ZONE_NOT_EXISTS зона не существует
MAINTENANCE режим обслуживания
ERROR ошибка системы
OK ошибок нет