API управления доменами

Регистрируйте освобождающиеся домены и управляйте своей учетной записью с помощью API Dynadot для доменов! Наш API для доменов позволяет искать, регистрировать, продлевать и удалять доменные имена программно с помощью вашего собственного программного обеспечения на ваших серверах. С помощью нашего API для доменов вы также можете удобно устанавливать серверы имен, параметры продления и управлять папками для ваших доменов. Наш API для доменов доступен для всех учетных записей, так что воспользуйтесь им сегодня!

Хотите больше возможностей? Попробуйте наш расширенный API для доменов!

Начало работы с API управления доменами

Запросы к нашему API для доменов выполняются к следующему URL-адресу:

https://api.dynadot.com/api2.html

Обратите внимание, что в целях безопасности запросы должны отправляться через https (защищенное соединение). В каждый момент времени может быть обработан только 1 запрос, поэтому прежде чем посылать новый запрос, подождите пока завершится текущий. Запрос должен включать в себя следующие параметры:

Параметр запроса
Пояснение
keyВаш ключ доступа к API, его можно найти в контрольной панели учетной записи.
commandВ данный момент поддерживаются команды: "search" (искать) и "register" (регистрировать)

Результаты имеют вид текстового файла с запятой в качестве разделителя. Первая строка — результат выполнения команды. Количество полей в этой строке: 2.

Поле результата
Пояснение
1Результат этого вызова API:
ok - команда выполнена
error - команда не выполнена
2Подробности результата выполнения команды, это поле используется только при результате "error"

Вторая строка пустая. Последующие строки — результаты команды, например, результаты поиска.

Команда поиска search

При вызове команды search, должны быть включены следующие параметры:

Параметр поискового запроса
Пояснение
domain0 - domain99Доменное имя, которое вы ищете, можно указать до 100 доменов
language0 - language99 (необязательно)Метка языка для соответствующего домена, используется только для IDN
show_price (необязательно)Если вы хотите показать цену в валюте вашего аккаунта, установите значение «1».

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 5 полей.

Поле результата поиска
Пояснение
1Параметр, указывающий домен, например: domain0
2Имя домена, по которому ведется поиск, например: mydomain.com
3Язык, если указан, например:spa
4Результат поиска:
yes - домен доступен
no - домен недоступен
offline - центральный реестр этого домена в настоящее время недоступен
system_busy - все соединения заняты
error - при обработке запроса возникла синтаксическая ошибка или ошибка реестра
5Дополнительная информация о результате/цене, используется, только если получен результат "error" или в запросе для "show_price" установлено значение "1"

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

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1

Ответ

ok, domain0,mydomain.com,,no, domain1,mydomain.net,,yes,10.99 in USD

Команда регистрации register

Вызов команды register создаст и обработает заявку на регистрацию. У вас должно быть достаточно средств на счету учетной записи, чтобы оплатить заказ. При вызове команды register должны быть включены следующие параметры:

Параметр запроса на регистрацию
Пояснение
domainДоменное имя, которое вы хотите зарегистрировать, максимум 1 за запрос.
languageМетка языка для запрашиваемого домена, нужна только для доменов IDN
durationНа сколько лет вы хотите зарегистрировать домен
option0 (при необходимости)The .BE registrant name
option1 (при необходимости)The .BE registrant organization name (optional)

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 3 полей.

Поле результата регистрации
Пояснение
1Результат запроса на регистрацию:
success - домен зарегистрирован
not_available - домен недоступен
insufficient_funds - на балансе учетной записи недостаточно средств для регистрации
offline - центральный реестр этого домена в настоящее время недоступен
system_busy - все соединения заняты
error - при обработке запроса возникла синтаксическая ошибка или ошибка реестра
2Подробности результата выполнения команды, это поле используется только при результате "error"
3Дата окончания регистрации домена в формате времени unix (миллисекунды с полночи по UTC 1 января 1970 года). Используется только при результате "success"

Пример регистрации

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=register&domain=mydomain.com&duration=1

Ответ

ok, success,,1180897681932

Команда удаления delete

