使用API有效率地管理Dynadot域名,将域名移动至某一文件夹中
关于Dynadot
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在了具体的功能API代码前,请阅读关于Dynadot的API使用须知。
当平台中的域名过多时,通过API可以建立文件夹对域名进行分类存放;当然,使用API,可以将某一个域名移动至您想要放置的文件夹中。
命令参数
如果要发送域名移动至某一文件夹命令时,需要包含必要的字段以及根据需求可选的字段。
参数表如以下表格所示:
设置文件夹请求参数 | 解释 |
domain | 要更新的域名,每次请求仅可设置1个域名 |
folder | 您要将域名移动至的文件夹名称,若要将域名已从至默认文件夹,则可将文件夹名设置为"Default"。文件夹名区分大小写,例如,"Folder1"和"folder1"是两个不同的文件夹名 |
folder_id (可选) | 您要将域名移动至的文件夹ID |
注:只有存放域名的文件夹拥有文件夹id,需要在管理平台查看。 文件夹ID的获取请参考这一文章。
在成功发送域名移动命令之后,返回的结果将以XML或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 | 解释 |
<SetFolderResponse></SetFolderResponse> | 设置文件夹响应标签,它是响应XML文档的根节点 |
<SetFolderHeader></SetFolderHeader> | 设置文件夹标头 |
<SuccessCode></SuccessCode> | 如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> | 请求状态 |
<Error></Error> | 请求错误信息,仅状态为"error"时使用 |
示例
此处,使用API发送移动域名至文件夹的命令,将domain1.com这一域名移动至folder1,进行管理。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
则最后返回的参数为:
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Response (XML format)
<SetFolderResponse>
<SetFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHeader>
</SetFolderResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Response (JSON format)
{
"SetFolderResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
在网页中,其显示样式如下:(示例为实际操作。)
XML格式
JSON格式