关于Dynadot
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在了具体的功能API代码前,请阅读关于Dynadot的API使用须知。
当平台中的域名过多时,管理人通常会使用域名分类夹管理域名,当文件夹过多时,可以使用DynadotAPI查询目前存在的文件夹列表,同时会显示文件夹的设置。
命令参数
如果要发送查询域名文件夹列表命令时,无需额外参数。
在成功发送查询文件夹列表命令之后,返回的结果将以XML或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 |
解释 |
<FolderListHeader></FolderListHeader> |
响应标头 |
<SuccessCode></SuccessCode> |
如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> |
请求状态 |
<Error></Error> |
请求错误信息,仅状态为"error"时使用 |
<FolderListContent></FolderListContent> |
响应内容 |
<FolderList></FolderList> |
文件夹列表 |
<List></List> |
|
<Folder></Folder> |
|
<FolderId></FolderId> |
文件夹ID |
<FolderName></FolderName> |
文件夹名称 |
<DefaultWhois></DefaultWhois> |
默认Whois |
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus> |
默认Whois启用状态 |
<DefaultRegistrant></DefaultRegistrant> |
默认注册人 |
<ContactId></ContactId> |
联络人ID |
<DefaultAdmin></DefaultAdmin> |
默认管理员 |
<DefaultTechnical></DefaultTechnical> |
默认技术信息 |
<DefaultBilling></DefaultBilling> |
默认账单信息 |
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus> |
默认域名服务器启用状态 |
<NameServerSettings></NameServerSettings> |
域名服务器设置 |
<Type></Type> |
域名服务器类型 |
<WithAds></WithAds> |
是否带有广告 |
<DefaultRenewOption></DefaultRenewOption> |
默认续费选项 |
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus> |
默认续费启用状态 |
<RenewOption></RenewOption> |
续费选项 |
<DefaultTransferLock></DefaultTransferLock> |
默认转移锁定 |
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus> |
默认转移锁定启用状态 |
<LockStatus></LockStatus> |
锁定状态 |
示例
此处,使用API发送查询文件夹列表命令
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
则最后返回的参数为:
请求(XML格式)
https://api.dynadot.com/api3.xml?key=mykey&command=folder_list
响应(XML格式)
<?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>
请求(JSON格式)
https://api.dynadot.com/api3.json?key=mykey&command=folder_list
响应(JSON格式)
{
"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"
}
}
]
}
}
在网页中,其显示样式如下:(示例为实际操作。)
XML格式
JSON格式