关于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
<?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格式)
XML
{
"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格式