关于Dynadot
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在了具体的功能API代码前,请阅读关于Dynadot的API使用须知。
对于域名投资人来说,域名在不同平台的转移是非常常见的。这种行为被统称为域名转移,这样的转移不仅发生在一个人的不同域名管理平台的不同账户中;也可能发生在两个不同的域名投资人之间,比如两个人私下发生了交易,一方也是通过域名转移的方式将域名转移到对方的账户中。
注意:发生在不同平台之间的域名转移,会有一个专有的转移代码以供授权。
相关参数
使用Dynadot的API进行域名转移,一次可以实现单个域名的转移。调用转移命令将创建和处理转移订单。部分tld可能会要求失去域名的注册人确认后才能完成订单。
转移命令参数
如果要发送转移命令时,需要包含必要的字段以及根据需求可选的字段。
参数表如以下表格所示:
转移请求参数 | 解释 |
domain | 您想要转移到Dynadot中的域名,每一次请求只可以转移1个域名 |
auth | 转移请求授权代码。 |
currency (可选) | 您可以决定货币类型且支持此参数的是"USD"、"CNY"、"GBP"、"EUR"、"INR"、"CAD"等等。如果您没有设定此参数,我们将使用账户的默认货币 |
registrant_contact (可选) | 您希望在转移完成后使用的注册联系人。(不是所有TLD都支持此功能) |
admin_contact (可选) | 您希望在转移完成时使用的管理联系人。(不是所有的顶级域都支持此功能) |
technical_contact (可选) | 在转移完成时要使用的技术联系人。(不是所有TLD都支持此功能) |
billing_contact (可选) | 转移完成后要使用的账单联系人。(不是所有TLD都支持此功能) |
coupon (可选) | 您希望用于此命令的优惠代码 |
在成功发送转移命令之后,返回的结果将以XML或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 | 解释 |
<TransferResponse></TransferResponse> | 转移响应标签,这是响应XML文档的根节点 |
<TransferHeader></TransferHeader> | 转移头部 |
<SuccessCode></SuccessCode> | 如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> | 请求状态 |
<Error></Error> | 请求错误信息,仅状态为"error"时使用 |
示例
此处,使用API进行域名跨平台转移的命令,域名为domain1.com,授权码为testauth,结算币种为美元,优惠码为testcoupon。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
则最后返回的参数为:
请求(XML格式)
https://api.dynadot.com/api3.xml?key=mykey&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
响应(XML格式)
<TransferResponse><TransferHeader><SuccessCode>0</SuccessCode><Status>order created</Status></TransferHeader></TransferResponse>
以同样的推送命令为例,JSON格式的为:
请求(JSON格式)
https://api.dynadot.com/api3.json?key=mykey&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
响应(JSON格式)
{"TransferResponse":{"ResponseCode":"0","Status":"order created","DomainName":"domian1.com"}}
在网页中,其显示样式如下:(示例为实际操作,失败的返回结果展示。在网页中会显示转移失败原因。)
XML格式
JSON格式