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

关于Dynadot

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

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

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

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

当平台中的域名过多时，管理人通常会使用域名分类夹管理域名，当文件夹过多时，可以使用DynadotAPI查询目前存在的文件夹列表，同时会显示文件夹的设置。

命令参数

如果要发送查询域名文件夹列表命令时，无需额外参数。

在成功发送查询文件夹列表命令之后，返回的结果将以XML或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
<FolderListHeader></FolderListHeader>	响应标头
<SuccessCode></SuccessCode>	如果操作成功，"0"为成功，"-1"为失败
<Status></Status>	请求状态
<Error></Error>	请求错误信息，仅状态为"error"时使用
<FolderListContent></FolderListContent>	响应内容
<FolderList></FolderList>	文件夹列表
<List></List>
<Folder></Folder>
<FolderId></FolderId>	文件夹ID
<FolderName></FolderName>	文件夹名称
<DefaultWhois></DefaultWhois>	默认Whois
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>	默认Whois启用状态
<DefaultRegistrant></DefaultRegistrant>	默认注册人
<ContactId></ContactId>	联络人ID
<DefaultAdmin></DefaultAdmin>	默认管理员
<DefaultTechnical></DefaultTechnical>	默认技术信息
<DefaultBilling></DefaultBilling>	默认账单信息
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>	默认域名服务器启用状态
<NameServerSettings></NameServerSettings>	域名服务器设置
<Type></Type>	域名服务器类型
<WithAds></WithAds>	是否带有广告
<DefaultRenewOption></DefaultRenewOption>	默认续费选项
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>	默认续费启用状态
<RenewOption></RenewOption>	续费选项
<DefaultTransferLock></DefaultTransferLock>	默认转移锁定
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>	默认转移锁定启用状态
<LockStatus></LockStatus>	锁定状态

示例

此处，使用API发送查询文件夹列表命令

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

则最后返回的参数为：

请求（XML格式）

https://api.dynadot.com/api3.xml?key=mykey&command=folder_list

响应（XML格式）

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

<FolderListResponse>

  <FolderListHeader>

    <ResponseCode>0</ResponseCode>

    <Status>success</Status>

  </FolderListHeader>

  <FolderListContent>

    <FolderList>

      <List>

        <Folder>

          <FolderId>0</FolderId>

          <FolderName>new</FolderName>

          <DefaultWhois>

            <DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>

            <DefaultRegistrant>

              <ContactId>0</ContactId>

            </DefaultRegistrant>

            <DefaultAdmin>

              <ContactId>0</ContactId>

            </DefaultAdmin>

            <DefaultTechnical>

              <ContactId>0</ContactId>

            </DefaultTechnical>

            <DefaultBilling>

              <ContactId>0</ContactId>

            </DefaultBilling>

          </DefaultWhois>

          <DefaultNameServers>

            <DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>

            <NameServerSettings>

              <Type>Dynadot Parking</Type>

              <WithAds>Yes</WithAds>

            </NameServerSettings>

          </DefaultNameServers>

          <DefaultRenewOption>

            <DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>

            <RenewOption>no renew option</RenewOption>

          </DefaultRenewOption>

          <DefaultTransferLock>

            <DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>

            <LockStatus>locked</LockStatus>

          </DefaultTransferLock>

        </Folder>

      </List>

    </FolderList>

  </FolderListContent>

</FolderListResponse>

请求（JSON格式）

https://api.dynadot.com/api3.json?key=mykey&command=folder_list

响应（JSON格式）

{

  "FolderListResponse": {

    "ResponseCode": 0,

    "Status": "success",

    "FolderList": [

      {

        "FolderId": "0",

        "FolderName": "new",

        "DefaultWhois": {

          "DefaultWhoisEnableStatus": "disable",

          "DefaultRegistrant": {

            "ContactId": "0"

          },

          "DefaultAdmin": {

            "ContactId": "0"

          },

          "DefaultTechnical": {

            "ContactId": "0"

          },

          "DefaultBilling": {

            "ContactId": "0"

          }

        },

        "DefaultNameServers": {

          "DefaultTransferLockEnableStatus": "disable",

          "NameServerSettings": {

            "Type": "Dynadot Parking",

            "WithAds": "Yes"

          }

        },

        "DefaultRenewOption": {

          "DefaultRenewOptionEnableStatus": "disable",

          "RenewOption": "no renew option"

        },

        "DefaultTransferLock": {

          "DefaultTransferLockEnableStatus": "disable",

          "LockStatus": "locked"

        }

      }

    ]

  }

}

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

XML格式

JSON格式