使用API有效率地管理Dynadot域名，使用API进行域名续费

关于Dynadot

Dynadot是通过ICANN认证的域名注册商，自2002年成立以来，服务于全球108个国家和地区的客户，为数以万计的客户提供简洁，优惠，安全的域名注册以及管理服务。

Dynadot平台操作教程索引（包括域名邮箱，解析，建站，优惠长期更新）

Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上，我们提供了50多个命令来设置，管理，注册和竞标域名。

在了具体的功能API代码前，请阅读关于Dynadot的API使用须知。

域名续费为域名市场的常见操作之一。在第一次进行域名注册时，可以选择的持有时长为一到五年。如果想要持有更长时间，则需要在域名过期之前完成续费的操作。

相关参数

使用Dynadot的API，可以实现关于域名的一年至多年续费。（注意账户中须由足够余额支付订单。）

续费命令参数

如果要发送续费命令时，需要包含必要的字段以及根据需求可选的字段。

必要的参数有包括顶级域在内的域名全称，以及该续费的时长。（该域名需要续费几年。）参数表如以下表格所示：

续费请求参数	解释
domain	您想续费的域名，每个请求仅可续费1个域名
duration	需要为域名续费多少年
year (可选)	域名过期的当前年份
currency (可选)	您可以决定货币类型且支持此参数的是"USD"、"CNY"、"GBP"、"EUR"、"INR"、"CAD"等等。如果您没有设定此参数，我们将使用账户的默认货币
price_check (可选)	您可以将此参数添加到命令中，查看更新此域名的详细价格信息。注意：添加这个参数到命令中，我们的api将不会更新域名，而只显示价格信息。
coupon (可选)	您希望用于此命令的优惠代码
no_renew_if_late_renew_fee_needed (可选)	如果域名需要缴纳滞纳费才能续订，则可以将此参数添加到命令中以避免续订。如果域名需要缴纳滞纳费才能续订，并且在命令中传递了“ no_renew_if_late_renew_fee_needed = 1”，则该域名将不会续订。

结果返回参数

在成功发送域名续费命令之后，返回的结果将以XML或是JSON格式的标签返回，其中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时间计的过期日期（毫秒，自1970年1月1日午夜起），仅结果为"success"时使用

示例

此处，使用API发送域名续费命令，续费域名domain1.com一年，以美元结算并使用优惠码testcoupon。

将高级域API请求发送到以下URL：https://api.dynadot.com/api3.xml。

则最后返回的参数为：

请求（XML格式）

https://api.dynadot.com/api3.xml?key=mykey&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon

响应（XML格式）

<RenewResponse>

  <RenewHeader>

    <SuccessCode>0</SuccessCode>

    <Status>success</Status>

  </RenewHeader>

  <RenewContent>

    <Expiration>73984579834</Expiration>

  </RenewContent>

</RenewResponse>

可见该域名已经成功注册，过期时间为1972-05-06 15:16:19（经由Unix时间转换。）

同时，我们也可以以JSON格式来发送域名注册命令，此时需要将命令发送至https://api.dynadot.com/api3.json。

以同样的续费请求为例：

请求（JSON格式）

https://api.dynadot.com/api3.json?key=mykey&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon

响应（JSON格式）

{

   "RenewResponse":{

      "ResponseCode":"0",

      "Status":"success",

      "DomainName":"domian1.com",

      "Expiration":"73984579834"

   }

}

在网页中，其显示样式如下：（示例为实际操作，因余额不足续费失败的返回结果展示。）

XML格式

JSON格式