Calling the delete command will delete a domain that is still in the grace period. Your account balance will be credited back the registration fee minus any deletion fees (see our grace deletion page for more info). Domains that have been renewed, or that have been moved to a new account cannot be deleted through the API. If calling the delete command, the following parameters should be included:

Параметр запроса на удаление
Пояснение
domainДоменное имя, которое вы хотите удалить, количество доменов, которое можно удалить за один запрос: 1

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 2 полей.

Поле результата удаления
Пояснение
1Результат запроса на удаление:
success - домен удален
grace_expired - льготный период уже истек
too_soon - нельзя удалить домен в течение часа после регистрации
offline - центральный реестр этого домена в настоящее время недоступен
error - при обработке запроса возникла синтаксическая ошибка или ошибка реестраerror - при обработке запроса возникла синтаксическая ошибка или ошибка реестра
2Подробности результата выполнения команды, это поле используется только при результате "error"

Пример удаления

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=delete&domain=mydomain.com

Ответ

ok, success,

Команда продления renew

Calling the renew command will create and process a renewal order. You must have enough account balance to pay for the order. If calling the renew command, the following parameters should be included:

Параметр запроса на продление
Пояснение
domainДомен, который вы хотите продлить, только 1 домен может быть продлен за один запрос
durationНа сколько лет вы хотите продлить домен
year (необязательно)Текущий год окончания регистрации домена

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 3 полей.

Параметр запроса на продление
Пояснение
1Результат запроса на продление:
success - домен успешно продлен
insufficient_funds - на балансе учетной записи недостаточно средств для продления
offline - центральный реестр этого домена в настоящее время недоступен
error - при обработке запроса возникла синтаксическая ошибка или ошибка реестра
2Подробности результата выполнения команды, это поле используется только при результате "error"
3Дата окончания регистрации домена в формате времени unix (миллисекунды с полночи по UTC 1 января 1970 года). Используется только при результате "success"

Пример продления

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=renew&domain=mydomain.com&duration=1

Ответ

ok, success,,1180897681932

Команда получения серверов имен

При вызове команды получения серверов имен должны быть указаны следующие параметры:

Параметр запроса получения серверов имен
Пояснение
domainДомен, для которого вы хотите получить информацию о серверах имен, за один запрос может быть получена информация только для 1 сервера.

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 2 полей.

Поле результата получения серверов имен
Пояснение
1Результат запроса получения серверов имен:
success - серверы имен возвращены
offline - центральный реестр этого домена в настоящее время недоступен
error - при обработке запроса возникла синтаксическая ошибка или ошибка реестра
2Подробная информация о серверах имен (ns0 - ns12) или подробности о результате, если результат "error"
3Дополнительная информация о параметрах серверов имен, используется только при результате "success"

Пример получения серверов имен

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=get_ns&domain=mydomain.com

Ответ

ok, success,ns1.dynadot.com,ns2.dynadot.com,,,,,,,,,,,,Dynadot Forwarding

Команда установки серверов имен

При вызове команды установки серверов имен должны быть указаны следующие параметры:

Параметр запроса установки серверов имен
Пояснение
domainДомен, параметры которого вы хотите обновить, за один запрос может быть обновлена информация только для 1 сервера.
ns0 - ns12Сервера имен, которые вы хотите установить для домена, можно указать до 13 серверов имен, но они должны быть предварительно внесены в вашу учетную запись.

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 2 полей.

Поле результата установки серверов имен
Пояснение
1Результат запроса установки серверов имен:
success - серверы имен установлены
offline - центральный реестр этого домена в настоящее время недоступен
error - при обработке запроса возникла синтаксическая ошибка или ошибка реестра
2Подробности результата выполнения команды, это поле используется только при результате "error"

Пример установки серверов имен

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_ns&domain=mydomain.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

Ответ

ok, success,

Команда установки настроек продления

При вызове команды установки настроек продления должны быть указаны следующие параметры:

Параметр запроса установки настроек продления
Пояснение
domainДомен, параметры которого вы хотите обновить, за один запрос может быть обновлена информация только для 1 сервера.
renew-optionreset - сброс параметра продления к значению «без опции продления» (no renew option)
donot - установка для параметра продления домена значения «не продлевать»
auto - установка для параметра продления домена значения «автопродление»

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 2 полей.

