使用API有效率地管理Dynadot域名，使用API进行域名平台内转移（Push）命令

关于Dynadot

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

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

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

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

在Dynadot平台中，域名的在同平台内不同账户之间的转移被称为Push，因此也被称为域名推送。

注意：调用push命令将创建和处理一个push订单。您必须为订单解锁您的域名和帐户。接收人账户必须拒绝/接受域名才能完成订单。

相关参数

使用Dynadot的API进行域名推送，可以实现关于单个或多个域名的推送。

推送命令参数

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

参数表如以下表格所示：

Push请求参数	解释
domain	您想要推送的域名。我们还支持批量推送，您可以使用“;”来分割域名。例子：domain1.com;domain2.com
receiver_push_username	输入收件人帐户的用户名
currency (可选)	您可以决定货币类型且支持此参数的是"USD"、"CNY"、"GBP"、"EUR"、"INR"、"CAD"等等。如果您没有设定此参数，我们将使用账户的默认货币
unlock_domain_for_push(optional)	将此参数设为等于“1”。如果域名被锁定，我们将自动对其解锁，您将无需手动解锁域名

返回参数

在成功发送推送命令之后，返回的结果将以XML或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
	ush响应标签，这是响应XML文档的根节点
	Push头部
	如果操作成功，"0"为成功，"-1"为失败
	请求状态
	请求错误信息，仅状态为"error"时使用

示例

此处，使用API发送域名推送命令，推送域名为domain1.com，接收域名的账户为username，结算货币为美元。

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

则最后返回的参数为：

请求（XML格式）

https://api.dynadot.com/api3.xml?key=mykey&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD

响应（XML格式）

  

    0

    order created

  

以同样的推送命令为例，JSON格式的为：

请求（JSON格式）

https://api.dynadot.com/api3.json?key=mykey&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD

响应（JSON格式）

{

   "PushResponse":{

      "ResponseCode":"0",

      "Status":"order created"

   }

}

在网页中，其显示样式如下：（示例为实际操作，失败的返回结果展示。在网页中会显示删除失败原因。）

网页XML格式

网页JSON格式