使用API有效率地管理Dynadot域名，使用API进行域名注册

关于Dynadot

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

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

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

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

相关参数

域名注册是Dynadot所提供的域名服务之一，也是Dynadot的主营业务。截止至2024年，Dynadot一共提供包括二级域在内的508个域名尾缀的注册以及续费服务。

使用Dynadot的API，可以轻松实现关于域名的单个注册。（注意：批量注册有其他命令，账户中须由足够余额支付订单。）

注册命令参数

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

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

注册请求参数	解释
domain	您想注册的域名，每个请求仅可注册1个域名
language (可选)	被请求域名的语言标签，仅国际化域名需要
duration	注册所需的时长
registrant_contact (可选)	您想在域上使用的注册联系人
admin_contact (可选)	您想在域上使用的管理员联系人
technical_contact (可选)	您想在该域上使用的技术联系人
billing_contact (可选)	您希望在域名上使用的账单联系人
option0 (如果必要)	.AT, .BE,注册人姓名
option1 (如果必要)	.AT, .BE,注册组织（可选）对于.AT，您可指定为option0, option1,，或两者同时指定
premium (可选)	如果您要注册一个高级域名，将其设为等于"1"（可选）
currency (可选)	您可以决定货币类型且支持此参数的是"USD"、"CNY"、"GBP"、"EUR"、"INR"、"CAD"等等。如果您没有设定此参数，我们将使用账户的默认货币。
coupon (可选)	您希望用于此命令的优惠代码

结果返回参数

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

XML结果标签	解释
<RegisterResponse></RegisterResponse>	注册响应标签
<RegisterHeader></RegisterHeader>	注册标头标签
<SuccessCode></SuccessCode>	如果操作成功，"0"为成功，"-1"为失败
<Status></Status>	请求状态
<Error></Error>	请求错误信息，仅状态为"error"时使用
<RegisterContent></RegisterContent>	注册内容标签
<Expiration></Expiration>	以Unix时间计的过期日期（毫秒，自1970年1月1日午夜起），仅结果为"success"时使用
<Registration></Registration>	以Unix时间计的注册日期（毫秒，自1970年1月1日午夜起），仅结果为"success"时使用

示例

此处，使用API发送域名注册命令，注册domain1.net，注册3年的持有期，并以美元结算。

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

则最后返回的参数为：

请求（XML格式）

https://api.dynadot.com/api3.xml?key=mykey&command=register&domain=domain1.net&duration=3¤cy=USD

响应（XML格式）

<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>

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

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

以同样的搜索请求为例：

请求（JSON格式）

https://api.dynadot.com/api3.json?key=mykey&command=register&domain=domain1.net&duration=3¤cy=USD

响应（JSON格式）

{

???"RegisterResponse":{

??????"ResponseCode":"0",

??????"Status":"success",

??????"DomainName":"domain1.net",

??????"Expiration":"1458379145266"

???}

}

在网页中，其显示样式如下：

示例为实际操作，因余额不足注册失败的返回结果展示。

XML格式

JSON格式