关于Dynadot
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在了具体的功能API代码前,请阅读关于Dynadot的API使用须知。
当对域名有大量需求时(这种情况通常发生在对同一顶级域名较为看好的情况下),域名的批量注册功能将会极大的减少中间重复的注册操作。
相关参数
使用Dynadot的API,可以实现域名的批量注册(command:bulk_register)。
批量注册命令参数
如果要发送批量注册命令时,需要包含必要的字段以及根据需求可选的字段。
参数表如以下表格所示:
批量注册请求参数 |
解释 |
domain0-domain99 |
您要注册的域名,每次请求最多可注册100个域名 |
premium (可选) |
如果您要注册一个高级域名,将其设为等于"1"(可选) |
currency (可选) |
您可以决定货币类型,支持的参数包括"USD"、"CNY"、"GBP"、"EUR"、"INR"、"CAD"等等。如果您遗漏了此参数,我们将使用账户默认货币。 |
coupon (可选) |
您希望用于此命令的优惠代码 |
在成功发送批量注册命令之后,返回的结果将以XML或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 |
解释 |
<BulkRegisterResponse></BulkRegisterResponse> |
大量注册响应的标记 |
<BulkRegisterHeader></BulkRegisterHeader> |
批量注册标题标记 |
<SuccessCode></SuccessCode> |
如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> |
请求状态 |
<Error></Error> |
请求错误信息,仅状态为"error"时使用 |
<BulkRegisterContent></BulkRegisterContent> |
批量注册内容的标签 |
<Expiration></Expiration> |
以Unix时间计的过期日期(毫秒,自1970年1月1日午夜起),仅结果为"success"时使用 |
<Result></Result> |
注册操作的结果 |
<Message></Message> |
注册操作的错误消息,仅在结果为"error"时使用 |
示例:
此处,使用API发送域名批量注册命令,注册域名为domain0.com与domain1.com,结算货币为美元。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
则最后返回的参数为:
请求(XML格式)
https://api.dynadot.com/api3.xml?key=mykey&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
响应(XML格式)
<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
<BulkRegisterHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BulkRegisterHeader>
<BulkRegisterContent>
<BulkRegister>
<RegisterResult>
<DomainName>domain0.com</DomainName>
<Expiration>1234567890</Expiration>
<Result>success</Result>
<Message>-</Message>
</RegisterResult>
<RegisterResult>
<DomainName>domain1.com</DomainName>
<Expiration>-</Expiration>
<Result>error</Result>
<Message>not_available</Message>
</RegisterResult>
</BulkRegister>
</BulkRegisterContent>
</BulkRegisterResponse>
以同样的批量注册命令为例,JSON格式的为:
请求(JSON格式)
https://api.dynadot.com/api3.json?key=mykey&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
响应(JSON格式)
{
"BulkRegisterResponse": {
"ResponseCode": 0,
"Status": "success",
"BulkRegister": [
{
"DomainName": "domain0.com",
"Expiration": "1234567890",
"Result": "success",
"Message": "-"
},
{
"DomainName": "domain1.com",
"Expiration": "-",
"Result": "error",
"Message": "not_available"
}
]
}
}
在网页中,其显示样式如下:(示例为实际操作,失败的返回结果展示。在网页中会显示删除失败原因。)
XML格式
JSON格式