Начало работы с расширенным API для доменов
Requests to our Advanced Domain API are sent to the following URL:
https://api.dynadot.com/api3.xml
Обратите внимание, что в целях безопасности запросы должны отправляться через https (защищенное соединение). В каждый момент времени может быть обработан только 1 запрос, поэтому прежде чем посылать новый запрос, подождите пока завершится текущий. Запрос должен включать в себя следующие параметры:
Request ParameterПояснение
Request Parameter
Пояснение
KeyВаш ключ доступа к API, его можно найти в контрольной панели учетной записи.
Command, , , , , ,
, , , , , , , , , , , , , , , ,
, , , , , ,
, , , , , ,
, , , , , , ,
, ,
, , , , , , , , , , , ,
, , , , , , , , , , , , , ,
, ,
, , , ,
, , , , , ,
Our Advanced Domain API will return results in an XML format. The response you receive should contain 2 or 3 of the following fields:
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Команда поиска search
При вызове команды search, должны быть включены следующие параметры:
Параметр поискового запросаПояснение
Параметр поискового запроса
Пояснение
domain0 - domain99Имя домена, которое вы ищете. Обычная учетная запись может указывать 1 домен для каждой команды, оптовая и супероптовая учетная запись может указывать до 100 доменов
language0 - language99 (необязательно)Метка языка для соответствующего домена, используется только для IDN
show_price (необязательно)Если вы хотите показать цену в валюте вашего аккаунта, установите значение «1».
currency (необязательно)Вы можете решить, в какой валюте отображать данные аукциона, этот параметр поддерживает значения «USD», «CNY», «GBP», «EUR», «INR», «CAD» и так далее. Если вы пропустили этот параметр, мы будем использовать валюту учетной записи по умолчанию
XML-тег результатаПояснение
XML-тег результата
Пояснение
<Results></Results>Корневой узел XML-запроса команды поиска
<SearchResponse></SearchResponse>Тег ответа поиска
<SearchHeader></SearchHeader>Тег заголовка поиска
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<DomainName></DomainName>Доменное имя, которое вы искали
<Available></Available>Доступно ли доменное имя
<Price></Price>Если вы установите для «show_price» значение «1», вам будет предоставлена информация о цене (если домен доступен).
<Language></Language>Информация о языке для доменного имени
Пример поиска
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
Response (XML format)
<Results>
<SearchResponse>
<SearchHeader>
<SuccessCode>0</SuccessCode>
<DomainName>mydomain.com</DomainName>
<Available>yes</Available>
<Price>77.00 in USD</Price>
</SearchHeader>
</SearchResponse>
<SearchResponse>
<SearchHeader>
<SuccessCode>0</SuccessCode>
<DomainName>mydomain.net</DomainName>
<Available>yes</Available>
<Price>44.00 in USD</Price>
</SearchHeader>
</SearchResponse>
</Results>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
Response (JSON format)
{
"SearchResponse":{
"ResponseCode":"0",
"SearchResults":[
{
"DomainName":"mydomain.com",
"Available":"yes",
"Price":"77.00 in USD"
},
{
"DomainName":"mydomain.net",
"Available":"yes",
"Price":"44.00 in USD"
}
]
}
}
Команда регистрации register
Вызов команды register создаст и обработает заявку на регистрацию. У вас должно быть достаточно средств на счету учетной записи, чтобы оплатить заказ. При вызове команды register должны быть включены следующие параметры:
Параметр запроса на регистрациюПояснение
Параметр запроса на регистрацию
Пояснение
domainДоменное имя, которое вы хотите зарегистрировать, максимум 1 за запрос.
language (необязательно)Метка языка для запрашиваемого домена, нужна только для доменов IDN
durationНа какой срок зарегистрировать домен
registrant_contact (необязательно)The registrant contact you want to use on the domain
admin_contact (необязательно)The admin contact you want to use on the domain
technical_contact (необязательно)The technical contact you want to use on the domain
billing_contact (необязательно)The billing contact you want to use on the domain
option0 (при необходимости)
Имя регистранта .AT, .BE,
option1 (при необходимости)The .AT, .BE, registrant organization (optional)
Для .AT можно указать option0, option1, или и то, и другое
premium (необязательно)Если вы хотите зарегистрировать премиум-домен, установите для этого параметра значение «1» (необязательно)
currency (необязательно)Вы можете решить, в какой валюте отображать данные аукциона, этот параметр поддерживает значения «USD», «CNY», «GBP», «EUR», «INR», «CAD» и так далее. Если вы пропустили этот параметр, мы будем использовать валюту учетной записи по умолчанию
coupon (необязательно)Код купона, который вы хотите применить к этой команде.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<RegisterResponse></RegisterResponse>Тег ответа регистрации
<RegisterHeader></RegisterHeader>Тег заголовка регистрации
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<RegisterContent></RegisterContent>Тег содержимого регистрации
<Expiration></Expiration>Дата истечения в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года), используется только при результате "success"
<Registration></Registration>Дата регистрации в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года), используется только при результате "success"
Пример регистрации
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=register&domain=domain1.net&duration=3¤cy=USD
Response (XML format)
<RegisterResponse>
<RegisterHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RegisterHeader>
<RegisterContent>
<Expiration>1458379145266</Expiration>
</RegisterContent>
</RegisterResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=register&domain=domain1.net&duration=3¤cy=USD
Response (JSON format)
{
"RegisterResponse":{
"ResponseCode":"0",
"Status":"success",
"DomainName":"domain1.net",
"Expiration":"1458379145266"
}
}
Команда удаления delete
Вызов команды delete удаляет домен, для которого не истек льготный период. На ваш счет будет зачислена полная стоимость регистрации. Домены, которые были продлены или перенесены в другую учетную запись, нельзя удалить с помощью API. При вызове команды delete необходимо указать следующие параметры:
Параметр запроса на удалениеПояснение
Параметр запроса на удаление
Пояснение
domainДоменное имя, которое вы хотите удалить, количество доменов, которое можно удалить за один запрос: 1
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DeleteResponse></DeleteResponse>Тег ответа удаления
<DeleteHeader></DeleteHeader>Тег заголовка удаления
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример удаления
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=delete&domain=domain1.com
Response (XML format)
<DeleteResponse>
<DeleteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteHeader>
</DeleteResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=delete&domain=domain1.com
Response (JSON format)
{
"DeleteResponse":{
"ResponseCode":"0",
"Status":"success",
"DomainName":"domain1.com",
}
}
Команда продления renew
Вызов команды renew создает и выполняет заказ на продление. На счету учетной записи должно быть достаточно средств для оплаты заказа. При вызове команды renew необходимо указать следующие параметры:
Параметр запроса на продлениеПояснение
Параметр запроса на продление
Пояснение
domainДомен, который вы хотите продлить, только 1 домен может быть продлен за один запрос
durationНа сколько лет вы хотите продлить домен
year (необязательно)Текущий год окончания регистрации домена
currency (необязательно)Вы можете решить, в какой валюте отображать данные аукциона, этот параметр поддерживает значения «USD», «CNY», «GBP», «EUR», «INR», «CAD» и так далее. Если вы пропустили этот параметр, мы будем использовать валюту учетной записи по умолчанию
price_check (необязательно)Вы можете добавить данный параметр в команду, чтобы проверить информацию о цене на продление этого домена. ПРИМЕЧАНИЕ. Если вы добавите этот параметр в команду, наш API не будет обновлять домен, а только отобразит информацию о цене.
coupon (необязательно)Код купона, который вы хотите применить к этой команде.
no_renew_if_late_renew_fee_needed (необязательно)You can add this parameter to the command to avoid the renewal if the domain requires late renewal fee. If domain does requires late renew fee to renew, and "no_renew_if_late_renew_fee_needed = 1" was passed in command, domain will not be renewed.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<RenewResponse></RenewResponse>Тег ответа продления, это корневой узел XML-документа ответа
<RenewHeader></RenewHeader>Заголовок продления
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<PriceInfo></PriceInfo>Тег информации о цене, используется только при статусе "price_check_success"
<RenewContent></RenewContent>Тег содержимого продления, используется только при статусе "success"
<Expiration></Expiration>Дата истечения в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года), используется только при результате "success"
Пример продления
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
Response (XML format)
<RenewResponse>
<RenewHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RenewHeader>
<RenewContent>
<Expiration>73984579834</Expiration>
</RenewContent>
</RenewResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
Response (JSON format)
{
"RenewResponse":{
"ResponseCode":"0",
"Status":"success",
"DomainName":"domian1.com",
"Expiration":"73984579834"
}
}
Push Command
Вызов команды push создаст и обработает заказ на передачу домена. Вы должны разблокировать свой домен и учетную запись для заказа. Аккаунт получателя должен отклонить/принять домен для выполнения заказа. При вызове команды push должны быть включены следующие параметры:
Параметр запроса на передачуПояснение
Параметр запроса на передачу
Пояснение
domainДоменное имя, которое вы хотите передать. Мы также поддерживаем массовую передачу (push), вы можете использовать ";" для разделения доменов. Пример: domain1.com;domain2.com
receiver_push_usernamePush Username of receiver account
currency (необязательно)Вы можете решить, в какой валюте отображать данные аукциона, этот параметр поддерживает значения «USD», «CNY», «GBP», «EUR», «INR», «CAD» и так далее. Если вы пропустили этот параметр, мы будем использовать валюту учетной записи по умолчанию
unlock_domain_for_push(optional)Установите для этого параметра значение «1». Если домен заблокирован, мы автоматически разблокируем его, поэтому вам не нужно вручную разблокировать его
XML-тег результатаПояснение
XML-тег результата
Пояснение
<PushResponse></PushResponse>Тег ответа операции push, это корневой узел XML-документа ответа
<PushHeader></PushHeader>Заголовок передачи
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример передачи (push)
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
Response (XML format)
<PushResponse>
<PushHeader>
<SuccessCode>0</SuccessCode>
<Status>order created</Status>
</PushHeader>
</PushResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
Response (JSON format)
{
"PushResponse":{
"ResponseCode":"0",
"Status":"order created"
}
}
Transfer Command
Вызов команды переноса создает и выполняет заказ на перенос. Некоторые TLD могут потребовать от отдающего регистратора подтверждения для выполнения заказа. При вызове команды переноса, необходимо указать следующие параметры:
Параметр запроса на переносПояснение
Параметр запроса на перенос
Пояснение
domainДоменное имя, которое вы хотите перенести в Dynadot, за запрос может быть перенесен только 1 домен
authКод авторизации для запроса на перенос.
currency (необязательно)Вы можете решить, в какой валюте отображать данные аукциона, этот параметр поддерживает значения «USD», «CNY», «GBP», «EUR», «INR», «CAD» и так далее. Если вы пропустили этот параметр, мы будем использовать валюту учетной записи по умолчанию
registrant_contact (необязательно)The registrant contact that you want to use when transfer completed. (Not all tld supports this feature)
admin_contact (необязательно)The admin contact that you want to use when transfer completed. (Not all tld supports this feature)
technical_contact (необязательно)The technical contact that you want to use when transfer completed. (Not all tld supports this feature)
billing_contact (необязательно)The billing contact that you want to use when transfer completed. (Not all tld supports this feature)
coupon (необязательно)Код купона, который вы хотите применить к этой команде.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<TransferResponse></TransferResponse>Тег ответа операции переноса, это корневой узел XML-документа ответа
<TransferHeader></TransferHeader>Заголовок переноса
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример переноса
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
Response (XML format)
<TransferResponse>
<TransferHeader>
<SuccessCode>0</SuccessCode>
<Status>order created</Status>
</TransferHeader>
</TransferResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
Response (JSON format)
{
"TransferResponse":{
"ResponseCode":"0",
"Status":"order created",
"DomainName":"domian1.com"
}
}
Bulk Register Command
Calling the bulk register command will create and process registration orders. You must have enough account balance to pay for the orders. If calling the bulk register command, the following parameters should be included:
Bulk Register Request ParameterПояснение
Bulk Register Request Parameter
Пояснение
domain0-domain99The domain name(s) you want to register, maximum 100 domains can be registered per request
premium (необязательно)Если вы хотите зарегистрировать премиум-домен, установите для этого параметра значение «1» (необязательно)
currency (необязательно)You can decide the currency type and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on. If you missed this parameter,we will use the account default currency
coupon (необязательно)Код купона, который вы хотите применить к этой команде.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<BulkRegisterResponse></BulkRegisterResponse>Tag of bulk register response
<BulkRegisterHeader></BulkRegisterHeader>Tag of bulk register header
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<BulkRegisterContent></BulkRegisterContent>The tag of bulk register content
<Expiration></Expiration>Дата истечения в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года), используется только при результате "success"
<Result></Result>The result of the register action
<Message></Message>Error message of register action, only used when result is "error"
Bulk Register Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
<BulkRegisterHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BulkRegisterHeader>
<BulkRegisterContent>
<BulkRegister>
<RegisterResult>
<DomainName>domain0.com</DomainName>
<Expiration>1234567890</Expiration>
<Result>success</Result>
<Message>-</Message>
</RegisterResult>
<RegisterResult>
<DomainName>domain1.com</DomainName>
<Expiration>-</Expiration>
<Result>error</Result>
<Message>not_available</Message>
</RegisterResult>
</BulkRegister>
</BulkRegisterContent>
</BulkRegisterResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
Response (JSON format)
{
"BulkRegisterResponse": {
"ResponseCode": 0,
"Status": "success",
"BulkRegister": [
{
"DomainName": "domain0.com",
"Expiration": "1234567890",
"Result": "success",
"Message": "-"
},
{
"DomainName": "domain1.com",
"Expiration": "-",
"Result": "error",
"Message": "not_available"
}
]
}
}
Команда получения информации о домене
This command is only available in XML and JSON format:
Параметр запроса информации о доменеПояснение
Параметр запроса информации о домене
Пояснение
domainМаксимальное количество доменов в одном запросе: 1
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DomainInfoResponse></DomainInfoResponse>Корневой узел XML-документа ответа
<DomainInfoResponseHeader></DomainInfoResponseHeader>Заголовок ответа
<ResponseCode></ResponseCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<DomainInfoContent></DomainInfoContent>Содержимое ответа
<Domain></Domain>Домен
<Name></Name>Доменное имя
<Expiration></Expiration>Дата истечения регистрации домена в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
<Registration></Registration>Дата регистрации домена по времени Unix (миллисекунды с полуночи по UTC января 1, 1970)
<NameServerSettings></NameServerSettings>Настройки сервера доменного имени
<Type></Type>Тип сервера доменного имени
<WithAds></WithAds>Если вам нужна парковочная страница для домена
<Whois></Whois>Информация Whois
<Registrant></Registrant>Информация о регистраторе
<ContactId></ContactId>Идентификатор контакта
<Admin></Admin>Информация об администраторе
<Technical></Technical>Техническая информация
<Billing></Billing>Информация о счетах (биллинг)
<Locked></Locked>Заблокирован или нет
<Disabled></Disabled>Статус "включено/выключено"
<UdrpLocked></UdrpLocked>Установлена ли блокировка UDRP
<UdrpLocked></UdrpLocked>Установлена ли блокировка UDRP
<RegistrantUnverified></RegistrantUnverified>Непроверенное регистрирующее лицо
<Hold></Hold>Удержание
<Privacy></Privacy>Статус скрытия личных данных
<isForSale></isForSale>Статус "для продажи"
<RenewOption></RenewOption>Настройка продления
<Note></Note>Заметки
<Folder></Folder>Информация о папке
<FolderId></FolderId>Идентификатор папки
<FolderName></FolderName>Название папки
Пример получения информации о домене
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=domain_info&domain=domain1.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DomainInfoResponse>
<DomainInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</DomainInfoHeader>
<DomainInfoContent>
<Domain>
<Name>domain1.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>0</ContactId>
</Registrant>
<Admin>
<ContactId>0</ContactId>
</Admin>
<Technical>
<ContactId>0</ContactId>
</Technical>
<Billing>
<ContactId>0</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>yes</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
</Domain>
</DomainInfoContent>
</DomainInfoResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=domain_info&domain=domain1.com
Response (JSON format)
{
"DomainInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainInfo": {
"Name": "domain1.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "0"
},
"Admin": {
"ContactId": "0"
},
"Technical": {
"ContactId": "0"
},
"Billing": {
"ContactId": "0"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "yes",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
}
}
}
}
Команда установки данных Whois
При вызове команды установки данных Whois должны быть указаны следующие параметры:
Параметр запроса установки данных WhoisПояснение
Параметр запроса установки данных Whois
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
registrant_contactИнформация регистрирующего лица
admin_contactИнформация об администраторе домена
technical_contactТехническая информация о домене
billing_contactБиллинговая информация домена
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetWhoisResponse></SetWhoisResponse>Корневой узел XML-документа ответа
<SetWhoisHeader></SetWhoisHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки данных Whois
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (XML format)
<SetWhoisResponse>
<SetWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetWhoisHeader>
</SetWhoisResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format)
{
"SetWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки серверов имен
При вызове команды установки серверов имен должны быть указаны следующие параметры:
Параметр запроса установки серверов именПояснение
Параметр запроса установки серверов имен
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
ns0 - ns12Сервера имен, которые вы хотите установить для домена. Максимальное количество серверов имен, которое можно указать: 13, но они должны быть предварительно внесены в вашу учетную запись.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetNsResponse></SetNsResponse>Тег ответа установленного сервера имен, это корневой узел XML-документа ответа
<SetNsHeader></SetNsHeader>Тег заголовка ответа установленного сервера имен
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки сервера имен
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Response (XML format)
<SetNsResponse>
<SetNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNsHeader>
</SetNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Response (JSON format)
{
"SetNsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки парковки
При вызове команды установки парковки должны быть указаны следующие параметры:
Параметр запроса установки парковкиПояснение
Параметр запроса установки парковки
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
with_ads (необязательно)Если вы не хотите рекламы от сторонних поставщиков, укажите в этом параметре "no"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetParkingResponse></SetParkingResponse>Тег ответа установки парковки, это корневой узел XML-документа ответа
<SetParkingHeader></SetParkingHeader>Тег заголовка ответа установки парковки
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки парковки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_parking&domain=domain1.com&with_ads=no
Response (XML format)
<SetParkingResponse>
<SetParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetParkingHeader>
</SetParkingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_parking&domain=domain1.com&with_ads=no
Response (JSON format)
{
"SetParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки перенаправления
При вызове команды установки перенаправления должны быть указаны следующие параметры:
Параметр запроса установки перенаправленияПояснение
Параметр запроса установки перенаправления
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
forward_urlURL-адрес, на который вы хотите перенаправить ваш домен. Обратите внимание, что параметр должен быть закодирован, чтобы вызов API интерпретировался правильно. is_temp (необязательно)Статус перенаправления для домена, по умолчанию (временный) "temporary", если вы хотите установить постоянное перенаправление, укажите в этом параметре "no"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetForwardingResponse></SetForwardingResponse>Корневой узел XML-документа ответа
<SetForwardingHeader></SetForwardingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки перенаправления
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_forwarding&forward_url=http%3A%2F%2Fwww.mydomain.com&domain=domain1.com,domain2.com
Response (XML format)
<SetForwardingResponse>
<SetForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetForwardingHeader>
</SetForwardingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_forwarding&forward_url=http%3A%2F%2Fwww.mydomain.com&domain=domain1.com,domain2.com
Response (JSON format)
{
"SetForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Установка скрытого перенаправления (stealth)
При вызове команды установки скрытого перенаправления должны быть указаны следующие параметры:
Параметр запроса установки скрытого перенаправленияПояснение
Параметр запроса установки скрытого перенаправления
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
stealth_urlURL-адрес, на который вы хотите перенаправить ваш домен. Обратите внимание, что параметр должен быть закодирован, чтобы вызов API интерпретировался правильно. stealth_title (необязательно)Заголовок страницы
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetStealthResponse></SetStealthResponse>Корневой узел XML-документа ответа
<SetStealthHeader></SetStealthHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки скрытого перенаправления
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com
Response (XML format)
<SetStealthResponse>
<SetStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetStealthHeader>
</SetStealthResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com
Response (JSON format)
{
"SetStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки хостинга
При вызове команды установки хостинга должны быть указаны следующие параметры:
Параметр запроса установки хостингаПояснение
Параметр запроса установки хостинга
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
hosting_typeТип желаемого хостинга, можно выбрать "advanced" или "basic"
mobile_view_onЕсли в hosting_type выбрано "advanced",, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetHostingResponse></SetHostingResponse>Корневой узел XML-документа ответа
<SetHostingHeader></SetHostingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки хостинга
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Response (XML format)
<SetHostingResponse>
<SetHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetHostingHeader>
</SetHostingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Response (JSON format)
{
"SetHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки DNS
При вызове команды установки DNS должны быть указаны следующие параметры:
(Эта команда устарела, вместо нее рекомендуется использовать команду Set DNS2)
Параметр запроса установки DNSПояснение
Параметр запроса установки DNS
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
main_record_typeТип главной записи
main_recordУкажите запись DNS для вашего домена
main_txt1 - main_txt4 (необязательно)Укажите записи TXT для вашего домена. Если основной тип записи (main_record_type) AAAA, и указана основная запись 2 (main_record2), вы можете настроить до 3 основных текстовых (main_txt) записей, в других случаях — до 4.
main_record2Основная запись 2, используется только когда "main_record_type" имеет значение "aaaa". Ее значение должно быть в формате IPv4.
subdomain0 - subdomain99 (необязательно)Subdomain records (необязательно)
sub_record_type0 - sub_record_type99 (необязательно)Тип записей поддомена
sub_record0 - sub_record99 (необязательно)Целевой IP-адрес или URL
mx_host0 - mx_host4 (необязательно)Укажите адрес почтового узла для домена, distance0 — высший приоритет
mx_distance0 - mx_distance4 (необязательно)Distance0 — высший приоритет
ttl (необязательно)Время жизни (time to live)
add_dns_to_current_setting (необязательно)if you want to append the new DNS settings to existing Dns settings. Set it equal to "1" (optional)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDnsResponse></SetDnsResponse>Корневой узел XML-документа ответа
<SetDnsHeader></SetDnsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки DNS
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_dns&domain=domain1.com&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
<SetDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDnsHeader>
</SetDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_dns&domain=domain1.com&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format)
{
"SetDnsResponse": {
"ResponseCode": "0",
"Status": "success"
}
}
Команда Set DNS2
При вызове команды set DNS2 необходимо указать следующие параметры:
Обратите внимание, что вызов команды set DNS2 переопределит текущий параметр DNS.
Параметры запроса Set DNS2Пояснение
Параметры запроса Set DNS2
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
main_record_type0 - main_record_type19Тип основной записи должен быть «a», «aaaa», «cname», «forward», «txt», «srv», «mx», «stealth», «email»
main_record0 - main_record19Укажите запись DNS для вашего домена
main_recordx0 - main_recordx19Приоритет MX, тип переадресации («1» для 301, «2» для 302), заголовок скрытого перенаправления или псевдоним эл. почты, необходимые для main_record_type типа «forward», «mx», «stealth», «email».
subdomain0 - subdomain99 (необязательно)Subdomain records (необязательно)
sub_record_type0 - sub_record_type99Тип записи поддомена должен быть «a», «aaaa», «cname», «forward», «txt», «srv», «mx», «stealth», «email»
sub_record0 - sub_record99IP-адрес или узел назначения поддомена
sub_recordx0 - sub_recordx99Приоритет MX, тип переадресации, заголовок скрытого перенаправления или псевдоним эл. почты, необходимые для main_record_type типа «forward», «mx», «stealth», «email»
ttl (необязательно)Время жизни (time to live)
add_dns_to_current_setting (необязательно)if you want to append the new DNS settings to existing Dns settings. Set it equal to "1" (optional)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDnsResponse></SetDnsResponse>Корневой узел XML-документа ответа
<SetDnsHeader></SetDnsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример использования команды Set DNS2
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
<SetDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDnsHeader>
</SetDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Response (JSON format)
{
"SetDnsResponse": {
"ResponseCode": "0",
"Status": "success"
}
}
Команда установки перенаправления Email
При вызове команды установки перенаправления Email должны быть указаны следующие параметры:
Параметр запроса установки перенаправления EmailПояснение
Параметр запроса установки перенаправления Email
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
forward_typeТип перенаправления, варианты: "donot": не перенаправлять, "mx": направлять электронную почту на другой почтовый узел (запись MX), "forward": направлять электронную почту на другой почтовый узел
username0 - username9Имя пользователя, используется только, если в "forward_type" указано "forward"
exist_email0 - exist_email9Существующий адрес электронной почты, используется только, когда в "forward_type" указано "forward"
mx_host0 - mx_host2Почтовый узел, используется только, когда в "forward_type" указано "mx"
mx_distance0 - mx_distance2Distance0 — высший приоритет, используется только, когда в "forward_type" указано "mx"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetEmailForwardingResponse></SetEmailForwardingResponse>Корневой узел XML-документа ответа
<SetEmailForwardingHeader></SetEmailForwardingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки перенаправления Email
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_email_forward&domain=domain1.com&forward_type=forward&username0=peter&[email protected]
Response (XML format)
<SetEmailForwardingResponse>
<SetEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetEmailForwardingHeader>
</SetEmailForwardingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_email_forward&domain=domain1.com&forward_type=forward&username0=peter&[email protected]
Response (JSON format)
{
"SetEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда сброса параметра для домена
При вызове команды сброса значения для домена должны быть указаны следующие параметры:
Параметр запроса сброса значения для доменаПояснение
Параметр запроса сброса значения для домена
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
serviceСлужба, которую вы хотите стереть, может быть «forward», «stealth», «email_forwarding», «dns» и «nameservers»
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>Корневой узел XML-документа ответа
<SetClearDomainSettingHeader></SetClearDomainSettingHeaderr>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример сброса значения для домена
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Response (XML format)
<SetClearDomainSettingResponse>
<SetClearDomainSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearDomainSettingHeader>
</SetClearDomainSettingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Response (JSON format)
{
"SetClearDomainSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки папки
При вызове команды установки папки должны быть указаны следующие параметры:
Параметр запроса установки папкиПояснение
Параметр запроса установки папки
Пояснение
domainДомен, параметры которого вы хотите обновить, за один запрос может быть обновлена информация только для 1 сервера.
folderНазвание папки, в которую вы хотите переместить ваш домен. Укажите "Default" в качестве названия папки, если хотите переместить домен в папку по умолчанию. Название папки чувствительно к регистру. Например "Folder1" и "folder1" — две разных папки.
folder_id (необязательно)Идентификатор папки, в которую вы хотите переместить ваш домен
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderResponse></SetFolderResponse>Тег ответа операции установки папки, это корневой узел XML-документа ответа
<SetFolderHeader></SetFolderHeader>Заголовок установки бесплатного хостинга
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder&domain=domian1.com&folder=folder1
Response (XML format)
<SetFolderResponse>
<SetFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHeader>
</SetFolderResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder&domain=domian1.com&folder=folder1
Response (JSON format)
{
"SetFolderResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Установка параметра продления
При вызове команды установки продления должны быть указаны следующие параметры:
Параметр запроса установки продленияПояснение
Параметр запроса установки продления
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
renew_optionМожет быть указано "donot", "auto", "reset"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetRenewOptionResponse></SetRenewOptionResponse>Корневой узел XML-документа ответа
<SetRenewOptionHeader></SetRenewOptionHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки продления
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_renew_option&domain=domain1.com&renew_option=auto
Response (XML format)
<SetRenewOptionResponse>
<SetRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetRenewOptionHeader>
</SetRenewOptionResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_renew_option&domain=domain1.com&renew_option=auto
Response (JSON format)
{
"SetRenewOptionResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки заметки
При вызове команды установки заметки должны быть указаны следующие параметры:
Параметр запроса установки заметкиПояснение
Параметр запроса установки заметки
Пояснение
domainДомен, для которого вы хотите установить заметку, только 1 домен может быть установлен за один запрос
noteЗаметка, которую вы хотите установить для домена, может иметь значение null
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetNoteResponse></SetNoteResponse>Корневой узел XML-документа ответа
<SetNoteHeader></SetNoteHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки заметки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_note&domain=domain1.com¬e=Do not modify any information
Response (XML format)
<SetNoteResponse>
<SetNoteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNoteHeader>
</SetNoteResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_note&domain=domain1.com¬e=Do not modify any information
Response (JSON format)
{
"SetNoteResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Set Customer Id Command (RESELLER ONLY)
If calling set customer id command, the following parameters should be included:
Set Customer Id Request ParameterПояснение
Set Customer Id Request Parameter
Пояснение
domainThe domain you want to set, multiple domains are separated by commas (Max:100)
customer_idCustomer id you want to set to the domain, can't be null
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetCustomerIdResponse></SetCustomerIdResponse>Корневой узел XML-документа ответа
<SetCustomerIdHeader></SetCustomerIdHeader>Заголовок ответа
<SetCustomerIdContent></SetCustomerIdContent>Содержимое ответа
<SetCustomerIdSuccess></SetCustomerIdSuccess>Set customer id success response content
<SetCustomerIdFailed></SetCustomerIdFailed>Set customer id failed response content
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure, "1" for problem
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Set Customer Id Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456
Response (XML format)
<SetCustomerIdResponse>
<SetCustomerIdHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetCustomerIdHeader>
<SetCustomerIdContent>
<SetCustomerIdSuccess>
<content>
<Domain>domain1.com</Domain>
<CustomerId>123456</CustomerId>
</content>
<content>
<Domain>domain2.com</Domain>
<CustomerId>123456</CustomerId>
</content>
</SetCustomerIdSuccess>
</SetCustomerIdContent>
</SetCustomerIdResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456
Response (JSON format)
{
"SetCustomerIdResponse": {
"ResponseCode": 0,
"Status": "success",
"SetCustomerIdSuccess": [
{
"Domain": "domain1.com",
"CustomerId": 123456
},
{
"Domain": "domain2.com",
"CustomerId": 123456
}
]
}
}
Команда установки скрытия данных
При вызове команды установки скрытия данных должны быть указаны следующие параметры:
Параметр запроса установки скрытия данныхПояснение
Параметр запроса установки скрытия данных
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
optionСтатус скрытия данных, который вы хотите установить для домена, может быть "full", "partial", или "off"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetPrivacyResponse></SetPrivacyResponse>Корневой узел XML-документа ответа
<SetPrivacyHeader></SetPrivacyHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки скрытия данных
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_privacy&domain=domain1.com&option=off
Response (XML format)
<SetPrivacyResponse>
<SetPrivacyHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetPrivacyHeader>
</SetPrivacyResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_privacy&domain=domain1.com&option=off
Response (JSON format)
{
"SetPrivacyResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Цены на TLD
This feature is only available in XML and JSON format:
Параметр запроса цен TldПояснение
Параметр запроса цен Tld
Пояснение
currency (необязательно)Валюта возвращаемого результата, должна быть "usd", "eur", или "cny", валюта по умолчанию - это валюта по умолчанию для Api в настройках учетной записи.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<TldPriceResponse></TldPriceResponse>Корневой узел XML-документа ответа
<TldPriceResponseHeader></TldPriceResponseHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<TldPriceContent></TldPriceContent>Содержимое ответа
<TldContent></TldContent>Информация о Tld
<Tld></Tld>Домены верхнего уровня
<Usage></Usage>Использование tld
<Price></Price>Price info of this tld. Contain sub-tags:
: Unit of price
: Price of Registration
: Price of Renew
: Price of Transfer
<Privacy></Privacy>Если этот TLD поддерживает конфиденциальность whois
<GracePeriod></GracePeriod>Grace period info of this tld. Contain sub-tags:
: Unit of grace period info
: Renew grace period
: Delete grace period
<IDN></IDN>Если этот tld поддерживает интернационализированные доменные имена
<Restrictions></Restrictions>Доменное имя
Пример запроса цен на TLD
Request (XML format)
https://api.dynadot.com/api3.xml?key=0&command=tld_price¤cy=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
<TldPriceResponseHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<PriceLevel>Regular Pricing</PriceLevel>
<Currency>USD</Currency>
</TldPriceResponseHeader>
<TldPriceContent>
<TldContent>
<Tld>.com</Tld>
<Usage>Usage</Usage>
<Price>
<Unit>(Price/1 year)</Unit>
<Register>99.00</Register>
<Renew>60.00</Renew>
<Transfer>92.00</Transfer>
</Price>
<Privacy>Yes</Privacy>
<GracePeriod>
<Unit>(Grace Period/days)</Unit>
<Renew>40</Renew>
<Delete>5</Delete>
</GracePeriod>
<IDN>Yes</IDN>
<Restrictions>--</Restrictions>
</TldContent>
</TldPriceContent>
</TldPriceResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=0&command=tld_price¤cy=USD
Response (JSON format)
{
"TldPriceResponse": {
"ResponseCode": 0,
"Status": "success",
"PriceLevel": "Regular Pricing",
"Currency": "USD",
"TldPrice": [
{
"Tld": ".com",
"Usage": "Usage",
"Price": {
"Unit": "(Price/1 year)",
"Register": "99.00",
"Renew": "60.00",
"Transfer": "92.00"
},
"Privacy": "Yes",
"GracePeriod": {
"Unit": "(Grace Period/days)",
"Renew": "40",
"Delete": "5"
},
"IDN": "Yes",
"Restrictions": "--"
}
]
}
}
Команда списка доменов
This feature is only available in XML and JSON format:
Параметр запроса списка доменовПояснение
Параметр запроса списка доменов
Пояснение
customer_id (необязательно)Filter data by customer id (only resellers can use this parameter)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<ListDomainInfoResponse></ListDomainInfoResponse>Корневой узел XML-документа ответа
<ListDomainInfoHeader></ListDomainInfoHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<ListDomainInfoContent></ListDomainInfoContent>Содержимое ответа
<DomainInfoList></DomainInfoList>Список информации о доменах
<DomainInfo></DomainInfo>Информация о домене
<Domain></Domain>Домен
<Name></Name>Доменное имя
<Expiration></Expiration>Дата истечения регистрации домена в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
<Registration></Registration>Дата регистрации домена по времени Unix (миллисекунды с полуночи по UTC января 1, 1970)
<NameServerSettings></NameServerSettings>Значение сервера имен
<Type></Type>Тип значения сервера имен
<WithAds></WithAds>С рекламой или без нее
<Whois></Whois>Информация Whois
<Registrant></Registrant>Информация о регистраторе
<ContactId></ContactId>Идентификатор контакта
<Admin></Admin>Информация об администраторе
<Technical></Technical>Техническая информация
<Billing></Billing>Информация о счетах (биллинг)
<Locked></Locked>Заблокирован или нет
<Disabled></Disabled>Статус "включено/выключено"
<Hold></Hold>Удержание
<Privacy></Privacy>Статус скрытия личных данных
<isForSale></isForSale>Статус "для продажи"
<RenewOption></RenewOption>Настройка продления
<Note></Note>Заметки
<Folder></Folder>Информация о папке
<FolderId></FolderId>Идентификатор папки
<FolderName></FolderName>Название папки
Пример получения списка доменов
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=list_domain
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ListDomainInfoResponse>
<ListDomainInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ListDomainInfoHeader>
<ListDomainInfoContent>
<DomainInfoList>
<DomainInfo>
<Domain>
<Name>domain-exp140.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>0</ContactId>
</Registrant>
<Admin>
<ContactId>0</ContactId>
</Admin>
<Technical>
<ContactId>0</ContactId>
</Technical>
<Billing>
<ContactId>0</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>no</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
</Domain>
<Domain>
<Name>domain-exp141.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>1</ContactId>
</Registrant>
<Admin>
<ContactId>2</ContactId>
</Admin>
<Technical>
<ContactId>3</ContactId>
</Technical>
<Billing>
<ContactId>4</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>no</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
</Domain>
</DomainInfo>
</DomainInfoList>
</ListDomainInfoContent>
</ListDomainInfoResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=list_domain
Response (JSON format)
{
"ListDomainInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"MainDomains": [
{
"Name": "domain-exp140.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "0"
},
"Admin": {
"ContactId": "0"
},
"Technical": {
"ContactId": "0"
},
"Billing": {
"ContactId": "0"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "no",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
}
},
{
"Name": "domain-exp141.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "1"
},
"Admin": {
"ContactId": "2"
},
"Technical": {
"ContactId": "3"
},
"Billing": {
"ContactId": "4"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "no",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
}
}
]
}
}
Команда создания контакта
При вызове команды создания контакта должны быть указаны следующие параметры:
Параметр запроса создания контактаПояснение
Параметр запроса создания контакта
Пояснение
organization (необязательно)Информация об организации
nameИмя
emailПочта
phonenumНомер телефона
phoneccТелефонный код страны
faxnum (необязательно)Номер факса
faxcc (необязательно)Код страны для факса
address1Адрес1
address2 (необязательно)Адрес 2
cityГород
state (необязательно)Регион
zipПочтовый индекс
countryСтрана
XML-тег результатаПояснение
XML-тег результата
Пояснение
<CreateContactResponse></CreateContactResponse>Корневой узел XML-документа ответа
<CreateContactHeader></CreateContactHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<CreateContactContent></CreateContactContent>New Contact ID, only used when status is "success"
Пример создания контакта
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Response (XML format)
<CreateContactResponse>
<CreateContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CreateContactHeader>
<CreateContactContent>
<ContactId>1234</ContactId>
</CreateContactContent>
</CreateContactResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Response (JSON format)
{
"CreateContactResponse":{
"ResponseCode":"0",
"Status":"success",
"CreateContactContent":{
"ContactId":"0"
}
}
}
Команда редактирования контакта
При вызове команды редактирования контакта должны быть указаны следующие параметры:
Параметр запроса редактирования контактаПояснение
Параметр запроса редактирования контакта
Пояснение
contact_idИдентификатор контакта, который вы хотите редактировать
organization (необязательно)Информация об организации
nameИмя
emailПочта
phonenumНомер телефона
phoneccТелефонный код страны
faxnum (необязательно)Номер факса
faxcc (необязательно)Код страны для факса
address1Адрес 1
address2 (необязательно)Адрес 2
cityГород
stateРегион
zipПочтовый индекс
countryСтрана
XML-тег результатаПояснение
XML-тег результата
Пояснение
<EditContactResponse></EditContactResponse>Корневой узел XML-документа ответа
<EditContactHeader></EditContactHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<EditContactContent></EditContactContent>Содержимое ответа
<ContactId></ContactId>Идентификатор контакта
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<EditContactResponse>
<EditContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</EditContactHeader>
<EditContactContent>
<ContactId>0</ContactId>
</EditContactContent>
</EditContactResponse>
Request (CSV format)
https://api.dynadot.com/api3.html?key=mykey&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Response (CSV format)
ok,
success,
,
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Response (JSON format)
{
"EditContactResponse": {
"ResponseCode": "0",
"Status": "success",
"EditContactContent": {
"ContactId": "0"
}
}
}
Set Contact EU Setting Command
If calling set contact eu setting command, the following parameters should be included:
Set Contact EU Setting Request ParameterПояснение
Set Contact EU Setting Request Parameter
Пояснение
contact_idИдентификатор контакта, который вы хотите редактировать
country_of_citizenshipMust be an EU member state, The country codes of member states include :
AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetContactEUSettingResponse></SetContactEUSettingResponse>Корневой узел XML-документа ответа
<SetContactEUSettingHeader></SetContactEUSettingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<SetContactEUSettingContent></SetContactEUSettingContent>Содержимое ответа
<ContactId></ContactId>Идентификатор контакта
Set Contact EU Setting Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
<SetContactEUSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactEUSettingHeader>
<SetContactEUSettingContent>
<ContactId>0</ContactId>
</SetContactEUSettingContent>
</SetContactEUSettingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Response (JSON format)
{
"SetContactEUSettingResponse": {
"ResponseCode: ": "0",
"Status": "Success",
"SetContactEUSettingContent": {
"ContactId: ": "0"
}
}
}
Set Contact LV Setting Command
If calling set contact lv setting command, the following parameters should be included:
Set Contact LV Setting Request ParameterПояснение
Set Contact LV Setting Request Parameter
Пояснение
contact_idИдентификатор контакта, который вы хотите редактировать
registration_number- For individual, Please enter Latvian identification number.
- For companies and other legal entities, please enter registration number issued by the Latvian Register of Enterprises.
vat_number (необязательно)VAT number for foreign legal entities registered within European Union countries (this includes also Latvian companies)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetContactLvSettingResponse></SetContactLvSettingResponse>Корневой узел XML-документа ответа
<SetContactLvSettingHeader></SetContactLvSettingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<SetContactLvSettingContent></SetContactLvSettingContent>Содержимое ответа
<ContactId></ContactId>Идентификатор контакта
Set Contact LV Setting Example
Request (CSV format)
https://api.dynadot.com/api3.csv?key=mykey&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
Response (CSV format)
ok,success,0
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
<SetContactLvSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactLvSettingHeader>
<SetContactLvSettingContent>
<ContactId>0</ContactId>
</SetContactLvSettingContent>
</SetContactLvSettingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
Response (JSON format)
{
"SetContactLvSettingResponse": {
"ResponseCode": 0,
"Status": "success",
"SetContactLvSettingContent": {
"ContactId: ": "0"
}
}
}
Команда удаления контакта
При вызове команды удаления контакта должны быть указаны следующие параметры:
Параметр запроса удаления контактаПояснение
Параметр запроса удаления контакта
Пояснение
contact_idИдентификатор контакта, который вы хотите удалить, они должны разделяться запятыми
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DeleteContactResponse></DeleteContactResponse>Корневой узел XML-документа ответа
<DeleteContactHeader></DeleteContactHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример удаления контакта
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=delete_contact&contact_id=0
Response (XML format)
<DeleteContactResponse>
<DeleteContactHeader>
<SuccessCode>-1</SuccessCode>
<Status>error</Status>
<Error>cannot delete these contacts (Jack Slater). Because they are in use.</Error>
</DeleteContactHeader>
</DeleteContactResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=delete_contact&contact_id=0
Response (JSON format)
{
"DeleteContactResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда получения списка контактов
This command is only available in XML and JSON format:
Параметр запроса списка контактовПояснение
Параметр запроса списка контактов
Пояснение
N/AДополнительных параметров не требуется
XML-тег результатаПояснение
XML-тег результата
Пояснение
<ContactListResponse></ContactListResponse>Корневой узел XML-документа ответа
<ContactListHeader></ContactListHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<ContactListContent></ContactListContent>Содержимое ответа
<ContactList></ContactList>Список контактов
<Contact></Contact>Информация контакта
<ContactId></ContactId>Идентификатор контакта
<Organization></Organization>Организация контакта
<Name></Name>Имя
<Email></Email>Почта
<PhoneCc></PhoneCc>Телефонный код страны
<PhoneNum></PhoneNum>Номер телефона
<FaxCc></FaxCc>Код страны для факса
<FaxNum></FaxNum>Номер факса
<Address1></Address1>Адрес 1
<Address2></Address2>Адрес 2
<City></City>Город
<State></State>Регион
<ZipCode></ZipCode>Почтовый индекс
<Country></Country>Страна
<GtldVerified></GtldVerified>статус проверки gTLD
Пример получения списка контактов
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=contact_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
<ContactListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ContactListHeader>
<ContactListContent>
<ContactList>
<Contact>
<ContactId>0</ContactId>
<Organization/>
<Name>Jack Slater</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>1 Free Way</Address1>
<Address2/>
<City>Los Angeles</City>
<State>CA</State>
<ZipCode>90068</ZipCode>
<Country>US</Country>
<GtldVerified>no</GtldVerified>
</Contact>
<Contact>
<ContactId>1</ContactId>
<Organization/>
<Name>John tester</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>123.456.7890</PhoneNum>
<FaxCc>1</FaxCc>
<FaxNum>123.456.7890</FaxNum>
<Address1>high Way first</Address1>
<Address2/>
<City>San Francisco</City>
<State>CA</State>
<ZipCode>90068</ZipCode>
<Country>US</Country>
<GtldVerified>yes</GtldVerified>
</Contact>
</ContactList>
</ContactListContent>
</ContactListResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=contact_list
Response (JSON format)
{
"ContactListResponse": {
"ResponseCode": 0,
"Status": "success",
"ContactList": [
{
"ContactId": "0",
"Organization": "",
"Name": "Jack Slater",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "1 Free Way",
"Address2": "",
"City": "Los Angeles",
"State": "CA",
"ZipCode": "90068",
"Country": "US",
"GtldVerified": "no"
},
{
"ContactId": "1",
"Organization": "",
"Name": "John tester",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "123.456.7890",
"FaxCc": "1",
"FaxNum": "123.456.7890",
"Address1": "high Way first",
"Address2": "",
"City": "San Francisco",
"State": "CA",
"ZipCode": "90068",
"Country": "US",
"GtldVerified": "yes"
}
]
}
}
Команда получения контакта
This command is only available in XML and JSON format:
Параметр запроса получения контактаПояснение
Параметр запроса получения контакта
Пояснение
contact_idидентификатор контакта
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetContactResponse></GetContactResponse>Корневой узел XML-документа ответа
<GetContactHeader></GetContactHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetContactContent></GetContactContent>Содержимое ответа
<Contact></Contact>Информация контакта
<ContactId></ContactId>Идентификатор контакта
<Organization></Organization>Организация контакта
<Name></Name>Имя
<Email></Email>Почта
<PhoneCc></PhoneCc>Телефонный код страны
<PhoneNum></PhoneNum>Номер телефона
<FaxCc></FaxCc>Код страны для факса
<FaxNum></FaxNum>Номер факса
<Address1></Address1>Адрес 1
<Address2></Address2>Адрес 2
<City></City>Город
<State></State>Регион
<ZipCode></ZipCode>Почтовый индекс
<Country></Country>Страна
<GtldVerified></GtldVerified>статус проверки gTLD
Пример получения контакта
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_contact&contact_id=10000
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetContactResponse>
<GetContactHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetContactHeader>
<GetContactContent>
<GetContact>
<Contact>
<ContactId>12345</ContactId>
<Organization>org</Organization>
<Name>name</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>address1</Address1>
<Address2>address2</Address2>
<City>city</City>
<State>state</State>
<ZipCode>zipcode</ZipCode>
<Country>country</Country>
<GtldVerified>no</GtldVerified>
</Contact>
</GetContact>
</GetContactContent>
</GetContactResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_contact&contact_id=10000
Response (JSON format)
{
"GetContactResponse": {
"ResponseCode": 0,
"Status": "success",
"GetContact": {
"ContactId": "12345",
"Organization": "org",
"Name": "name",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "address1",
"Address2": "address2",
"City": "city",
"State": "state",
"ZipCode": "zipcode",
"Country": "country",
"GtldVerified": "no"
}
}
}
Get Name Server Command
If calling get name server command, the following parameters should be included:
Get Name Server Request ParameterПояснение
Get Name Server Request Parameter
Пояснение
domainДомен, для которого вы хотите получить информацию о серверах имен, за один запрос может быть получена информация только для 1 сервера.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetNsResponse></GetNsResponse>Корневой узел XML-документа ответа
<GetNsHeader></GetNsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<NsContent></NsContent>Содержимое ответа
<Host></Host>Host name of the server
<NsName></NsName>Name of the server
Get Name Server Example
Request (XML format)
https://api.dynadot.com/api3.html?key=mykey&command=get_ns&domain=mydomain.com
Response (XML format)
<GetNsResponse>
<GetNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetNsHeader>
<NsContent>
<Host>ns1.mydomain.com</Host>
<Host>ns2.mydomain.com</Host>
</NsContent>
</GetNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_ns&domain=mydomain.com
Response (JSON format)
{
"GetNsResponse":{
"ResponseCode":"0",
"Status":"success",
"NsContent":{
"Host":"ns1.mydomain.com",
"Host":"ns2.mydomain.com"
}
}
}
Команда добавления сервера имен
При вызове команды добавления сервера имен должны быть указаны следующие параметры:
Параметр запроса добавления сервера именПояснение
Параметр запроса добавления сервера имен
Пояснение
hostИмя узла сервера имен, который вы хотите добавить
XML-тег результатаПояснение
XML-тег результата
Пояснение
<AddNsResponse></AddNsResponse>Корневой узел XML-документа ответа
<AddNsHeader></AddNsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<AddNsContent></AddNsContent>Содержимое ответа
<Server></Server>Сервер, который вы установили
<Host></Host>Имя узла нового сервера
<ServerId></ServerId>Идентификатор нового сервера
Пример добавления сервера имен
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=add_ns&host=ns1.mydomain.com
Response (XML format)
<AddNsResponse>
<AddNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</AddNsHeader>
<AddNsContent>
<Server>
<Host>ns1.mydomain.com</Host>
<ServerId>0</ServerId>
</Server>
</AddNsContent>
</AddNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=add_ns&host=ns1.mydomain.com
Response (JSON format)
{
"AddNsResponse":{
"ResponseCode":"0",
"Status":"success",
"AddNsContent":{
"Server":{
"Host":"ns1.mydomain.com",
"ServerId":"0"
}
}
}
}
Команда регистрации сервера имен
При вызове команды регистрации сервера имен должны быть указаны следующие параметры:
Параметр запроса регистрации сервера именПояснение
Параметр запроса регистрации сервера имен
Пояснение
hostИмя узла вашего собственного сервера имен
ipIP-адрес вашего собственного сервера имен
XML-тег результатаПояснение
XML-тег результата
Пояснение
<RegisterNsResponse></RegisterNsResponse>Корневой узел XML-документа ответа
<RegisterNsHeader></RegisterNsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<RegisterNsContent></RegisterNsContent>Содержимое ответа
<Server></Server>Тег сервера
<Host></Host>Имя узла
<ServerId></ServerId>Идентификатор сервера
Пример регистрации сервера имен
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=register_ns&host=domain1.com&ip=192.168.1.1
Response (XML format)
<RegisterNsResponse>
<RegisterNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RegisterNsHeader>
<RegisterNsContent>
<Server>
<Host>domain1.com</Host>
<ServerId>0</ServerId>
</Server>
</RegisterNsContent>
</RegisterNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=register_ns&host=domain1.com&ip=192.168.1.1
Response (JSON format)
{
"RegisterNsResponse":{
"ResponseCode":"0",
"Status":"success",
"RegisterNsContent":{
"Server":{
"Host":"ndomain1.com",
"ServerId":"0"
}
}
}
}
Команда установки IP-адреса сервера имен
При вызове команды установки IP-адреса сервера имен должны быть указаны следующие параметры:
Параметр запроса установки IP-адреса сервера именПояснение
Параметр запроса установки IP-адреса сервера имен
Пояснение
server_idИдентификатор имени сервера, который вы хотите изменить
ip0 - ip9IP-адрес, который вы хотите назначить серверу имен, за один запрос можно добавить 9 IP-адресов, они должны быть разделены запятыми
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetNsIpResponse></SetNsIpResponse>Корневой узел XML-документа ответа
<SetNsIpHeader></SetNsIpHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки IP-адреса сервера имен
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Response (XML format)
<SetNsIpResponse>
<SetNsIpHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNsIpHeader>
</SetNsIpResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Response (JSON format)
{
"SetNsIpResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда удаления сервера имен
При вызове команды удаления сервера имен должны быть указаны следующие параметры:
Параметр запроса удаления сервера именПояснение
Параметр запроса удаления сервера имен
Пояснение
server_idИдентификатор серверов имен, которые вы хотите удалить, они должны разделяться запятыми
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DeleteNsResponse></DeleteNsResponse>Корневой узел XML-документа ответа
<DeleteNsHeader></DeleteNsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример удаления сервера имен
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=delete_ns&server_id=0
Response (XML format)
<DeleteNsResponse>
<DeleteNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteNsHeader>
</DeleteNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=delete_ns&server_id=0
Response (JSON format)
{
"DeleteNsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Delete Name Server By Domain Command
If calling delete name server by domain command, the following parameters should be included:
Delete Name Server By Domain Request ParameterПояснение
Delete Name Server By Domain Request Parameter
Пояснение
server_domainName of the name server. ex: ns1.testnameserver.com
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DeleteNsResponse></DeleteNsResponse>Корневой узел XML-документа ответа
<DeleteNsHeader></DeleteNsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Delete Name Server By Domain Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Response (XML format)
<DeleteNsResponse>
<DeleteNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteNsHeader>
</DeleteNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Response (JSON format)
{
"DeleteNsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда получения списка серверов
This command is only available in XML and JSON format:
Параметр запроса получения списка серверовПояснение
Параметр запроса получения списка серверов
Пояснение
N/AДополнительных параметров не требуется
XML-тег результатаПояснение
XML-тег результата
Пояснение
<ServerListResponse></ServerListResponse>Корневой узел XML-документа ответа
<ServerListHeader></ServerListHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<ServerListContent></ServerListContent>Содержимое ответа
<NameServerList></NameServerList>Список серверов имен
<List></List>
<Server></Server>
<ServerId></ServerId>Идентификатор сервера
<ServerName></ServerName>Имя сервера
<ServerIp></ServerIp>IP-адрес сервера
Пример получения списка серверов имен
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=server_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ServerListResponse>
<ServerListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ServerListHeader>
<ServerListContent>
<NameServerList>
<List>
<Server>
<ServerId>0</ServerId>
<ServerName>ns1.com</ServerName>
</Server>
<Server>
<ServerId>1</ServerId>
<ServerName>domain1.com</ServerName>
<ServerIp>192.168.1.1</ServerIp>
<ServerIp>1.1.1.1</ServerIp>
</Server>
</List>
</NameServerList>
</ServerListContent>
</ServerListResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=server_list
Response (JSON format)
{
"ServerListResponse": {
"ResponseCode": 0,
"Status": "success",
"ServerList": [
{
"ServerId": "0",
"ServerName": "ns1.com"
},
{
"ServerId": "1",
"ServerName": "domain1.com",
"ServerIps": [
{
"Ip": "192.168.1.1"
},
{
"Ip": "1.1.1.1"
}
]
}
]
}
}
Get Domain NameServer Settings Command
If calling get domain nameservers settings command, the following parameters should be included:
Get Domain Nameserver Settings Request ParameterПояснение
Get Domain Nameserver Settings Request Parameter
Пояснение
domainThe domain whose name server setting you want to get, only 1 domain's name server setting can be pulled per request.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetDnsResponse></GetDnsResponse>Корневой узел XML-документа ответа
<GetDnsHeader></GetDnsHeader>Заголовок ответа
<ResponseCode></ResponseCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetDnsContent></GetDnsContent>Содержимое ответа
<NameServerSettings></NameServerSettings>Настройки сервера доменного имени
<Type></Type>Тип сервера доменного имени
Get Domain Nameserver Settings Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_dns&domain=mydomain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetDnsResponse>
<GetDnsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetDnsHeader>
<GetDnsContent>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
</GetDnsContent>
</GetDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_dns&domain=mydomain.com
Response (JSON format)
{
"GetDnsResponse": {
"ResponseCode": 0,
"Status": "success",
"GetDns": {
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
}
}
}
}
Get Transfer Auth Code Command
Вы должны разблокировать свой домен и учетную запись перед запросом кода авторизации.
Параметр запроса кода авторизации переносаПояснение
Параметр запроса кода авторизации переноса
Пояснение
domainДоменное имя, для которого вы хотите получить код авторизации переноса, в запросе можно указать только 1 домен
new_code (optional)Сгенерировать новый код авторизации переноса
unlock_domain_for_transfer (Optional. Requires api skip lock agreement to use)Если вы хотите разблокировать домен для переноса, установите для этого параметра «1». В случае успешной обработки запроса домен будет разблокирован.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetTransferAuthCodeResponse></GetTransferAuthCodeResponse>Корневой узел XML-документа ответа
<GetTransferAuthCodeHeader></GetTransferAuthCodeHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<AuthCode></AuthCode>Код авторизации используется для запуска переноса домена.
Пример получения кода авторизации переноса
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Response (XML format)
<GetTransferAuthCodeResponse>
<GetTransferAuthCodeHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<AuthCode>testauthcode</AuthCode>
</GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Response (JSON format)
{
"GetTransferAuthCodeResponse":{
"ResponseCode":"0",
"Status":"success",
"AuthCode":"testauthcode"
}
}
Get Transfer Status Command
If calling get transfer status command, the following parameters should be included:
Get Transfer Status Request ParameterПояснение
Get Transfer Status Request Parameter
Пояснение
domainThe domain name you want to get transfer status for, only 1 domain can be entered per request
transfer_typeThe transfer type you want to get transfer status for (transfer in or transfer away)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetTransferStatusResponse></GetTransferStatusResponse>Корневой узел XML-документа ответа
<GetTransferStatusHeader></GetTransferStatusHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetTransferStatusContent></GetTransferStatusContent>Содержимое ответа
<TransferList></TransferList>Transfer list
<Transfer></Transfer>Transfer info
<OrderId></OrderId>The order id
<TransferStatus></TransferStatus>The transfer status of domain.If you got 'none' or 'approved', you can cancel the transfer.If you got 'waiting', means transfer already start.If you got 'auth code needed', means bad auth code, you can use another api SET_TRANSFER_AUTH re-submit auth code.There are also some other statuses, we will send you an email or needs to be checked by our engineers.
Get Transfer Status Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_transfer_status&domain=domian1.com&transfer_type=in
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferStatusResponse>
<GetTransferStatusHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetTransferStatusHeader>
<GetTransferStatusContent>
<TransferList>
<Transfer>
<OrderId>testorderid</OrderId>
<TransferStatus>teststatus</TransferStatus>
</Transfer>
<Transfer>
<OrderId>testorderid2</OrderId>
<TransferStatus>teststatus2</TransferStatus>
</Transfer>
</TransferList>
</GetTransferStatusContent>
</GetTransferStatusResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_transfer_status&domain=domian1.com&transfer_type=in
Response (JSON format)
{
"GetTransferStatusResponse": {
"ResponseCode": 0,
"Status": "success",
"TransferList": [
{
"OrderId": "testorderid",
"TransferStatus": "teststatus"
},
{
"OrderId": "testorderid2",
"TransferStatus": "teststatus2"
}
]
}
}
Set Transfer Auth Code For Transfer Order Command
The command which allows you to update auth code for processing transfer orders. If calling set transfer auth code command, the following parameters should be included:
Set Transfer Auth Code Request ParameterПояснение
Set Transfer Auth Code Request Parameter
Пояснение
domainThe domain name you update the transfer auth for, only 1 domain can be entered per request
auth_codeThe auth_code you want to re-submit
order_idThe transfer order id, you can get it from another api get_transfer_status.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetTransferStatusResponse></GetTransferStatusResponse>Корневой узел XML-документа ответа
<GetTransferStatusHeader></GetTransferStatusHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Set Transfer Auth Code Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Response (XML format)
<SetTransferAuthCodeResponse>
<SetTransferAuthCodeHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Response (JSON format)
{
"SetTransferAuthCodeResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Cancel Transfer For Order Command
The Command allows you to cancel a transfer item in the order. If calling cancel transfer command, the following parameters should be included:
Cancel Transfer Request ParameterПояснение
Cancel Transfer Request Parameter
Пояснение
domainThe domain name you want to cancel transfer for, only 1 domain can be entered per request
order_idThe transfer order id, you can get it from another api get_transfer_status.
XML-тег результатаПояснение
XML-тег результата
Пояснение
<CancelTransferResponse></CancelTransferResponse>Корневой узел XML-документа ответа
<CancelTransferHeader></CancelTransferHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Cancel Transfer Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=cancel_transfer&domain=domain4.com
Response (XML format)
<CancelTransferResponse>
<CancelTransferHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CancelTransferHeader>
</CancelTransferResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=cancel_transfer&domain=domain4.com
Response (JSON format)
{
"CancelTransferResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Authorize Transfer Away Command (RESELLER ONLY)
Authorize Transfer Away Request ParameterПояснение
Authorize Transfer Away Request Parameter
Пояснение
domainThe domain name you want to authorize transfer away for, only 1 domain can be entered per request
order_idThe Dynadot order_id of the domain you want to transfer away
authorizeTo authorize the transfer away, set it equal to "approve". To deny the transfer away, set it equal to "deny".
XML-тег результатаПояснение
XML-тег результата
Пояснение
<AuthorizeTransferAwayResponse></AuthorizeTransferAwayResponse>Корневой узел XML-документа ответа
<AuthorizeTransferAwayHeader></AuthorizeTransferAwayHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<Result></Result>The result of authorize transfer away
Authorize Transfer Away Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=authorize_transfer_away&domain=domian.com&authorize=approve&order_id=123
Response (XML format)
<AuthorizeTransferAwayResponse>
<AuthorizeTransferAwayHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<Result>away_approved</Result>
</AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=authorize_transfer_away&domain=domian.com&authorize=approve&order_id=123
Response (JSON format)
{
"AuthorizeTransferAwayResponse":{
"ResponseCode":"0",
"Status":"success",
"Result":"away_approved"
}
}
Create CN Audit Command
The Command allows you to create a CN audit for a contact. If calling create cn audit command, the following parameters should be included:
Create CN Audit Request ParameterПояснение
Create CN Audit Request Parameter
Пояснение
contact_idThe contact record id you want start audit for, only 1 contact id can be entered per request
contact_typeType of contact, can be either "Individual" or "Enterprise"
individual_id_typeNatural person's ID type, expected values (description of value) are:
JGZ (Officer's identity card of the People's Republic of China)
SFZ (ID card of the People's Republic of China)
HZ (Passport)
GAJMTX (Exit-Entry Permit for Travelling to and from Hong Kong and Macao)
TWJMTX (Travel passes for Taiwan Residents to Enter or Leave the Mainland)
WJLSFZ (Foreign Permanent Resident ID Card of the People's Republic of China)
GAJZZ (Residence permit for Hong Kong, Macao)
TWJZZ (Residence permit for Taiwan residents)
QT (Others)
individual_license_idThe License number of natural person's ID
individual_urlDocument of natural person license ID. The file url on the server. Only jpg, gif, png, jpeg are allowed
enterprise_id_type (Mandatory when contact type is "Enterprise")Enterprise ID type, expected values (description of value) are:
ORG (Organization Code Certificate)
YYZZ (Business License)
TYDM (Certificate for Uniform Social Credit Code)
BDDM (Military Code Designation)
JDDWFW (Military Paid External Service License)
SYDWFR (Public Institution Legal Person Certificate)
WGCZJG (Resident Representative Offices of Foreign Enterprises Registration Form)
SHTTFR (Social Organization Legal Person Registration Certificate)
ZJCS (Religion Activity Site Registration Certificate)
MBFQY (Private Non-Enterprise Entity Registration Certificate)
JJHFR (Fund Legal Person Registration Certificate)
LSZY (Practicing License of Law Firm)
WGZHWH (Registration Certificate of Foreign Cultural Center in China)
WLCZJG (Resident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate)
SFJD (Judicial Expertise License)
JWJG (Overseas Organization Certificate)
SHFWJG (Social Service Agency Registration Certificate)
MBXXBX (Private School Permit)
YLJGZY (Medical Institution Practicing License)
GZJGZY (Notary Organization Practicing License)
BJWSXX (Beijing School for Children of Foreign Embassy Staff in China Permit)
QTTYDM (Others-Certificate for Uniform Social Credit Code)
QT (Others)
enterprise_license_id (Mandatory when contact type is "Enterprise")The License number of enterprise document
enterprise_url (Mandatory when contact type is "Enterprise")Document of enterprise license. The file url on the server. Only jpg, gif, png, jpeg are allowed
XML-тег результатаПояснение
XML-тег результата
Пояснение
<CreateCnAuditResponse></CreateCnAuditResponse>Корневой узел XML-документа ответа
<CreateCnAuditHeader></CreateCnAuditHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Create CN Audit Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Response (XML format)
<CreateCnAuditResponse>
<CreateCnAuditHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CreateCnAuditHeader>
</CreateCnAuditResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=create_cn_audit&contact_id=testcontactid&license_id=testlicenseid&url=url
Response (JSON format)
{
"CreateCnAuditResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Get Cn Audit Status Command
If calling get cn audit status command, the following parameters should be included:
Get Cn Audit Status Request ParameterПояснение
Get Cn Audit Status Request Parameter
Пояснение
contact_idThe contact record id you want to get audit status for, only 1 contactId can be entered per request
gtldIf you query the audit result of the cnnic-gtld, set this parameter to 1
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetCnAuditStatusResponse></GetCnAuditStatusResponse>Корневой узел XML-документа ответа
<GetCnAuditStatusHeader></GetCnAuditStatusHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<CnAuditStatus></CnAuditStatus>the audit status of cnnic audit record. You may got 'processing' or 'waiting for cnnic' or 'failed'. If failed, we will send you an email.
<FailedReason></FailedReason>If the audit unpass, the failed reason will be displayed
Get Cn Audit Status Example
Request (XML format)
https://api.dynadot.xml/api3.xml?key=mykey&command=get_cn_audit_status&contact_id=testcontactid
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
<GetCnAuditStatusHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<CnAuditStatus>pass</CnAuditStatus>
</GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
Request (JSON format)
https://api.dynadot.json/api3.xml?key=mykey&command=get_cn_audit_status&contact_id=testcontactid
Response (JSON format)
{
"GetCnAuditStatusResponse": {
"ResponseCode": "0",
"Status": "success",
"CnAuditStatus": "pass"
}
}
Get Account Balance Command
This command is only available in XML and JSON format:
Get Account Balance Request ParameterПояснение
Get Account Balance Request Parameter
Пояснение
N/AДополнительных параметров не требуется
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetAccountBalanceResponse></GetAccountBalanceResponse>Корневой узел XML-документа ответа
<GetAccountBalanceHeader></GetAccountBalanceHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetAccountBalanceContent></GetAccountBalanceContent>Содержимое ответа
<Balance></Balance>Баланс уч. записи
Get Account Balance Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_account_balance
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetAccountBalanceResponse>
<GetAccountBalanceHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAccountBalanceHeader>
<GetAccountBalanceContent>
<BalanceList>
<Balance>
<Currency>USD</Currency>
<Amount>300.00</Amount>
</Balance>
</BalanceList>
</GetAccountBalanceContent>
</GetAccountBalanceResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_account_balance
Response (JSON format)
{
"GetAccountBalanceResponse": {
"ResponseCode": 0,
"Status": "success",
"BalanceList": [
{
"Currency": "USD",
"Amount": "300.00"
}
]
}
}
Get Listings Command
If calling get listings command, the following parameters should be included:
Get Listings Request ParameterПояснение
Get Listings Request Parameter
Пояснение
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
exclude_pending_sale (необязательно)If you don't want to get pending sale lock listings, it should be "yes", default is "no"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetListingsResponse></GetListingsResponse>Корневой узел XML-документа ответа
<GetListingsHeader></GetListingsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetListingsContent></GetListingsContent>Listing content
<Listing></Listing>Listing item content
<ListingId></ListingId>Listing Id
<Domain></Domain>Доменное имя
<Price></Price>Цена
<InBoundLinks></InBoundLinks>In bound links count
<Age></Age>Возраст
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Get Listings Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey¤cy=usd&command=get_listings
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsResponse>
<GetListingsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetListingsHeader>
<GetListingsContent>
<Listing>
<ListingId>id1</ListingId>
<Domain>domain_name1</Domain>
<Price>1</Price>
<InboundLinks>1</InboundLinks>
<Age>1</Age>
<PendingSaleLocked>No</PendingSaleLocked>
</Listing>
<Listing>
<ListingId>id2</ListingId>
<Domain>domain_name2</Domain>
<Price>2</Price>
<InboundLinks>2</InboundLinks>
<Age>2</Age>
<PendingSaleLocked>No</PendingSaleLocked>
</Listing>
</GetListingsContent>
</GetListingsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey¤cy=usd&command=get_listings
Response (JSON format)
{
"GetListingsResponse": {
"ResponseCode": 0,
"Status": "success",
"Listing": [
{
"ListingId": "id1",
"Domain": "domain_name1",
"Price": "1",
"InboundLinks": "1",
"Age": "1",
"PendingSaleLocked": "No"
},
{
"ListingId": "id2",
"Domain": "domain_name2",
"Price": "2",
"InboundLinks": "2",
"Age": "2",
"PendingSaleLocked": "No"
}
]
}
}
Get Listing Item Command
If calling get listing item command, the following parameters should be included:
Get Listing Item Request ParameterПояснение
Get Listing Item Request Parameter
Пояснение
domainThe domain name you want to get detail, only 1 domain can be entered per request
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetListingItemResponse></GetListingItemResponse>Корневой узел XML-документа ответа
<GetListingItemHeader></GetListingItemHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetListingsItemContent></GetListingsItemContent>Listing content
<Listing></Listing>Listing item content
<ListingId></ListingId>Listing Id
<Domain></Domain>Доменное имя
<Price></Price>Цена
<InBoundLinks></InBoundLinks>In bound links count
<Age></Age>Возраст
Get Listing Item Example
Request (XML format)
http://api.dynadot.com/api3.xml?key=my_key&command=get_listing_item¤cy=usd&domain=domain_name
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsItemResponse>
<GetListingsItemHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetListingsItemHeader>
<GetListingsItemContent>
<Listing>
<ListingId>id</ListingId>
<Domain>domain_name</Domain>
<Price>0</Price>
<InboundLinks>0</InboundLinks>
<Age>0</Age>
<PendingSaleLocked>No</PendingSaleLocked>
</Listing>
</GetListingsItemContent>
</GetListingsItemResponse>
Request (JSON format)
http://api.dynadot.com/api3.json?key=my_key&command=get_listing_item¤cy=usd&domain=domain_name
Response (JSON format)
{
"GetListingsItemResponse": {
"ResponseCode": 0,
"Status": "success",
"Listing": {
"ListingId": "id",
"Domain": "domain_name",
"Price": "0",
"InboundLinks": "0",
"Age": "0",
"PendingSaleLocked": "No"
}
}
}
Buy It Now Command
If calling buy it now command, the following parameters should be included:
Buy It Now Request ParameterПояснение
Buy It Now Request Parameter
Пояснение
domainThe domain you want to buy, only 1 domain can be entered per request
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<BuyItNowResponse></BuyItNowResponse>Корневой узел XML-документа ответа
<BuyItNowHeader></BuyItNowHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<Message></Message>It should be "domain order created", only used when status is "success".
Buy It Now Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=buy_it_now&domain=domain¤cy=currency
Response (XML format)
<BuyItNowResponse>
<BuyItNowHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</BuyItNowHeader>
<Message>domain order created</Message>
</BuyItNowResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=buy_it_now&domain=domain¤cy=currency
Response (JSON format)
{
"BuyItNowResponse":{
"ResponseCode":"0",
"Status":"success",
"Message":"domain order created"
}
}
Команда получения информации об учетной записи
This command is only available in XML and JSON format:
Параметр запроса информации об учетной записиПояснение
Параметр запроса информации об учетной записи
Пояснение
N/AДополнительных параметров не требуется
XML-тег результатаПояснение
XML-тег результата
Пояснение
<AccountInfoResponse></AccountInfoResponse>Корневой узел XML-документа ответа
<AccountInfoHeader></AccountInfoHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<AccountInfoContent></AccountInfoContent>Содержимое ответа
<AccountInfo></AccountInfo>Информация учетной записи
<Username></Username>Имя пользователя
<ForumName></ForumName>Имя на форуме
<Contact></Contact>Информация контакта
<Organization></Organization>Организация
<Organization></Organization>Заголовок ответа
<Name></Name>Ваше имя
<Email></Email>Почта
<PhoneCc></PhoneCc>Телефонный код страны
<PhoneNum></PhoneNum>Номер телефона
<Address1></Address1>Адрес 1
<Address2></Address2>Адрес 2
<City></City>Город
<State></State>Регион
<ZipCode></ZipCode>Почтовый индекс
<Country></Country>Страна
<CustomerSince></CustomerSince>Является клиентом с
<AccountLock></AccountLock>Блокировка для учетной записи
<TotalSpending></TotalSpending>Суммарные расходы
<PriceLevel></PriceLevel>Ценовой уровень
<AccountBalance></AccountBalance>Баланс учетной записи
<CustomTimeZone></CustomTimeZone>Часовой пояс клиента
<DefaultSettings></DefaultSettings>Настройки по умолчанию
<DefaultWhois></DefaultWhois>Whois по умолчанию
<DefaultRegistrant></DefaultRegistrant>Регистрирующее лицо по умолчанию
<ContactId></ContactId>Идентификатор контакта
<DefaultAdmin></DefaultAdmin>Администратор по умолчанию
<DefaultTechnical></DefaultTechnical>Технический по умолчанию
<DefaultBilling></DefaultBilling>Биллинг по умолчанию
<Type></Type>Тип сервера имен
<WithAds></WithAds>С рекламой или без нее
Пример получения информации об учетной записи
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=account_info
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
<AccountInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</AccountInfoHeader>
<AccountInfoContent>
<AccountInfo>
<Username>testname</Username>
<ForumName>test forum name</ForumName>
<Contact>
<Organization/>
<Name>testname test</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>1 test road</Address1>
<Address2/>
<City>Los Angeles</City>
<State>CA</State>
<ZipCode>90000</ZipCode>
<Country>US</Country>
</Contact>
<CustomerSince>1364888735253</CustomerSince>
<AccountLock>on</AccountLock>
<TotalSpending>$0.00</TotalSpending>
<PriceLevel>Regular Pricing</PriceLevel>
<AccountBalance>$70.02</AccountBalance>
<CustomTimeZone>PST</CustomTimeZone>
<DefaultSettings>
<DefaultWhois>
<DefaultRegistrant>
<ContactId>0</ContactId>
</DefaultRegistrant>
<DefaultAdmin>
<ContactId>0</ContactId>
</DefaultAdmin>
<DefaultTechnical>
<ContactId>0</ContactId>
</DefaultTechnical>
<DefaultBilling>
<ContactId>0</ContactId>
</DefaultBilling>
</DefaultWhois>
<DefaultNameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>yes</WithAds>
</DefaultNameServerSettings>
</DefaultSettings>
</AccountInfo>
</AccountInfoContent>
</AccountInfoResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=account_info
Response (JSON format)
{
"AccountInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"AccountInfo": {
"Username": "testname",
"ForumName": "test forum name",
"Contact": {
"Organization": "",
"Name": "testname test",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "1 test road",
"Address2": "",
"City": "Los Angeles",
"State": "CA",
"ZipCode": "90000",
"Country": "US"
},
"CustomerSince": "1364888735253",
"AccountLock": "on",
"TotalSpending": "$0.00",
"PriceLevel": "Regular Pricing",
"AccountBalance": "$70.02",
"CustomTimeZone": "PST",
"DefaultSettings": {
"DefaultWhois": {
"DefaultRegistrant": {
"ContactId": "0"
},
"DefaultAdmin": {
"ContactId": "0"
},
"DefaultTechnical": {
"ContactId": "0"
},
"DefaultBilling": {
"ContactId": "0"
}
},
"DefaultNameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "yes"
}
}
}
}
}
Установка Whois по умолчанию
При вызове команды установки Whois по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки Whois по умолчаниюПояснение
Параметр запроса установки Whois по умолчанию
Пояснение
registrant_contactИнформация регистрирующего лица
admin_contactИнформация об администраторе домена
technical_contactТехническая информация о домене
billing_contactБиллинговая информация домена
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultWhoisResponse></SetDefaultWhoisResponse>Корневой узел XML-документа ответа
<SetDefaultWhoisHeader></SetDefaultWhoisHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки Whois по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (XML format)
<SetDefaultWhoisResponse>
<SetDefaultWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultWhoisHeader>
</SetDefaultWhoisResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format)
{
"SetDefaultWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки серверов имен по умолчанию
При вызове команды установки серверов имен по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки серверов имен по умолчаниюПояснение
Параметр запроса установки серверов имен по умолчанию
Пояснение
ns0 - ns12Серверы имен, которые вы хотите установить
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultNsResponse></SetDefaultNsResponse>Тег ответа установки серверов имен по умолчанию, это корневой узел XML-документа ответа
<SetDefaultNsHeader></SetDefaultNsHeader>Тег заголовка установки серверов имен по умолчанию
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<SetDefaultNsContent></SetDefaultNsContent>Тег содержимого установки серверов имен по умолчанию, используется только при статусе "success"
<Servers></Servers>Информация о серверах, которые вы изменили
<Server></Server>Каждый отдельный сервер
<ServerName></ServerName>Имя сервера
<ServerId></ServerId>Идентификатор сервера
Пример установки серверов имен по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Response (XML format)
<SetDefaultNsResponse>
<SetDefaultNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultNsHeader>
<SetDefaultNsContent>
<Servers>
<Server>
<ServerName>ns1.hosts.com</ServerName>
<ServerId>0</ServerId>
</Server>
<Server>
<ServerName>ns2.host.com</ServerName>
<ServerId>1</ServerId>
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
<Server>
<ServerName />
<ServerId />
</Server>
</Servers>
</SetDefaultNsContent>
</SetDefaultNsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Response (JSON format)
{
"SetDefaultNsResponse":{
"ResponseCode":"0",
"Status":"success",
"SetDefaultNsContent":{
"Servers":[
{
"ServerName":"ns1.hosts.com",
"ServerId":"0"
},
{
"ServerName":"ns2.host.com",
"ServerId":"1"
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
}
]
}
}
}
Команда установки парковки по умолчанию
При вызове команды установки парковки по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки парковки по умолчаниюПояснение
Параметр запроса установки парковки по умолчанию
Пояснение
with_ads (необязательно)Если вы не хотите рекламных объявлений от стороннего поставщика, укажите в этом параметре значение "no", по умолчанию значение "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultParkingResponse></SetDefaultParkingResponse>Корневой узел XML-документа ответа
<SetDefaultParkingHeader></SetDefaultParkingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки парковки по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_parking&folder_id=0&with_ads=no
Response (XML format)
<SetDefaultParkingResponse>
<SetDefaultParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultParkingHeader>
</SetDefaultParkingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_parking&folder_id=0&with_ads=no
Response (JSON format)
{
"SetDefaultParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки перенаправления по умолчанию
При вызове команды установки перенаправления по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки перенаправления по умолчаниюПояснение
Параметр запроса установки перенаправления по умолчанию
Пояснение
forward_urlURL-адрес, на который вы хотите перенаправить ваш домен. Обратите внимание, что параметр должен быть закодирован, чтобы вызов API интерпретировался правильно. is_temp (необязательно)Статус перенаправления для домена, по умолчанию (временный) "temporary", если вы хотите установить постоянное перенаправление, укажите в этом параметре "no"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>Корневой узел XML-документа ответа
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки перенаправления по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_forwarding&forward_url=http%3A%2F%2Fmydomain.com
Response (XML format)
<SetDefaultForwardingResponse>
<SetDefaultForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultForwardingHeader>
</SetDefaultForwardingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_forwarding&forward_url=http%3A%2F%2Fmydomain.com
Response (JSON format)
{
"SetDefaultForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки скрытого перенаправления по умолчанию
При вызове команды установки скрытого перенаправления по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки скрытого перенаправления по умолчаниюПояснение
Параметр запроса установки скрытого перенаправления по умолчанию
Пояснение
stealth_urlURL-адрес, на который вы хотите перенаправить ваш домен. Обратите внимание, что параметр должен быть закодирован, чтобы вызов API интерпретировался правильно. stealth_title (необязательно)Заголовок страницы
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultStealthResponse></SetDefaultStealthResponse>Корневой узел XML-документа ответа
<SetDefaultStealthHeader></SetDefaultStealthHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки скрытия по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com
Response (XML format)
<SetDefaultStealthResponse>
<SetDefaultStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultStealthHeader>
</SetDefaultStealthResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com
Response (JSON format)
{
"SetDefaultStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки хостинга по умолчанию
При вызове команды установки хостинга по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки хостинга по умолчаниюПояснение
Параметр запроса установки хостинга по умолчанию
Пояснение
hosting_typeТип желаемого хостинга по умолчанию, можно выбрать "advanced" или "basic"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultHostingResponse></SetDefaultHostingResponse>Корневой узел XML-документа ответа
<SetDefaultHostingHeader></SetDefaultHostingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки хостинга по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_hosting&hosting_type=advanced
Response (XML format)
<SetDefaultHostingResponse>
<SetDefaultHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultHostingHeader>
</SetDefaultHostingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_hosting&hosting_type=advanced
Response (JSON format)
{
"SetDefaultHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки DNS по умолчанию
При вызове команды установки DNS по умолчанию должны быть указаны следующие параметры:
(Эта команда устарела, вместо нее рекомендуется использовать команду Set Default DNS2)
Параметр запроса установки DNS по умолчаниюПояснение
Параметр запроса установки DNS по умолчанию
Пояснение
main_record_typeТип главной записи
main_recordУкажите запись DNS для вашего домена
main_txt (необязательно)Укажите запись TXT для вашего домена. Если основной тип записи (main_record_type) AAAA, и указана основная запись 2 (main_record2), вы можете настроить до 3 основных текстовых (main_txt) записей, в других случаях — до 4.
main_record2Основная запись 2, используется только когда "main_record_type" имеет значение "aaaa". Ее значение должно быть в формате IPv4.
subdomain0 - subdomain99 (необязательно)Записи поддоменов
sub_record_type0 - sub_record_type99 (необязательно)Тип записей поддомена
sub_record0 - sub_record99 (необязательно)Целевой IP-адрес или URL
mx_host0 - mx_host2 (необязательно)Укажите адрес почтового узла для домена, distance0 — высший приоритет
mx_distance0 - mx_distance2 (необязательно)Distance0 — высший приоритет
ttl (необязательно)Время жизни (time to live)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultDnsResponse></SetDefaultDnsResponse>Корневой узел XML-документа ответа
<SetDefaultDnsHeader></SetDefaultDnsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки DNS по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<SetDefaultDnsResponse>
<SetDefaultDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format)
{
"SetDefaultDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Set Default DNS2 Command
При вызове команды установки DNS по умолчанию должны быть указаны следующие параметры:
Параметры запроса Set Default DNS2Пояснение
Параметры запроса Set Default DNS2
Пояснение
main_record_type0 - main_record_type19Тип главной записи
main_record0 - main_record19Укажите запись DNS для вашего домена
main_recordx0 - main_recordx19Приоритет MX, тип переадресации, заголовок скрытого перенаправления или псевдоним эл. почты, необходимые для main_record типа «a», «aaaa», «cname», «forward», «txt», «mx», «stealth», «email»
subdomain0 - subdomain99 (необязательно)Записи поддоменов
sub_record_type0 - sub_record_type99 (необязательно)Тип записей поддомена
sub_record0 - sub_record99 (необязательно)IP-адрес или узел назначения поддомена
sub_recordx0 - subdo_recordx99Приоритет MX, тип переадресации, заголовок скрытого перенаправления или псевдоним эл. почты, необходимые для sub_record_type типа «a», «aaaa», «cname», «forward», «txt», «srv», «mx», «stealth», «email»
ttl (необязательно)Время жизни (time to live)
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultDnsResponse></SetDefaultDnsResponse>Корневой узел XML-документа ответа
<SetDefaultDnsHeader></SetDefaultDnsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример использования команды Set Default DNS2
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (XML format)
<SetDefaultDnsResponse>
<SetDefaultDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (JSON format)
{
"SetDefaultDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки перенаправления Email по умолчанию
При вызове команды установки перенаправления Email по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки перенаправления Email по умолчаниюПояснение
Параметр запроса установки перенаправления Email по умолчанию
Пояснение
forward_typeТип перенаправления, варианты: "donot": не перенаправлять, "mx": направлять электронную почту на другой почтовый узел (запись MX), "forward": направлять электронную почту на другой почтовый узел
username0 - username9Имя пользователя, используется только, если в "forward_type" указано "forward"
exist_email0 - exist_email9Существующий адрес электронной почты, используется только, когда в "forward_type" указано "forward"
mx_host0 - mx_host2Почтовый узел, используется только, когда в "forward_type" указано "mx"
mx_distance0 - mx_distance2Distance0 — высший приоритет, используется только, когда в "forward_type" указано "mx"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultEmailForwardingResponse></SetDefaultEmailForwardingResponse>Корневой узел XML-документа ответа
<SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки перенаправления Email по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&[email protected]
Response (XML format)
<SetDefaultEmailForwardingResponse>
<SetDefaultEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&[email protected]
Response (JSON format)
{
"SetDefaultEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда сброса значения по умолчанию
При вызове команды сброса значения по умолчанию должны быть указаны следующие параметры:
Параметр запроса сброса значения по умолчаниюПояснение
Параметр запроса сброса значения по умолчанию
Пояснение
serviceСлужба, которую вы хотите стереть, может быть «forward», «stealth», «email_forwarding», «dns» и «nameservers»
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>Корневой узел XML-документа ответа
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример сброса значения по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_default_setting&service=nameservers
Response (XML format)
<SetClearDefaultSettingResponse>
<SetClearDefaultSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_clear_default_setting&service=nameservers
Response (JSON format)
{
"SetClearDefaultSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки опции продления по умолчанию
При вызове команды установки опции продления по умолчанию должны быть указаны следующие параметры:
Параметр запроса установки опции продления по умолчаниюПояснение
Параметр запроса установки опции продления по умолчанию
Пояснение
renew_optionМожет быть указано "donot", "auto", "reset"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetDefaultRenewOptionResponse></SetDefaultRenewOptionResponse>Корневой узел XML-документа ответа
<SetDefaultRenewOptionHeader></SetDefaultRenewOptionHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки опции продления по умолчанию
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_default_renew_option&renew_option=auto
Response (XML format)
<SetDefaultRenewOptionResponse>
<SetDefaultRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_default_renew_option&renew_option=auto
Response (JSON format)
{
"SetDefaultRenewOptionResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда создания папки
При вызове команды создания папки должны быть указаны следующие параметры:
Параметр запроса создания папкиПояснение
Параметр запроса создания папки
Пояснение
folder_nameНазвание папки, которую вы хотите создать
XML-тег результатаПояснение
XML-тег результата
Пояснение
<FolderCreateResponse></FolderCreateResponse>Корневой узел XML-документа ответа
<FolderCreateHeader></FolderCreateHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<FolderCreateContent></FolderCreateContent>Содержимое ответа
<FolderName></FolderName>название папки
<FolderId></FolderId>Идентификатор новой папки
Пример создания папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=create_folder&folder_name=new
Response (XML format)
<FolderCreateResponse>
<FolderCreateHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</FolderCreateHeader>
<FolderCreateContent>
<FolderName>new</FolderName>
<FolderId>1</FolderId>
</FolderCreateContent>
</FolderCreateResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=create_folder&folder_name=new
Response (JSON format)
{
"FolderCreateResponse":{
"ResponseCode":"0",
"Status":"success",
"FolderCreateContent":{
"FolderName":"new",
"FolderId":"1"
}
}
}
Команда удаления папки
При вызове команды установки данных Whois должны быть указаны следующие параметры:
Параметр запроса удаления папкиПояснение
Параметр запроса удаления папки
Пояснение
folder_idИдентификатор папок, которые вы хотите удалить, они должны разделяться запятыми
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DeleteFolderResponse></DeleteFolderResponse>Корневой узел XML-документа ответа
<DeleteFolderHeader></DeleteFolderHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример удаления папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=delete_folder&folder_id=0,1
Response (XML format)
<DeleteFolderResponse>
<DeleteFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteFolderHeader>
</DeleteFolderResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=delete_folder&folder_id=0,1
Response (JSON format)
{
"DeleteFolderResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки Whois для папки
При вызове команды установки Whois для папки должны быть указаны следующие параметры:
Параметр запроса установки Whois для папкиПояснение
Параметр запроса установки Whois для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
registrant_contactИнформация регистрирующего лица
admin_contactИнформация об администраторе домена
technical_contactТехническая информация о домене
billing_contactБиллинговая информация домена
enable (необязательно)Если вы хотите применить эти настройки Whois для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать эти настройки Whois для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderWhoisResponse></SetFolderWhoisResponse>Корневой узел XML-документа ответа
<SetFolderWhoisHeader></SetFolderWhoisHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки Whois для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (XML format)
<SetFolderWhoisResponse>
<SetFolderWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderWhoisHeader>
</SetFolderWhoisResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format)
{
"SetFolderWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки серверов имен для папки
При вызове команды установки серверов имен для папки должны быть указаны следующие параметры:
Параметр запроса установки серверов имен для папкиПояснение
Параметр запроса установки серверов имен для папки
Пояснение
fold_idИдентификатор папки, которую вы хотите изменить, за один запрос можно изменить только 1 папку
ns0 - ns12Сервера имен, которые вы хотите установить для домена. Максимальное количество серверов имен, которое можно указать: 13, но они должны быть предварительно внесены в вашу учетную запись.
enable (необязательно)Если вы хотите применить эти настройки серверов имен для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать эти настройки серверов имен для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderNsResponse></SetFolderNsResponse>Тег ответа установки серверов имен для папки, это корневой узел XML-документа ответа
<SetFolderNsHeader></SetFolderNsHeader>Тег заголовка ответа установки серверов имен для папки
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<SetFolderNsContent></SetFolderNsContent>Тег содержимого установки серверов имен для папки, используется, только когда status имеет значение "success"
<Servers></Servers>Информация о серверах, которые вы изменили
<Server></Server>Каждый отдельный сервер
<ServerName></ServerName>Имя сервера
<ServerId></ServerId>Идентификатор сервера
Пример установки серверов имен для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Response (XML format)
0
success
ns1.hosts.com
0
ns2.host.com
1
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Response (JSON format)
{
"SetFolderNsResponse":{
"ResponseCode":"0",
"Status":"success",
"SetFolderNsContent":{
"Servers":[
{
"ServerName":"ns1.hosts.com",
"ServerId":"0"
},
{
"ServerName":"ns2.host.com",
"ServerId":"1"
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
},
{
"ServerName":"",
"ServerId":""
}
]
}
}
}
Команда установки парковки для папки
При вызове команды установки парковки для папки должны быть указаны следующие параметры:
Параметр запроса установки парковки для папкиПояснение
Параметр запроса установки парковки для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить, за один запрос можно изменить только 1 папку
with_ads (необязательно)Если вы не хотите рекламных объявлений от стороннего поставщика, укажите в этом параметре значение "no", по умолчанию значение "yes"
enable (необязательно)Если вы хотите применить эти настройки парковки для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать настройки парковки для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderParkingResponse></SetFolderParkingResponse>Корневой узел XML-документа ответа
<SetFolderParkingHeader></SetFolderParkingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки парковки для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_parking&folder_id=0&with_ads=no
Response (XML format)
<SetFolderParkingResponse>
<SetFolderParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderParkingHeader>
</SetFolderParkingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_parking&folder_id=0&with_ads=no
Response (JSON format)
{
"SetFolderParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки перенаправления для папки
При вызове команды установки перенаправления для папки должны быть указаны следующие параметры:
Параметр запроса установки перенаправления для папкиПояснение
Параметр запроса установки перенаправления для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
forward_urlURL-адрес, на который вы хотите перенаправить ваш домен. Обратите внимание, что параметр должен быть закодирован, чтобы вызов API интерпретировался правильно. is_temp (необязательно)Статус перенаправления для домена, по умолчанию (временный) "temporary", если вы хотите установить постоянное перенаправление, укажите в этом параметре "no"
enable (необязательно)Если вы хотите применить эти настройки перенаправления для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать настройки перенаправления для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderForwardingResponse></SetFolderForwardingResponse>Корневой узел XML-документа ответа
<SetFolderForwardingHeader></SetFolderForwardingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки перенаправления для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_forwarding&folder_id=0&forward_url=http%3A%2F%2Fmydomain.com&sync=yes
Response (XML format)
<SetFolderForwardingResponse>
<SetFolderForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderForwardingHeader>
</SetFolderForwardingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_forwarding&folder_id=0&forward_url=http%3A%2F%2Fmydomain.com&sync=yes
Response (JSON format)
{
"SetFolderForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки скрытого перенаправления для папки
При вызове команды установки скрытого перенаправления для папки должны быть указаны следующие параметры:
Параметр запроса установки скрытого перенаправления для папкиПояснение
Параметр запроса установки скрытого перенаправления для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
stealth_urlURL-адрес, на который вы хотите перенаправить ваш домен. Обратите внимание, что параметр должен быть закодирован, чтобы вызов API интерпретировался правильно. stealth_title (необязательно)Заголовок страницы
enable (необязательно)Если вы хотите применить эти настройки скрытого перенаправления для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать настройки скрытого перенаправления для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderStealthResponse></SetFolderStealthResponse>Корневой узел XML-документа ответа
<SetFolderStealthHeader></SetFolderStealthHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки скрытого перенаправления для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com&sync=yes
Response (XML format)
<SetFolderStealthResponse>
<SetFolderStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderStealthHeader>
</SetFolderStealthResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com&sync=yes
Response (JSON format)
{
"SetFolderStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки хостинга для папки
При вызове команды установки хостинга для папки должны быть указаны следующие параметры:
Параметр запроса установки хостинга для папкиПояснение
Параметр запроса установки хостинга для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
hosting_typeТип желаемого хостинга, можно выбрать "advanced" или "basic"
enable (необязательно)Если вы хотите применить эти настройки хостинга для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
even (необязательно)Если вы хотите синхронизировать настройки хостинга для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderHostingResponse></SetFolderHostingResponse>Корневой узел XML-документа ответа
<SetFolderHostingHeader></SetFolderHostingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки хостинга для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Response (XML format)
<SetFolderHostingResponse>
<SetFolderHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHostingHeader>
</SetFolderHostingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Response (JSON format)
{
"SetFolderHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки DNS для папки
При вызове команды установки DNS для папки должны быть указаны следующие параметры:
(Эта команда устарела, вместо нее рекомендуется использовать команду Set Folder DNS2)
Параметр запроса установки DNS для папкиПояснение
Параметр запроса установки DNS для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
main_record_typeТип главной записи
main_recordУкажите запись DNS для вашего домена
main_recordУкажите запись DNS для вашего домена
with_ads (необязательно)Укажите запись TXT для вашего домена. Если основной тип записи (main_record_type) AAAA, и указана основная запись 2 (main_record2), вы можете настроить до 3 основных текстовых (main_txt) записей, в других случаях — до 4.
main_record2Основная запись 2, используется только когда "main_record_type" имеет значение "aaaa". Ее значение должно быть в формате IPv4.
subdomain0 - subdomain99 (необязательно)Subdomain records (необязательно)
sub_record_type0 - sub_record_type99 (необязательно)Тип записей поддомена
sub_record0 - sub_record99 (необязательно)Целевой IP-адрес или URL
mx_host0 - mx_host2 (необязательно)Укажите адрес почтового узла для домена, distance0 — высший приоритет
mx_distance0 - mx_distance2 (необязательно)Distance0 — высший приоритет
ttl (необязательно)Время жизни (time to live)
enable (необязательно)Если вы хотите применить эти настройки DNS для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать настройки DNS для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderDnsResponse></SetFolderDnsResponse>Корневой узел XML-документа ответа
<SetFolderDnsHeader></SetFolderDnsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки DNS для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<SetFolderDnsResponse>
<SetFolderDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderDnsHeader>
</SetFolderDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format)
{
"SetFolderDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда Set Folder DNS2
При вызове команды set folder DNS2 необходимо указать следующие параметры:
Параметры запроса Set Folder DNS2Пояснение
Параметры запроса Set Folder DNS2
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
main_record_type0 - main_record_type19Тип основной записи должен быть «a», «aaaa», «cname», «forward», «txt», «srv», «mx», «stealth», «email»
main_record0 - main_record19Укажите запись DNS для вашего домена
main_recordx0 - main_recordx19Приоритет MX, тип переадресации, заголовок скрытого перенаправления или псевдоним эл. почты, необходимые для main_record_type типа «forward», «mx», «stealth», «email»
subdomain0 - subdomain99 (необязательно)Subdomain records (необязательно)
sub_record_type0 - sub_record_type99 (необязательно)Тип записей поддомена должен быть «a», «aaaa», «cname», «forward», «txt», «srv», «mx», «stealth», «email»
sub_record0 - sub_record99 (необязательно)Целевой IP-адрес или URL
sub_recordx0 - sub_recordx99 (необязательно)Приоритет MX, тип переадресации, заголовок скрытого перенаправления или псевдоним эл. почты, необходимые для sub_record_type типа «forward», «mx», «stealth», «email»
ttl (необязательно)Время жизни (time to live)
enable (необязательно)Если вы хотите применить эти настройки DNS для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать настройки DNS для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderDnsResponse></SetFolderDnsResponse>Корневой узел XML-документа ответа
<SetFolderDnsHeader></SetFolderDnsHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример использования команды Set Folder DNS2
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (XML format)
<SetFolderDnsResponse>
<SetFolderDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderDnsHeader>
</SetFolderDnsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (JSON format)
{
"SetFolderDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки перенаправления Email для папки
При вызове команды установки перенаправления Email для папки должны быть указаны следующие параметры:
Параметр запроса установки перенаправления Email для папкиПояснение
Параметр запроса установки перенаправления Email для папки
Пояснение
domainДоменное имя, которое вы хотите изменить, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
folder_idИдентификатор папки, которую вы хотите изменить
forward_typeТип перенаправления, варианты: "donot": не перенаправлять, "mx": направлять электронную почту на другой почтовый узел (запись MX), "forward": направлять электронную почту на другой почтовый узел
username0 - username9Имя пользователя, используется только, если в "forward_type" указано "forward"
exist_email0 - exist_email9Существующий адрес электронной почты, используется только, когда в "forward_type" указано "forward"
mx_host0 - mx_host2Почтовый узел, используется только, когда в "forward_type" указано "mx"
mx_distance0 - mx_distance2Distance0 — высший приоритет, используется только, когда в "forward_type" указано "mx"
enable (необязательно)Если вы хотите применить эти настройки для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать эти настройки для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>Корневой узел XML-документа ответа
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки перенаправления Email для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=peter&[email protected]
Response (XML format)
<SetFolderEmailForwardingResponse>
<SetFolderEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=peter&[email protected]
Response (JSON format)
{
"SetFolderEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда сброса значения для папки
При вызове команды сброса значения для папки должны быть указаны следующие параметры:
Параметр запроса сброса значения для папкиПояснение
Параметр запроса сброса значения для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
serviceСлужба, которую вы хотите стереть, может быть «forward», «stealth», «email_forwarding», «dns» и «nameservers»
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>Корневой узел XML-документа ответа
<SetClearFolderSettingHeader></SetClearFolderSettingHeaderr>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример сброса значения для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_folder_setting&folder_id=0&service=nameservers
Response (XML format)
<SetClearFolderSettingResponse>
<SetClearFolderSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearFolderSettingHeader>
</SetClearFolderSettingResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_clear_folder_setting&folder_id=0&service=nameservers
Response (JSON format)
{
"SetClearFolderSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки названия папки
При вызове команды установки названия папки должны быть указаны следующие параметры:
Параметр запроса установки названия папкиПояснение
Параметр запроса установки названия папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить
folder_nameНовое название папки
XML-тег результатаПояснение
XML-тег результата
Пояснение
<SetFolderNameResponse></SetFolderNameResponse>Корневой узел XML-документа ответа
<SetFolderNameHeader></SetFolderNameHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример установки названия папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_name&folder_id=0&folder_name=new
Response (XML format)
<SetFolderNameResponse>
<SetFolderNameHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderNameHeader>
</SetFolderNameResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_name&folder_id=0&folder_name=new
Response (JSON format)
{
"SetFolderNameResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда установки опции продления для папки
При вызове команды установки опции продления для папки должны быть указаны следующие параметры:
Параметр запроса установки опции продления для папкиПояснение
Параметр запроса установки опции продления для папки
Пояснение
folder_idИдентификатор папки, которую вы хотите изменить, за один запрос можно изменить только 1 папку
renew_optionThe renew option you want to set to the folder; it can be "donot", "auto" or "reset"
enable (необязательно)Если вы хотите применить эти настройки продления для всех доменов, которые вы в будущем переместите в эту папку, вы можете указать в этом параметре "yes"
sync (необязательно)Если вы хотите синхронизировать эти настройки продления для всех доменов в этой папке, вы можете указать в этом параметре "yes"
XML-тег результатаПояснение
XML-тег результата
Пояснение
<Response></Response>Корневой узел XML-документа ответа
<ResponseHeader></ResponseHeader>Заголовок ответа
<ResponseCode></ResponseCode>Код ответа, "0" при успешном завершении, "-1" при сбое
<Error></Error>Информация об ошибке, используется только при коде ответа "-1"
Пример установки опции продления для папки
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_renew_option&folder_id=0&renew_option=auto
Response (XML format)
<SetFolderRenewOptionResponse>
<SetFolderRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=set_folder_renew_option&folder_id=0&renew_option=auto
Response (JSON format)
{
"SetFolderRenewOptionResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда списка папок
This command is only available in XML and JSON format:
Параметр запроса списка папокПояснение
Параметр запроса списка папок
Пояснение
N/AДополнительных параметров не требуется
<FolderListResponse></FolderListResponse>Корневой узел XML-документа ответа
<FolderListHeader></FolderListHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<FolderListContent></FolderListContent>Содержимое ответа
<FolderList></FolderList>Список папок
<List></List>
<Folder></Folder>
<FolderId></FolderId>Идентификатор папки
<FolderName></FolderName>Название папки
<DefaultWhois></DefaultWhois>Whois по умолчанию
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>Статус включения Whois по умолчанию (Whois enable)
<DefaultRegistrant></DefaultRegistrant>Регистрирующее лицо по умолчанию
<ContactId></ContactId>Идентификатор контакта
<DefaultAdmin></DefaultAdmin>Администратор по умолчанию
<DefaultTechnical></DefaultTechnical>Техническая информация по умолчанию
<DefaultBilling></DefaultBilling>Биллинговая информация по умолчанию
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>Статус включения сервера имен по умолчанию (name server enable)
<NameServerSettings></NameServerSettings>Значение сервера имен
<Type></Type>Тип сервера имен
<WithAds></WithAds>С рекламой или без нее
<DefaultRenewOption></DefaultRenewOption>Настройка продления по умолчанию
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>Статус включения настройки продления по умолчанию
<RenewOption></RenewOption>Настройка продления
<DefaultTransferLock></DefaultTransferLock>Значение блокировки переноса по умолчанию
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>Статус включения блокировки переноса по умолчанию
<LockStatus></LockStatus>Статус блокировки
Пример получения списка папок
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=folder_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<FolderListResponse>
<FolderListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</FolderListHeader>
<FolderListContent>
<FolderList>
<List>
<Folder>
<FolderId>0</FolderId>
<FolderName>new</FolderName>
<DefaultWhois>
<DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
<DefaultRegistrant>
<ContactId>0</ContactId>
</DefaultRegistrant>
<DefaultAdmin>
<ContactId>0</ContactId>
</DefaultAdmin>
<DefaultTechnical>
<ContactId>0</ContactId>
</DefaultTechnical>
<DefaultBilling>
<ContactId>0</ContactId>
</DefaultBilling>
</DefaultWhois>
<DefaultNameServers>
<DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
</DefaultNameServers>
<DefaultRenewOption>
<DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
<RenewOption>no renew option</RenewOption>
</DefaultRenewOption>
<DefaultTransferLock>
<DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
<LockStatus>locked</LockStatus>
</DefaultTransferLock>
</Folder>
</List>
</FolderList>
</FolderListContent>
</FolderListResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=folder_list
Response (JSON format)
{
"FolderListResponse": {
"ResponseCode": 0,
"Status": "success",
"FolderList": [
{
"FolderId": "0",
"FolderName": "new",
"DefaultWhois": {
"DefaultWhoisEnableStatus": "disable",
"DefaultRegistrant": {
"ContactId": "0"
},
"DefaultAdmin": {
"ContactId": "0"
},
"DefaultTechnical": {
"ContactId": "0"
},
"DefaultBilling": {
"ContactId": "0"
}
},
"DefaultNameServers": {
"DefaultTransferLockEnableStatus": "disable",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
}
},
"DefaultRenewOption": {
"DefaultRenewOptionEnableStatus": "disable",
"RenewOption": "no renew option"
},
"DefaultTransferLock": {
"DefaultTransferLockEnableStatus": "disable",
"LockStatus": "locked"
}
}
]
}
}
Команда добавления запроса на отложенный заказ
При вызове команды добавления запроса на отложенный заказ должны быть указаны следующие параметры:
Параметр запроса на добавления запроса на отложенный заказПояснение
Параметр запроса на добавления запроса на отложенный заказ
Пояснение
domainДомены, которые вы хотите добавить и согласны оплатить, если Dynadot перехватит их, за один запрос можно добавить 100 доменов, они должны быть разделены запятыми
XML-тег результатаПояснение
XML-тег результата
Пояснение
<AddBackorderRequestResponse></AddBackorderRequestResponse>Корневой узел XML-документа ответа
<AddBackorderRequestHeader></AddBackorderRequestHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример добавления запроса на отложенный заказ
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Response (XML format)
<AddBackorderRequestResponse>
<AddBackorderRequestHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</AddBackorderRequestHeader>
</AddBackorderRequestResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Response (JSON format)
{
"AddBackorderRequestResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда удаления запроса на отложенный заказ
При вызове команды удаления запроса на отложенный заказ должны быть указаны следующие параметры:
Параметр запроса на удаление запроса на отложенный заказПояснение
Параметр запроса на удаление запроса на отложенный заказ
Пояснение
domainДомены, которые вы хотите удалить из запроса на отложенный заказ, за один запрос можно удалить 100 доменов, они должны быть разделены запятыми
XML-тег результатаПояснение
XML-тег результата
Пояснение
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>Корневой узел XML-документа ответа
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример удаления запроса на отложенный заказ
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=delete_backorder_request&domain=domaindropp.com
Response (XML format)
<DeleteBackorderRequestResponse>
<DeleteBackorderRequestHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=delete_backorder_request&domain=domaindropp.com
Response (JSON format)
{
"DeleteBackorderRequestResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда запроса списка отложенных заказов
Вызов команды получения списка отложенных заказов возвращает список отложенных заказов для указанной учетной записи. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса списка отложенных заказовПояснение
Параметр запроса списка отложенных заказов
Пояснение
startDateНачальная дата освобождения доменов, гггг-мм-дд, например 2015-05-05
endDateДата окончания освобождения доменов, гггг-мм-дд, например 2015-05-05
XML-тег результатаПояснение
XML-тег результата
Пояснение
<BackorderRequestListResponse></BackorderRequestListResponse>Корневой узел XML-документа ответа
<BackorderRequestListHeader></BackorderRequestListHeader>Заголовок ответа
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<BackorderRequestListContent></BackorderRequestListContent>Содержимое ответа
<BackorderRequestList></BackorderRequestList>Список запроса отложенных заказов
<BackorderRequest></BackorderRequest>Запрос на отложенные заказы
<Domain></Domain>Домен из вашего списка
<CutoffTime></CutoffTime>Конечный срок для удаления запроса в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
<BackorderRequestStatus></BackorderRequestStatus>Статус процесса перехвата домена
Пример запроса списка отложенных заказов
Request (XML format)
http://api.dynadot.com/api3.xml?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BackorderRequestListResponse>
<BackorderRequestListHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</BackorderRequestListHeader>
<BackorderRequestListContent>
<BackorderRequestList>
<BackorderRequest>
<DomainName>testdrop.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop3.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop4.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop5.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
</BackorderRequestList>
</BackorderRequestListContent>
</BackorderRequestListResponse>
Request (CSV format)
http://api.dynadot.com/api3.html?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (CSV format)
ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
Request (JSON format)
http://api.dynadot.com/api3.json?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (JSON format)
{
"BackorderRequestListResponse": {
"ResponseCode": 0,
"Status": "success",
"BackorderRequestList": [
{
"DomainName": "testdrop.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop3.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop4.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop5.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
}
]
}
}
Команда получения списка открытых аукционов
Вызов команды получения открытых аукционов вернет список активных на данный момент аукционов. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса на получение списка открытых аукционовПояснение
Параметр запроса на получение списка открытых аукционов
Пояснение
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
type (необязательно)The auction type you want to see, it should be "expired", "user", or "backorder", if you want to get more than one auction types, you can use "," to split each auction type
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>Тег ответа получения открытых аукционов. Это корневой узел XML-документа ответа
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>Заголовок получения открытых аукционов
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetOpenAuctionsContent></GetOpenAuctionsContent>Тег содержимого получения открытых аукционов, используется только при статусе "success"
<Auction></Auction>Тег аукционного лота, используется только при статусе "success"
<AuctionId></AuctionId>Идентификатор аукциона
<Domain></Domain>Доменное имя аукциона
<BidPrice></BidPrice>Размер текущей ставки аукциона
<BidPriceCurrency></BidPriceCurrency>Валюта ставки
<Bids></Bids>Количество ставок аукциона
<EndTime></EndTime>Время окончания аукциона
<EndTimestamp></EndTimestamp>Дата окончания аукциона в в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
<Revenue></Revenue>Доход с домена
<RevenueCurrency></RevenueCurrency>Валюта дохода
<Visitors></Visitors>Посетители домена
<Links></Links>Внешние ссылки
<Age></Age>Возраст домена
Пример получения списка открытых аукционов
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_open_auctions¤cy=usd
Response (XML format)
<GetOpenAuctionsResponse>
<GetOpenAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenAuctionsHeader>
<GetOpenAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
.
.
.
</GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
Запрос (формат csv)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions¤cy=usd
Ответ
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_open_auctions¤cy=usd
Response (JSON format)
{
"status": "success",
"auction_list": [
{
"auction_id": 11,
"domain": "domain.com",
"utf_name": "domain.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "124.00",
"bids": 4,
"bidders": 2,
"time_left": "1 day, 23 hours",
"start_time": "2022/03/28 02:20 PST",
"start_time_stamp": 1648459234033,
"end_time": "2022/04/04 02:20 PST",
"end_time_stamp": 1649064034033,
"visitors": 223,
"links": "-",
"age": 0,
"estibot_appraisal": "-"
},
{
"auction_id": 12,
"domain": "domain0.com",
"utf_name": "domain0.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "44.99",
"bids": 1,
"bidders": 1,
"time_left": "2 days, 23 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"visitors": 245,
"links": "-",
"age": 0,
"estibot_appraisal": "-"
}
...
]
}
Команда получения подробностей аукциона
Calling the get auction details command will return the details of auction specified. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:
Параметр запроса получения подробностей об аукционеПояснение
Параметр запроса получения подробностей об аукционе
Пояснение
domainThe domain name of auction, IDN(International Domain Name) should use punycode, such as "xn--wkccg.com". you can get more than one auctions , each domain must be split by ","
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>Тег ответа получения подробностей об аукционе, это корневой узел XML-документа ответа
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>Заголовок получения сведений об аукционе отложенных заказов
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Тег содержимого получения подробностей об аукционе, используется только при статусе "success"
<AuctionStatusId></AuctionStatusId>Status id of auction : '0' for In Progress, '1' for Cancelled by User, '2' for Cancelled by Admin, '3' for Cancelled by Renewal, '4' for Complete, '5' for Cancelled by Transfer Away
<AuctionStatus></AuctionStatus>Статус аукциона
<UserIsHighBid></UserIsHighBid>Является ли ставка пользователя самой высокой
<YourCurrentBid></YourCurrentBid>Ваша текущая ставка в указанном аукционе. Если вы не делали ставок, будет передано '-1'
<YourProxyBid></YourProxyBid>Ваша максимальная ставка (proxy bid) в указанном аукционе. Если вы не делали ставок, будет передано '-1' <AuctionId></AuctionId>Идентификатор аукциона
<Domain></Domain>Доменное имя аукциона
<BidPrice></BidPrice>Размер текущей ставки аукциона
<BidPriceCurrency></BidPriceCurrency>Валюта ставки
<Bids></Bids>Количество ставок аукциона
<EndTime></EndTime>Время окончания аукциона
<EndTimestamp></EndTimestamp>Дата окончания аукциона в в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
<IsPremium></IsPremium>Whether it is a premium domain
<RenewalPrice></RenewalPrice>Renewal price
Пример получения подробностей аукциона
Request (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetAuctionDetailsResponse>
<GetAuctionDetailsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionDetailsHeader>
<GetAuctionDetailsContent>
<Auction>
<AuctionStatusId>0</AuctionStatusId>
<AuctionStatus>1</AuctionStatus>
<AuctionId>0</AuctionId>
<Domain>test.biz</Domain>
<BidPrice>46.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>1970/01/01 00:00 UTC</EndTime>
<EndTimestamp>0</EndTimestamp>
<Revenue>1</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>1</Links>
<Age>10</Age>
<isPremium>false</isPremium>
<RenewalPrice>-0.1</RenewalPrice>
<UserIsHighBid>false</UserIsHighBid>
<YourCurrentBid>-1</YourCurrentBid>
<YourProxyBid>-1</YourProxyBid>
</Auction>
</GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
Response (JSON format)
{
"status": "success",
"size": 1,
"auction_details": [
{
"auction_json": {
"auction_id": 0,
"domain": "test.biz",
"utf_name": "test.biz",
"is_idn": false,
"auction_type": "expired",
"current_bid_price": "46.99",
"accepted_bid_price": "46.99",
"currency": "USD",
"is_high_bidder": false,
"bids": 0,
"bidders": 0,
"auction_status_id": 0,
"time_left": "1",
"start_time": "1",
"start_time_stamp": 0,
"end_time": "",
"end_time_stamp": 0,
"revenue": "1",
"visitors": -1,
"links": "1",
"age": 10,
"estibot_appraisal": "",
"bidder_name": "",
"bid_price": "",
"timestamp": 0,
"bid_status": "",
"is_proxy_auto_bid": false,
"auction_ended": false,
"customer_bided": false,
"customer_bid": "1",
"customer_proxy_bid": "1",
"is_premium": false,
"renewal_price": "-0.1"
},
"bid_history": []
}
]
}
Команда регистрации ставки на аукционный лот
Вызов команды регистрацию ставки на аукционный лот оформит ставку на указанный лот аукциона. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса на регистрацию ставки на аукционный лотПояснение
Параметр запроса на регистрацию ставки на аукционный лот
Пояснение
domainДоменное имя аукциона, для IDN (интернационализированные доменные имена) следует использовать пьюникод, например «xn--wkccg.com»
bid_amountСумма вашей ставки для аукциона, валюта по умолчанию — доллар США, вы также можете указать ее с помощью параметра валюты ниже
currency (необязательно)Валюта вашей ставки, она должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<PlaceAuctionBidResponse></PlaceAuctionBidResponse>Тег ответа регистрации ставки, это корневой узел XML-документа ответа
<PlaceAuctionBidHeader></PlaceAuctionBidHeader>Заголовок регистрации ставки
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример домена
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (XML format)
<PlaceAuctionBidResponse>
<PlaceAuctionBidHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
Запрос (формат csv)
https://api.dynadot.com/api3.html?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Ответ
ok,success
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (JSON format)
{
"status": "success",
"auction_details": {
"auction_json": {
"auction_id": 12,
"domain": "example.com",
"utf_name": "example.com",
"is_idn": false,
"auction_type": "expired",
"current_bid_price": "44.99",
"accepted_bid_price": "45.99",
"currency": "USD",
"is_high_bidder": true,
"bids": 3,
"bidders": 2,
"time_left": "2 days, 22 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"revenue": "$26.50",
"visitors": 245,
"links": "-",
"age": 0,
"estibot_appraisal": "-",
"auction_ended": false,
"customer_bided": true,
"customer_bid": "44.99",
"customer_proxy_bid": "$121.00"
},
"bid_history": [
{
"bidder_name": "You",
"bid_price": "44.99",
"currency": "USD",
"timestamp": 1648892255084,
"bid_status": "High Bidder",
"is_proxy_auto_bid": false
}
... ]
}
}
Команда получения закрытых аукционов
Вызов команды получения закрытых аукционов возвращает список закрытых аукционов для указанной учетной записи. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса получения закрытых аукционовПояснение
Параметр запроса получения закрытых аукционов
Пояснение
startDateДата начала аукциона, гггг-мм-дд, например 2015-05-05
endDateДата окончания аукциона, гггг-мм-дд, например 2015-05-05
currency (необязательно)Валюта вашей ставки, она должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>Тег ответа получения закрытых аукционов, это корневой узел XML-документа ответа
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>Заголовок получения закрытых аукционов
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>Тег содержимого получения закрытых аукционов, используется только при статусе "success"
<Auction></Auction>Тег аукционного лота, используется только при статусе "success"
<AuctionId></AuctionId>Идентификатор аукциона
<Domain></Domain>Доменное имя аукциона
<AuctionStatusId></AuctionStatusId>Идентификатор статуса аукциона, «0» — в процессе, «1» — закрыт пользователем, «2» — закрыт администратором, «3» — закрыт из-за продления, «4» — закрыт по истечению времени, «5» — закрыт из-за переноса к другому регистратору
<AuctionStatus></AuctionStatus>Статус аукциона
<BidPrice></BidPrice>Размер текущей ставки аукциона
<BidPriceCurrency></BidPriceCurrency>Валюта ставки
<Bids></Bids>Количество ставок аукциона
<AuctionWonStatus></AuctionWonStatus>Выиграл ли пользователь этот аукцион
<YourHighBid></YourHighBid>Ваша высшая ставка на этом аукционе
<YourProxyBid></YourProxyBid>Ваша прокси-ставка для этих торгов
Пример получения закрытых аукционов
Request (XML format)
https://api.dynadot.com/api3.xml?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedAuctionsResponse>
<GetClosedAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetClosedAuctionsHeader>
<GetClosedAuctionsContent>
<Auction>
<AuctionId>2</AuctionId>
<Domain>testdomain1.test</Domain>
<AuctionStatusId>4</AuctionStatusId>
<AuctionStatus>Closed by Timeout</AuctionStatus>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>89.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
</Auction>
<Auction>
<AuctionId>3</AuctionId>
<Domain>testdomain2.test</Domain>
<AuctionStatusId>4</AuctionStatusId>
<AuctionStatus>Closed by Timeout</AuctionStatus>
<BidPrice>28.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>28.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
</Auction>
</GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
Request (CSV format)
https://api.dynadot.com/api3.html?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (CSV format)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
Request (JSON format)
https://api.dynadot.com/api3.json?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (JSON format)
{
"GetClosedAuctionsResponse": {
"ResponseCode": 0,
"Status": "success",
"Auctions": [
{
"AuctionId": "2",
"Domain": "testdomain1.test",
"AuctionStatusId": "4",
"AuctionStatus": "Closed by Timeout",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"AuctionWonStatus": "won",
"YourHighBid": "89.99",
"YourProxyBid": "1000.0"
},
{
"AuctionId": "3",
"Domain": "testdomain2.test",
"AuctionStatusId": "4",
"AuctionStatus": "Closed by Timeout",
"BidPrice": "28.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"AuctionWonStatus": "won",
"YourHighBid": "28.99",
"YourProxyBid": "1000.0"
}
]
}
}
Команда получения открытых аукционов по отложенным заказам(Deprecated,please use get_open_auctions command)
Вызов команды получения открытых аукционов по отложенным заказам возвращает список активных аукционов по отложенным заказам. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса получения открытых аукционов по отложенным заказамПояснение
Параметр запроса получения открытых аукционов по отложенным заказам
Пояснение
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>Тег ответа получения открытых торгов по отложенным заказам, это корневой узел XML-документа ответа
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>Заголовок получения открытых аукционов по отложенным заказам
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>Тег содержимого получения открытых торгов по отложенным заказам, используется только при статусе "success"
<Auction></Auction>Тег аукционного лота, используется только при статусе "success"
<AuctionId></AuctionId>Идентификатор аукциона
<Domain></Domain>Доменное имя аукциона
<BidPrice></BidPrice>Размер текущей ставки аукциона
<BidPriceCurrency></BidPriceCurrency>Валюта ставки
<Bids></Bids>Количество ставок аукциона
<EndTime></EndTime>Время окончания аукциона
<EndTimestamp></EndTimestamp>Дата окончания аукциона в в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
Пример получения открытых аукционов по отложенным заказам
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_open_backorder_auctions¤cy=usd
Response (XML format)
<GetOpenBackorderAuctionsResponse>
<GetOpenBackorderAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenBackorderAuctionsHeader>
<GetOpenBackorderAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
</Auction>
.
.
.
</GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
Запрос (формат csv)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_backorder_auctions¤cy=usd
Ответ
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp
10000,backorder0.com,6.35,USD,0,2017/08/29 17:53 UTC,1504029194453
10001,backorder1.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
10002,backorder2.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
.
.
.
Команда получения сведений об аукционе по отложенному заказу
Calling the get backorder auction details command will return the details of auction specified. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:
Параметр запроса получения подробностей об аукционеПояснение
Параметр запроса получения подробностей об аукционе
Пояснение
domainДоменное имя аукциона по отложенному заказу, для IDN (интернационализированные доменные имена) следует использовать пьюникод, например «xn--wkccg.com»
currency (необязательно)Валюта возвращаемого ответа, должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>Тег ответа получения подробностей об аукционе, это корневой узел XML-документа ответа
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>Заголовок ответа получения подробностей об аукционе
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Тег содержимого получения подробностей об аукционе, используется только при статусе "success"
<AuctionStatusId></AuctionStatusId>Идентификатор статуса аукциона, «0» — в процессе, «1» — закрыт пользователем, «2» — закрыт администратором, «3» — закрыт из-за продления, «4» — закрыт по истечению времени, «5» — закрыт из-за переноса к другому регистратору
<AuctionStatus></AuctionStatus>Статус аукциона
<AuctionId></AuctionId>Идентификатор аукциона
<Domain></Domain>Доменное имя аукциона
<BidPrice></BidPrice>Размер текущей ставки аукциона
<BidPriceCurrency></BidPriceCurrency>Валюта ставки
<Bids></Bids>Количество ставок аукциона
<EndTime></EndTime>Время окончания аукциона
<EndTimestamp></EndTimestamp>Дата окончания аукциона в в формате времени Unix (в миллисекундах с полуночи UTC 1 января 1970 года)
<Revenue></Revenue>Доход с домена
<RevenueCurrency></RevenueCurrency>Валюта дохода
<Visitors></Visitors>Посетители домена
<Links></Links>Внешние ссылки
<Age></Age>Возраст домена
<UserIsHighBid></UserIsHighBid>Является ли ставка пользователя самой высокой
<YourCurrentBid></YourCurrentBid>Ваша текущая ставка в указанном аукционе. Если вы не делали ставок, будет передано '-1'
<YourProxyBid></YourProxyBid>Ваша максимальная ставка (proxy bid) в указанном аукционе. Если вы не делали ставок, будет передано '-1' Пример получения сведений об аукционе по отложенному заказу
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_backorder_auction_details&domain=example.com¤cy=usd
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetBackorderAuctionDetailsResponse>
<GetBackorderAuctionDetailsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetBackorderAuctionDetailsHeader>
<GetBackorderAuctionDetailsContent>
<AuctionStatusId>0</AuctionStatusId>
<AuctionStatus>In Progress</AuctionStatus>
<UserIsHighBid>no</UserIsHighBid>
<YourCurrentBid>-1</YourCurrentBid>
<YourProxyBid>-1</YourProxyBid>
<Auction>
<AuctionId>10001</AuctionId>
<Domain>example.com</Domain>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 18:16 UTC</EndTime>
<EndTimestamp>1430244969779</EndTimestamp>
</Auction>
</GetBackorderAuctionDetailsContent>
</GetBackorderAuctionDetailsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_backorder_auction_details&domain=example.com¤cy=usd
Response (JSON format)
{
"GetBackorderAuctionDetailsResponse": {
"ResponseCode": 0,
"Status": "success",
"GetBackorderAuctionDetails": {
"AuctionStatusId": "0",
"AuctionStatus": "In Progress",
"UserIsHighBid": "no",
"YourCurrentBid": "-1",
"YourProxyBid": "-1",
"Auction": {
"AuctionId": "10001",
"Domain": "example.com",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "0",
"EndTime": "2015/04/28 18:16 UTC",
"EndTimestamp": "1430244969779"
}
}
}
}
Команда размещения ставки на аукционе отложенных заказов
Вызов команды размещения ставки на аукционе по отложенным заказам приведет к размещению ставки на указанных торгах по отложенному заказу. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса размещения ставки на аукционе по отложенному заказуПояснение
Параметр запроса размещения ставки на аукционе по отложенному заказу
Пояснение
domainДоменное имя аукциона, для IDN (интернационализированные доменные имена) следует использовать пьюникод, например «xn--wkccg.com»
bid_amountСумма вашей ставки для аукциона, валюта по умолчанию — доллар США, вы также можете указать ее с помощью параметра валюты ниже
currency (необязательно)Валюта вашей ставки, она должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<PlaceBakcorderAuctionBidResponse></PlaceBakcorderAuctionBidResponse>Тег ответа регистрации ставки, это корневой узел XML-документа ответа
<PlaceBackorderAuctionBidHeader></PlaceBackorderAuctionBidHeader>Заголовок регистрации ставки
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
Пример размещения ставки на аукционе отложенных заказов
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (XML format)
<PlaceBakcorderAuctionBidResponse>
<PlaceBackorderAuctionBidHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
Request (CSV format)
https://api.dynadot.com/api3.html?key=mykey&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (CSV format)
ok,success
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (JSON format)
{
"PlaceBakcorderAuctionBidResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Команда получения закрытых аукционов по отложенным заказам
Вызов команды получения закрытых аукционов по отложенным заказам возвращает список закрытых аукционов по отложенным заказам для указанной учетной записи. При вызове этой команды должны быть указаны следующие параметры:
Параметр запроса получения закрытых аукционов по отложенным заказамПояснение
Параметр запроса получения закрытых аукционов по отложенным заказам
Пояснение
startDateДата начала аукциона, гггг-мм-дд, например 2015-05-05
endDateДата окончания аукциона, гггг-мм-дд, например 2015-05-05
currency (необязательно)Валюта вашей ставки, она должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>Тег ответа получения закрытых аукционов, это корневой узел XML-документа ответа
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>Заголовок получения закрытых аукционов
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>Тег содержимого получения закрытых аукционов, используется только при статусе "success"
<Auction></Auction>Тег аукционного лота, используется только при статусе "success"
<YourHighBid></YourHighBid>Ваша высшая ставка на этом аукционе
<YourProxyBid></YourProxyBid>Ваша прокси-ставка для этих торгов
<AuctionId></AuctionId>Идентификатор аукциона
<Domain></Domain>Доменное имя аукциона
<AuctionStatusId></AuctionStatusId>Идентификатор статуса аукциона, «0» — в процессе, «1» — закрыт пользователем, «2» — закрыт администратором, «3» — закрыт из-за продления, «4» — закрыт по истечению времени, «5» — закрыт из-за переноса к другому регистратору
<AuctionStatus></AuctionStatus>Статус аукциона
<BidPrice></BidPrice>Размер текущей ставки аукциона
<BidPriceCurrency></BidPriceCurrency>Валюта ставки
<Bids></Bids>Количество ставок аукциона
Get Closed Backorder Auctions Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedBackorderAuctionsResponse>
<GetClosedBackorderAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetClosedBackorderAuctionsHeader>
<GetClosedBackorderAuctionsContent>
<Auction>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>89.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
<AuctionId>2</AuctionId>
<Domain>testdomain1.test</Domain>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Auction>
<Auction>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>28.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
<AuctionId>3</AuctionId>
<Domain>testdomain2.test</Domain>
<BidPrice>28.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Auction>
</GetClosedBackorderAuctionsContent>
</GetClosedBackorderAuctionsResponse>
Request (CSV format)
https://api.dynadot.com/api3.html?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (CSV format)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
Request (JSON format)
https://api.dynadot.com/api3.json?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (JSON format)
{
"GetClosedBackorderAuctionsResponse": {
"ResponseCode": 0,
"Status": "success",
"Auctions": [
{
"AuctionWonStatus": "won",
"YourHighBid": "89.99",
"YourProxyBid": "1000.0",
"AuctionId": "2",
"Domain": "testdomain1.test",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"EndTime": "2022/04/04 02:20:34 PST",
"EndTimestamp": "1649064034033"
},
{
"AuctionWonStatus": "won",
"YourHighBid": "28.99",
"YourProxyBid": "1000.0",
"AuctionId": "3",
"Domain": "testdomain2.test",
"BidPrice": "28.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"EndTime": "2022/04/05 02:20:34 PST",
"EndTimestamp": "1649150434049"
}
]
}
}
Команда получения ставок по лоту
Calling the get auction bids command will get your bids list which you took part in. If calling this command, the following parameters should be included:
Get Auction Bids Request ParameterПояснение
Get Auction Bids Request Parameter
Пояснение
currency (необязательно)Валюта вашей ставки, она должна быть "usd", "eur", или "cny", по умолчанию — доллар США
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetAuctionBidsResponse></GetAuctionBidsResponse>Tag of get auction bids response, it's the root node of the response XML document
<GetAuctionBidsHeader></GetAuctionBidsHeader>Get auction bids header
<SuccessCode></SuccessCode>Успешность выполнения операции: "0" при успехе, "-1" при неудаче
<Status></Status>Статус запроса
<Error></Error>Информация об ошибке, используется при статусе "error"
<GetAuctionBidsContent></GetAuctionBidsContent>Tag of get auction bids content, it's only used when status is "success"
<BidList></BidList> Bid List
<Bid></Bid> Bid Item
<BidId></BidId> ID of bid
<AuctionId></AuctionId> ID of auction
<AccountId></AccountId>ID of account
<Domain></Domain>Доменное имя аукциона
<DomainUtf></DomainUtf>Domain utf name of auction
<AuctionType></AuctionType>Type of auction
<IsIdn></IsIdn>If this domain is Internationalized Domain Name
<CurrentBid></CurrentBid>Current bid price for the auction
<YourStatus></YourStatus>Your bid status for the auction
<ProxyBid></ProxyBid>Your proxy bid price for the auction
<ActiveBidders></ActiveBidders>The amount of bidders who take part in this auction
<TimeLeft></TimeLeft>the left time for the auction
<EndTime></EndTime>The end time for the auction
<EndTimestamp></EndTimestamp>The end time stamp for the auction
Пример получения ставок аукционного лота
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=get_auction_bids&currency=usd
Response (XML format)
<GetAuctionBidsResponse>
<GetAuctionBidsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionBidsHeader>
<GetAuctionBidsContent>
<BidList>
<Bid>
<BidId>0</BidId>
<AuctionId>11</AuctionId>
<AccountId>1</AccountId>
<Domain>domain.com</Domain>
<DomainUtf>domain.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$124.00</CurrentBid>
<YourStatus>Out Bid</YourStatus>
<ProxyBid>$119.00</ProxyBid>
<ActiveBidders>2</ActiveBidders>
<TimeLeft>1 day, 6 hours</TimeLeft>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Bid>
<Bid>
<BidId>9</BidId>
<AuctionId>12</AuctionId>
<AccountId>1</AccountId>
<Domain>domain0.com</Domain>
<DomainUtf>domain0.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$44.99</CurrentBid>
<YourStatus>High Bidder</YourStatus>
<ProxyBid>$121.00</ProxyBid>
<ActiveBidders>1</ActiveBidders>
<TimeLeft>2 days, 6 hours</TimeLeft>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Bid>
</BidList>
</GetAuctionBidsContent>
</GetAuctionBidsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=mykey&command=get_auction_bids&currency=usd
Response (JSON format)
{
"status": "success",
"auction_bids": [
{
"bid_id": 0,
"auction_id": 11,
"account_id": "1",
"domain": "domain.com",
"domain_utf": "domain.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "1 day, 23 hours",
"end_time": "2022/04/04 02:20:34 PST",
"end_time_stamp": 1649064034033
},
{
"bid_id": 2,
"auction_id": 12,
"account_id": "1",
"domain": "domain0.com",
"domain_utf": "domain0.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "2 days, 23 hours",
"end_time": "2022/04/05 02:20:34 PST",
"end_time_stamp": 1649150434049
}
...
]
}
Команда Is Processing
Вызов команды is_processing сообщит вам, можно ли отправить новый запрос
Параметр запроса is-processingПояснение
Параметр запроса is-processing
Пояснение
дополнительных параметров не требуется
XML-тег результатаПояснение
XML-тег результата
Пояснение
<Response></Response>Тег ответа is_processing
<RespnseHeader></RespnseHeader>Тег заголовка is_processing
<ResponseMsg></ResponseMsg>Тег сообщения ответа is_processing. Должен быть «yes» (В системе запущен процесс. Не следует отправлять еще один запрос.) или «no» (Нет процессов для вашей учетной записи. Можно отправить новый запрос.)
Пример is-processing
Request (XML format)
https://api.dynadot.com/api3.xml?key=mykey&command=is_processing
Response (XML format)
<Response>
<ResponseHeader>
<ResponseCode>0</ResponseCode>
<ResponseMsg>yes</ResponseMsg>
</ResponseHeader>
</Response>
Request (CSV format)
http://api.dynadot.com/api3.html?key=mykey&command=is_processing
Response (CSV format)
ok,yes
Request (JSON format)
http://api.dynadot.com/api3.html?key=mykey&command=is_processing
Response (JSON format)
{
"Response":{
"ResponseCode":"0",
"ResponseMsg":"no"
}
}
Get Expired Closeout Domains Command
Calling the Get Expired Closeout Domains Command will Get Expired Closeout Domains. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:
Get Expired Closeout Domains Request ParameterПояснение
Get Expired Closeout Domains Request Parameter
Пояснение
currency(optional)The currency of return result, it should be "usd", "eur", or "cny", default currency is US Dollars
domain(optional)Add this parameter if you want to query for a closeout domain
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>Tag of Get Expired Closeout Domains response, it's the root node of the response XML document
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>Get Expired Closeout Domains Header
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure
<Status></Status>Статус запроса
<Error></Error>Error information about the request, only used when status is "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>Tag of content, it's only used when status is "success"
<CloseoutItem></CloseoutItem>CloseoutItem
<DomainName></DomainName>The domain name
<DomainNameUtf></DomainNameUtf>The domain name is in utf format
<CurrentPrice></CurrentPrice>current price
<isIdn></isIdn>Whether it is the idn domain name
<EndTimeStamp></EndTimeStamp>End date of auction in Unix time (milliseconds since midnight UTC of January 1, 1970)
<RenewalPrice></RenewalPrice>Renewal price
<ExpiredRevenue></ExpiredRevenue>Revenue of closeout
<EstibotAppraisal></EstibotAppraisal>EstibotAppraisal
<InboundLinks></InboundLinks>Внешние ссылки
<MonthlyVisitors></MonthlyVisitors>Посетители домена
<Currency></Currency>currency
Get Expired Closeout Domains Example
Request (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
<GetExpiredCloseoutDomainsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetExpiredCloseoutDomainsHeader>
<GetExpiredCloseoutDomainsContent>
<CloseoutItem>
<DomainName>test.biz</DomainName>
<DomainNameUtf>test.biz</DomainNameUtf>
<CurrentPrice>9.91</CurrentPrice>
<IsIDN>false</IsIDN>
<EndTimeStamp>0</EndTimeStamp>
<RenewalPrice>9.99</RenewalPrice>
<ExpiredRevenue>9.90</ExpiredRevenue>
<EstibotAppraisal>1223</EstibotAppraisal>
<InboundLinks>-1</InboundLinks>
<MonthlyVisitors>-1</MonthlyVisitors>
<Currency>usd</Currency>
</CloseoutItem>
</GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
Response (JSON format)
{
"GetExpiredCloseoutDomainsResponse": {
"ResponseCode": 0,
"Status": "success",
"Size": 1,
"CloseoutDomains": [
{
"closeoutItem": {
"domainName": "test.biz",
"domainNameUtf": "test.biz",
"currentPrice": "9.91",
"isIdn": false,
"endTimeStamp": 0,
"renewalPrice": "9.99",
"expiredRevenue": "9.90",
"estibotAppraisal": "1223",
"inboundLinks": -1,
"monthlyVisitors": -1,
"currency": "usd"
}
}
]
}
}
Buy Expired Closeout Domain Command
Calling the Buy Expired Closeout Domain Command will buy the specified domain name. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:
Buy Expired Closeout Domain Request ParameterПояснение
Buy Expired Closeout Domain Request Parameter
Пояснение
domainThe domain you want to buy, only 1 domain can be entered per request
currency(optional)The currency of return result, it should be "usd", "eur", or "cny", default currency is US Dollars
XML-тег результатаПояснение
XML-тег результата
Пояснение
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>Tag of Buy Expired Closeout Domain response, it's the root node of the response XML document
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>Buy Expired Closeout Domain header
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure
<Status></Status>Статус запроса
<Error></Error>Error information about the request, only used when status is "error"
Buy Expired Closeout Domain Example
Request (XML format)
http://127.0.0.1:8889/api3.xml?key=0&command=buy_expired_closeout_domain¤cy=USD&domain=domain-exp141.org.ph
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
<BuyExpiredCloseoutDomainHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
Request (JSON format)
http://127.0.0.1:8889/api3.json?key=0&command=buy_expired_closeout_domain¤cy=USD&domain=domain-exp141.org.ph
Response (JSON format)
{
"BuyExpiredCloseoutDomainResponse": {
"ResponseCode": "0",
"Status": "success"
}
}
Get Order Status Command
Calling the Get Order Status Command will get order status. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:
Get Order Status Request ParameterПояснение
Get Order Status Request Parameter
Пояснение
order_idThe id of the order to be queried
XML-тег результатаПояснение
XML-тег результата
Пояснение
<GetOrderStatusResponse></GetOrderStatusResponse>the root node of the response
<GetOrderStatusHeader></GetOrderStatusHeader>Get Order Status header
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure
<Status></Status>Статус запроса
<Error></Error>Error information about the request, only used when status is "error"
<GetOrderStatusContent></GetOrderStatusContent>response content
<OrderId></OrderId>order id
<OrderStatus></OrderStatus>order status( Shopping, Submitted,
Waitpay, Processing, Completed, Problem, Deleted, Cancelled )
<ItemTypeName></ItemTypeName>item Type
<ItemName></ItemName>item Name
<ItemStatus></ItemStatus>Item Status(Completed, Cancelled, Problem)
Get Order Status Example
Request (XML format)
http://127.0.0.1:8889/api3.xml?key=0&command=get_ordedr_status&order_id=0
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetOrderStatusResponse>
<GetOrderStatusHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetOrderStatusHeader>
<GetOrderStatusContent>
<OrderId>0</OrderId>
<OrderStatus>Completed</OrderStatus>
<Item>
<ItemTypeName>domain transfer away</ItemTypeName>
<ItemName>&</ItemName>
<ItemStatus>transfer.com</ItemStatus>
</Item>
<Item>
<ItemTypeName>domain</ItemTypeName>
<ItemName>&</ItemName>
<ItemStatus>register.com</ItemStatus>
</Item>
</GetOrderStatusContent>
</GetOrderStatusResponse>
Request (JSON format)
http://127.0.0.1:8889/api3.json?key=0&command=get_ordedr_status&order_id=0
Response (JSON format)
{
"GetOrderStatusResponse": {
"ResponseCode": 0,
"Status": "success",
"OrderStatus": {
"OrderId": 0,
"OrderStatus": "Completed",
"ItemList": [
{
"ItemTypeName": "domain transfer away",
"ItemName": "transfer.com",
"ItemStatus": "Completed"
},
{
"ItemTypeName": "domain",
"ItemName": "register.com",
"ItemStatus": "Completed"
}
]
}
}
}