使用API有效率地管理Dynadot域名，为文件夹中的域名统一设置电子邮件转发

 关于Dynadot

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

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

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

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

电子邮件转发允许您将您的域名上接收的邮件，例如，[e-mail]，转发到已有的电子邮箱，比如Gmail、Yahoo、Hotmail或其他电子邮箱。

当域名较多时，使用DynadotAPI，可以为分类到同一文件夹中管理的域名统一设置电子邮件转发。

命令参数

在发送为文件夹域名设置电子邮件转发命令时，需要包含以下必要的字段。在进行设置之前，需要已经确定好电子邮件转发类型。

设置文件夹电子邮件转发请求参数	解释
domain	您要设置的域名，每个请求仅可设置100个域名，请务必用逗号将其隔开
folder_id	您想设置的文件夹ID
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"时使用
enable (可选)	如果您要将此设置应用于今后移动至该文件夹的域名，则可将此参数设为"yes"
sync (可选)	如果您要将此设置同步于此文件夹中的所有域名，则可将此参数设为"yes"

在成功发送为文件夹域名设置电子邮件转发命令之后，返回的结果将以XML或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

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

示例

此处，使用API发送电子邮件转发设置命令set_folder_email_forward，电子邮件转发的类型为MX记录类型，文件夹id为0，将邮件转发给用户名为test的现有邮箱，地址则为[e-mail]。

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

Request (XML format)

https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&exist_email0=[e-mail]

Response (XML format)

<SetFolderEmailForwardingResponse><SetFolderEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderEmailForwardingHeader></SetFolderEmailForwardingResponse>

Request (JSON format)

https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&exist_email0=[e-mail]

Response (JSON format)

{"SetFolderEmailForwardingResponse":{"ResponseCode":"0","Status":"success"}}