使用Dynadot API为文件夹中的域名设置域名服务器（NS）ip信息

关于Dynadot

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

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

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

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

使用Dynadot API，可以为在某一文件夹中的域名统一设置域名服务器（Name server）ip信息。

命令参数

如果发送设置文件夹域名服务器的ip信息命令，则须包含下列参数：

如何使用API查看文件夹id：使用API有效率地管理Dynadot域名，列表形式查询已存在的文件夹信息

|----------------|----------------------------------------------|
| 设置域名服务器文件夹请求参数 | 解释 |
| fold_id | 您要设置的文件夹ID，每个请求可设置1个文件夹 |
| ns0 - ns12 | 您要设置并启用域名的域名服务器，您可指定多达13个域名服务器，但它们必须已经在您的账户中 |
| enable (可选) | 如果您要将此域名服务器设置应用于今后移动至该文件夹的域名，则可将此参数设为"yes" |
| sync (可选) | 若要同步该文件夹下所有域名的域名服务器设置，则可将此参数设为"yes" |

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

|-------------------------------------------------|------------------------------------|
| XML结果标签 | 解释 |
| <SetFolderNsResponse></SetFolderNsResponse> | 设置域名服务器响应标签，它是响应XML文档的根节点 |
| <SetFolderNsHeader></SetFolderNsHeader> | 设置文件夹域名服务器响应标题标签 |
| <SuccessCode></SuccessCode> | 如果操作成功，"0"为成功，"-1"为失败 |
| <Status></Status> | 请求状态 |
| <Error></Error> | 请求错误信息，仅状态为"error"时使用 |
| <SetFolderNsContent></SetFolderNsContent> | 设置文件夹域名服务器响应内容标签，仅当状态为"success"时使用 |
| <Servers></Servers> | 已设置的服务器信息 |
| <Server></Server> | 每个服务器 |
| <ServerName></ServerName> | 服务器名称 |
| <ServerId></ServerId> | 服务器ID |

示例

此处，使用API设置文件夹域名服务器ip信息。

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

Request (XML format)

https://api.dynadot.com/api3.xml?key=\[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes

Response (XML format)

XML 复制代码

<?xml version="1.0" encoding="UTF-8"?>

<SetFolderNsResponse>

  <SetFolderNsHeader>

    <SuccessCode>0</SuccessCode>

    <Status>success</Status>

  </SetFolderNsHeader>

  <SetFolderNsContent>

    <Servers>

      <Server>

        <ServerName>ns1.hosts.com</ServerName>

        <ServerId>0</ServerId>

      </Server>

      <Server>

        <ServerName>ns2.hosts.com</ServerName>

        <ServerId>1</ServerId>

      </Server>

    </Servers>

  </SetFolderNsContent>

</SetFolderNsResponse>

Request (JSON format)

https://api.dynadot.com/api3.json?key=\[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes

Response (JSON format)

XML 复制代码

{

  "SetFolderNsResponse": {

    "ResponseCode": 0,

    "Status": "success",

    "SetFolderNsContent": {

      "Servers": [

        {

          "ServerName": "ns1.hosts.com",

          "ServerId": "0"

        },

        {

          "ServerName": "ns2.hosts.com",

          "ServerId": "1"

        }

      ]

    }

  }

}