前言
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' |
指定拍卖的代理竞拍;如果您尚未出价,应为'-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格式