Поле результата установки настроек продления
Пояснение
1Результат запроса set renew options:
success - параметры продления установлены
error - при обработке запроса возникла ошибка синтаксиса
2Подробности результата выполнения команды, это поле используется только при результате "error"

Пример установки настроек продления

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_renew_option&domain=mydomain.com&renew-option=donot

Ответ

ok, success,

Команда установки папки

При вызове команды установки папки должны быть указаны следующие параметры:

Параметр запроса установки папки
Пояснение
domainДомен, параметры которого вы хотите обновить, за один запрос может быть обновлена информация только для 1 сервера.
folderИмя папки, в которую вы хотите переместить свой домен
Если вы хотите переместить домен в папку по умолчанию, используйте имя папки "Default"
Имя папки чувствительно к регистру, например "Folder1" и "folder1" — две разные папки

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 2 полей.

Параметр запроса установки папки
Пояснение
1Результат запроса установки папки:
success - папка успешно установлена
error - при обработке запроса возникла ошибка синтаксиса
2Подробности результата выполнения команды, это поле используется только при результате "error"

Пример установки папки

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_folder&domain=mydomain.com&folder=folder1

Ответ

ok, success,

Команда is-processing

При вызове команды is-processing требуются указать следующие параметры:

Параметр запроса is-processing
Пояснение
дополнительных параметров не требуется

Для каждого запрошенного домена будет получена 1 строка. В каждой строке будет 1 полей.

Поле результата is-processing
Пояснение
1Результат запроса is_processing:
yes - обрабатывается запрос, не следует отправлять новый запрос
no - нет запросов в обработке. Можно отправлять новый запрос.

Пример is-processing

Запрос

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=is_processing

Ответ

ok, yes,

Языки

Afrikaans:afr Chinese:chi Arabic:ara Persian:per Russian:rus Japanese:jpn Spanish:spa Hebrew:heb Korean:kor Bulgarian:bul Chinese-Simplified:zh-cn French:fre Hungarian:hun Turkish:tur Danish:dan Thai:tha German:ger Hindi:hin Greek:gre Icelandic:ice Portuguese:por Swedish:swe Polish:pol Ukrainian:ukr Chinese-Traditional:zh-tw Bosnian:bos Czech:cze Norwegian:nor Finnish:fin Italian:ita Cyrillic:cyrl Belarusian:bel Georgian:geo Vietnamese:vie Latvian:lav Bengali:ben Albanian:alb Romanian:rum Serbian:scc Tamil:tam Panjabi:pan Slovak:slo Armenian:arm Irish:gle Catalan:cat Urdu:urd Slovenian:slv Gujarati:guj Lithuanian:lit Macedonian:mac Khmer:khm Telugu:tel Dutch:dut Kazakh:kaz Malayalam:mal Welsh:wel Tibetan:tib Estonian:est Indic:inc Mongolian:mon Gaelic:gla Bodo:brx Uzbek:uzb Somali:som Javanese:jav Pushto:pus Swahili:swa Aragonese:arg Assamese:asm Sanskrit:san Chechen:che Kirghiz:kir Luxembourgish:ltz Maltese:mlt Kashmiri:kas Yiddish:yid Burmese:bur Nepali:nep Carib:car Coptic:cop Malay:may Syriac:syr Oriya:ori Samoan:smo Asturian:ast Avestan:ave Awadhi:awa Azerbaijani:aze Balinese:ban Baluchi:bal Basa:bas Bashkir:bak Basque:baq Bhojpuri:bho Chuvash:chv Corsican:cos Croatian:scr Divehi:div Dogri:doi Faroese:fao Fijian:fij Frisian:fry Gondi:gon Indonesian:ind Ingush:inh Kurdish:kur Lao:lao Maori:mao Moldavian:mol Ossetian:oss Rajasthani:raj Sardinian:srd Sindhi:snd Sinhalese:sin Tajik:tgk Latin:latn Konkani:knn Maithili:mai Marathi:mar Punjabi:pun