使用DynadotAPI查看域名清仓中的过期域名列表

前言

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

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

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

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

过期清仓域名是指没有在过期域名拍卖中收到任何竞标的域名。这些域名将拥有一个固定的标价，每天下降，直到清仓域名的期限结束。

使用DynadotAPI，可以查看当前正在进行清仓的域名列表。

命令参数

如果要发送查看清仓过期域名列表的命令时，所需命令参数如下。

|---------------------------|-------------------------------------|
| 获取过期的清仓域名请求参数 | 解释 |
| currency(optional) | 返回结果的货币应为"usd"，"eur"或"cny"，默认货币为美元。 |
| domain(optional) | 如果要查询清算域，请添加此参数 |
| count_per_page (optional) | 每页显示多少个实体 |
| page_index (optional) | 你想查看哪个页面的实体？ |

在成功发送查看当前清仓过期域名列表的命令之后，返回的结果将以XML或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

|-----------------------------------------------------------------------------|------------------------------------------------|
| XML结果标签 | 解释 |
| <GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse> | Get Expired Closeout Domains的标签响应，是响应XML文档的根节点 |
| <GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader> | 获取过期清仓域名标题 |
| <ResponseCode></ResponseCode> | 如果操作成功，则为成功的"0"，失败的"-1" |
| <Status></Status> | 请求状态 |
| <Error></Error> | 请求的错误信息仅在状态为"错误"时使用 |
| <GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent> | 内容标记，仅在状态为'成功'时使用 |
| <CloseoutItem></CloseoutItem> | 清仓商品 |
| <DomainName></DomainName> | 域名 |
| <DomainNameUtf></DomainNameUtf> | 域名采用UTF格式 |
| <CurrentPrice></CurrentPrice> | 当前价格 |
| <isIdn></isIdn> | 是否为idn域名 |
| <EndTimeStamp></EndTimeStamp> | 拍卖结束日期的Unix时间（自1970年1月1日UTC午夜以来的毫秒数） |
| <RenewalPrice></RenewalPrice> | 续费价格 |
| <ExpiredRevenue></ExpiredRevenue> | 清仓收入 |
| <DynaAppraisal></DynaAppraisal> | DynaAppraisal |
| <InboundLinks></InboundLinks> | 到达域名链接 |
| <MonthlyVisitors></MonthlyVisitors> | 域名访客 |
| <Currency></Currency> | 货币 |

示例

此处，使用API发送命令。

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

Request (XML format)

https://api.dynadot.com/api3.xml?key=MY_API_KEY\&command=get_expired_closeout_domains¤cy=usd

Response (XML format)

XML 复制代码

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

<GetExpiredCloseoutDomainsResponse>

  <GetExpiredCloseoutDomainsHeader>

    <ResponseCode>0</ResponseCode>

    <Status>success</Status>

  </GetExpiredCloseoutDomainsHeader>

  <GetExpiredCloseoutDomainsContent>

    <CloseoutItem>

      <DomainName>test.biz</DomainName>

      <DomainNameUtf>test.biz</DomainNameUtf>

      <CurrentPrice>9.91</CurrentPrice>

      <IsIDN>false</IsIDN>

      <EndTimeStamp>0</EndTimeStamp>

      <RenewalPrice>9.99</RenewalPrice>

      <ExpiredRevenue>9.90</ExpiredRevenue>

      <EstibotAppraisal>1223</EstibotAppraisal>

      <InboundLinks>-1</InboundLinks>

      <MonthlyVisitors>-1</MonthlyVisitors>

      <Currency>usd</Currency>

    </CloseoutItem>

  </GetExpiredCloseoutDomainsContent>

</GetExpiredCloseoutDomainsResponse>

Request (JSON format)

https://api.dynadot.com/api3.json?key=MY_API_KEY\&command=get_expired_closeout_domains¤cy=usd

Response (JSON format)

复制代码

{

  "GetExpiredCloseoutDomainsResponse": {

    "ResponseCode": 0,

    "Status": "success",

    "Size": 1,

    "CloseoutDomains": [

      {

        "closeoutItem": {

          "domainName": "test.biz",

          "domainNameUtf": "test.biz",

          "currentPrice": "9.91",

          "isIdn": false,

          "endTimeStamp": 0,

          "renewalPrice": "9.99",

          "expiredRevenue": "9.90",

          "estibotAppraisal": "1223",

          "inboundLinks": -1,

          "monthlyVisitors": -1,

          "currency": "usd"

        }

      }

    ]

  }

}

XML格式（实际操作）

JSON格式