使用API有效率地管理Dynadot域名，查看某一过期域名的拍卖详情

前言

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

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

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

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

使用Dynadot API，可以查看当前在Dynadot平台某一个正在进行过期拍卖的域名此时的竞拍细节。

命令参数

如果发送查询Dynadot拍卖的过期域名细节命令，则须包含下列参数：

获取拍卖详情请求参数	解释
domain	拍卖的域名，IDN（国际域名）应使用域名代码punycode，例如“xn--wkccg.com”。
currency (可选)	返回货币结果，应为"usd", "eur", 或 "cny",，默认货币为美元

在成功发送查看域名拍卖信息的命令之后，返回的结果将以XML或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>	获取拍卖详情响应标签，它是XML文档响应的根节点
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>	获取拍卖详情标题
<SuccessCode></SuccessCode>	如果操作成功，"0"为成功，"-1"为失败
<Status></Status>	请求状态
<Error></Error>	请求错误信息，仅状态为"error"时使用
<GetAuctionDetailsContent></GetAuctionDetailsContent>	获取拍卖细节内容标签，仅当状态为"success"时可用
<AuctionStatusId></AuctionStatusId>	拍卖状态ID，“0”为进行中，“1”为被用户关闭，“2”为被管理员关闭，“3”为因续费关闭，“4”为由于超时关闭，“5”为因迁出关闭
<AuctionStatus></AuctionStatus>	拍卖状态
<AuctionId></AuctionId>	拍卖ID
<Domain></Domain>	拍卖的域名
<BidPrice></BidPrice>	拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>	竞拍价格货币
<Bids></Bids>	竞拍出价次数
<EndTime></EndTime>	拍卖结束时间
<EndTimestamp></EndTimestamp>	拍卖终止日期，以Unix时间计（毫秒，自UTC1970年一月1日午夜起）
<Revenue></Revenue>	拍卖收入
<RevenueCurrency></RevenueCurrency>	收入货币
<Visitors></Visitors>	域名访客
<Links></Links>	到达域名链接
<Age></Age>	域名年龄
<UserIsHighBid></UserIsHighBid>	如果用户为出价最高者
<YourCurrentBid></YourCurrentBid>	指定拍卖中您目前的竞拍出价；若尚未出价，则应为'-1'
<YourProxyBid></YourProxyBid>	指定拍卖的代理竞拍；如果您尚未出价，应为'-1'

示例

此处，使用API查询过期域名example.com的过期拍卖信息。

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

Request (XML format)

https://api.dynadot.com/api3.xml?key=[API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd

Response (XML format)

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

<GetBackorderAuctionDetailsResponse>

  <GetBackorderAuctionDetailsHeader>

    <SuccessCode>0</SuccessCode>

    <Status>success</Status>

  </GetBackorderAuctionDetailsHeader>

  <GetBackorderAuctionDetailsContent>

    <AuctionStatusId>0</AuctionStatusId>

    <AuctionStatus>In Progress</AuctionStatus>

    <UserIsHighBid>no</UserIsHighBid>

    <YourCurrentBid>-1</YourCurrentBid>

    <YourProxyBid>-1</YourProxyBid>

    <Auction>

      <AuctionId>10001</AuctionId>

      <Domain>example.com</Domain>

      <BidPrice>89.99</BidPrice>

      <BidPriceCurrency>USD</BidPriceCurrency>

      <Bids>0</Bids>

      <EndTime>2015/04/28 18:16 UTC</EndTime>

      <EndTimestamp>1430244969779</EndTimestamp>

    </Auction>

  </GetBackorderAuctionDetailsContent>

</GetBackorderAuctionDetailsResponse>

Request (JSON format)

https://api.dynadot.com/api3.json?key=[API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd

Response (JSON format)

{

  "GetBackorderAuctionDetailsResponse": {

    "ResponseCode": 0,

    "Status": "success",

    "GetBackorderAuctionDetails": {

      "AuctionStatusId": "0",

      "AuctionStatus": "In Progress",

      "UserIsHighBid": "no",

      "YourCurrentBid": "-1",

      "YourProxyBid": "-1",

      "Auction": {

        "AuctionId": "10001",

        "Domain": "example.com",

        "BidPrice": "89.99",

        "BidPriceCurrency": "USD",

        "Bids": "0",

        "EndTime": "2015/04/28 18:16 UTC",

        "EndTimestamp": "1430244969779"

      }

    }

  }

}

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

XML格式

JSON格式