使用API有效率地管理Dynadot域名，进行域名邮箱的默认邮件转发设置

关于Dynadot

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

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

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

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

在Dynadot注册的每个域名都附带免费的电子邮件转发服务。电子邮件转发允许您在您的域名上接收邮件，例如，email@yourdomain.com。该邮件会转发到已有的电子邮箱，比如Gmail、Yahoo、Hotmail或其他电子邮箱。

使用Dynadot API，可以将域名邮箱进行默认的电子邮件转发设置。

相关参数

当需要为域名邮箱设立默认的电子邮件转发地址，需要提供以下参数。

设置默认电子邮件转发请求参数	解释
forward_type	转发类型，可以是"donot":：不要转发邮件；"mx":将邮件转发给另一个邮箱主机（MX记录）；"forward":：将邮件转发给另一个邮箱主机
username0 - username9	用户名，仅"forward_type"为"forward"时使用
exist_email0 - exist_email9	现有电子邮箱地址，仅当"forward_type"为"forward"时使用
mx_host0 - mx_host2	邮箱主机，仅"forward_type"为"mx"时使用
mx_distance0 - mx_distance2	Distance0为最高优先级，仅当"forward_type"为"mx"时使用

在成功进行设置之后，返回的结果将以XML或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
<SetDefaultEmailForwardingResponse></SetDefaultEmailForwardingResponse>	响应XML文档的根节点
<SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingHeader>	响应标头
<SuccessCode></SuccessCode>	如果操作成功，"0"为成功，"-1"为失败
<Status></Status>	请求状态
<Error></Error>	请求错误信息，仅状态为"error"时使用

示例：

此处，使用API发送设置默认域名邮件转发命令，set_default_email_forward，类型为电子邮件转发，转发邮箱为peter@dynadot.com。

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

则最后返回的参数为：

请求（XML格式）

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&exist_email0=peter@dynadot.com

响应（XML格式）

<SetDefaultEmailForwardingResponse>

  <SetDefaultEmailForwardingHeader>

    <SuccessCode>0</SuccessCode>

    <Status>success</Status>

  </SetDefaultEmailForwardingHeader>

</SetDefaultEmailForwardingResponse>

请求（JSON格式）

https://api.dynadot.com/api3.json?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&exist_email0=peter@dynadot.com

响应（JSON格式）

{

   "SetDefaultEmailForwardingResponse":{

      "ResponseCode":"0",

      "Status":"success"

   }

}

在网页中，其显示样式如下：（示例为实际操作。）

XML格式

JSON格式