关于Dynadot
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在了具体的功能API代码前,请阅读关于Dynadot的API使用须知。
域名注册撤回(宽限删除)
Dynadot是为数不多的支持宽限删除,亦称域名试用的注册商之一,注册人可“撤回”不想要域名的注册请求。这样的话您就能“试用”域名,测试其流量,或试试看这个域名到底合适不合适。
注意:不是所有的域名扩展都允许域名宽限删除,且允许宽限删除的域名域名期在2-5天。
部分顶级域对域名宽限删除数量有上限设置,超过可能无法保证成功,
在Dynadot,.com/.net以及.org等多个顶级域名支持域名宽限删除。
相关参数
使用Dynadot的API进行域名宽限期删除,可以实现关于单个域名的注册撤回。(无法批量进行,且账户中应当有足以支付删除费用的额度。)
删除命令参数
如果要发送删除命令时,需要包含必要的字段以及根据需求可选的字段。
参数表如以下表格所示:
删除请求参数 | 解释 |
domain | 您想删除的域名,每次请求仅可删除1个域名 |
返回结果参数
在成功发送删除命令之后,返回的结果将以XML或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 | 解释 |
<DeleteResponse></DeleteResponse> | 删除响应标签 |
<DeleteHeader></DeleteHeader> | 删除标头标签 |
<SuccessCode></SuccessCode> | 如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> | 请求状态 |
<Error></Error> | 请求错误信息,仅状态为"error"时使用 |
示例
此处,使用API发送域名删除命令,删除域名为domain1.com。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
则最后返回的参数为:
请求(XML格式)
https://api.dynadot.com/api3.xml?key=mykey&command=delete&domain=domain1.com
响应(XML格式)
<DeleteResponse>
<DeleteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteHeader>
</DeleteResponse>
以同样的删除命令为例,JSON格式的为:
请求(JSON格式)
https://api.dynadot.com/api3.json?key=mykey&command=delete&domain=domain1.com
响应(JSON格式)
{
"DeleteResponse":{
"ResponseCode":"0",
"Status":"success",
"DomainName":"domain1.com",
}
}
在网页中,其显示样式如下:(示例为实际操作,失败的返回结果展示。在网页中会显示删除失败原因。)
XML格式
JSON格式