使用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、CSV或是JSON格式的标签返回，其中XML的结果标签所代表含义由下图所示：

XML结果标签	解释
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>	获取拍卖详情响应标签，它是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>	拍卖状态
<UserIsHighBid></UserIsHighBid>	如果用户为出价最高者
<YourCurrentBid></YourCurrentBid>	指定拍卖中您目前的竞拍出价；若尚未出价，则应为'-1'
<YourProxyBid></YourProxyBid>	指定拍卖的代理竞拍；如果您尚未出价，应为'-1'
<AuctionId></AuctionId>	拍卖ID
<Domain></Domain>	拍卖的域名
<BidPrice></BidPrice>	拍卖目前竞标价格
<BidPriceCurrency></BidPriceCurrency>	竞拍价格货币
<Bids></Bids>	竞拍出价次数
<EndTime></EndTime>	拍卖结束时间
<EndTimestamp></EndTimestamp>	拍卖终止日期，以Unix时间计（毫秒，自UTC1970年一月1日午夜起）
<IsPremium></IsPremium>	是否为高端域名
<RenewalPrice></RenewalPrice>	续费价格

示例

此处，使用API查询拍卖的域名domain0.com。

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

Request (XML format)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd

Response (XML format)

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

<GetAuctionDetailsResponse>

  <GetAuctionDetailsHeader>

    <SuccessCode>0</SuccessCode>

    <Status>success</Status>

  </GetAuctionDetailsHeader>

  <GetAuctionDetailsContent>

    <Auction>

      <AuctionStatusId>0</AuctionStatusId>

      <AuctionStatus>1</AuctionStatus>

      <AuctionId>0</AuctionId>

      <Domain>test.biz</Domain>

      <BidPrice>46.99</BidPrice>

      <BidPriceCurrency>USD</BidPriceCurrency>

      <Bids>0</Bids>

      <EndTime>1970/01/01 00:00 UTC</EndTime>

      <EndTimestamp>0</EndTimestamp>

      <Revenue>1</Revenue>

      <RevenueCurrency>USD</RevenueCurrency>

      <Visitors>-1</Visitors>

      <Links>1</Links>

      <Age>10</Age>

      <isPremium>false</isPremium>

      <RenewalPrice>-0.1</RenewalPrice>

      <UserIsHighBid>false</UserIsHighBid>

      <YourCurrentBid>-1</YourCurrentBid>

      <YourProxyBid>-1</YourProxyBid>

    </Auction>

  </GetAuctionDetailsContent>

</GetAuctionDetailsResponse>

Request (JSON format)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd

Response (JSON format)

{

  "status": "success",

  "size": 1,

  "auction_details": [

    {

      "auction_json": {

        "auction_id": 0,

        "domain": "test.biz",

        "utf_name": "test.biz",

        "is_idn": false,

        "auction_type": "expired",

        "current_bid_price": "46.99",

        "accepted_bid_price": "46.99",

        "currency": "USD",

        "is_high_bidder": false,

        "bids": 0,

        "bidders": 0,

        "auction_status_id": 0,

        "time_left": "1",

        "start_time": "1",

        "start_time_stamp": 0,

        "end_time": "",

        "end_time_stamp": 0,

        "revenue": "1",

        "visitors": -1,

        "links": "1",

        "age": 10,

        "estibot_appraisal": "",

        "bidder_name": "",

        "bid_price": "",

        "timestamp": 0,

        "bid_status": "",

        "is_proxy_auto_bid": false,

        "auction_ended": false,

        "customer_bided": false,

        "customer_bid": "1",

        "customer_proxy_bid": "1",

        "is_premium": false,

        "renewal_price": "-0.1"

      },

      "bid_history": []

    }

  ]

}

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

XML格式

JSON格式