前言
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,优惠长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在具体的功能API代码前,请阅读关于Dynadot的API使用须知。
使用Dynadot API,可以查看当前在Dynadot平台正在进行拍卖的域名。
注意:正在拍卖的域名数量可能较多,建议您选择不同的拍卖类目进行API搜索。
命令参数
如果发送查询Dynadot正在拍卖的域名列表命令,则须包含下列参数:
获取公开拍卖请求参数 | 解释 |
currency (可选) | 返回货币结果,应为"usd", "eur", 或 "cny",,默认货币为美元 |
type | 您想查看的拍卖类型应该是"expired"过期域名, "user"用户域名, "backorder"域名抢注, 或 "registry_expired"注册局过期域名, "registrar"注册商合作域名,,如果您想获取多种拍卖类型,可以使用","来分隔每种拍卖类型。 |
在成功发送查看拍卖域名列表命令之后,返回的结果将以XML、CSV或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 | 解释 |
<GetOpenAuctionsResponse></GetOpenAuctionsResponse> | 获取公开拍卖响应标签,它是响应XML文档的根节点 |
<GetOpenAuctionsHeader></GetOpenAuctionsHeader> | 获取公开拍卖标题 |
<SuccessCode></SuccessCode> | 如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> | 请求状态 |
<Error></Error> | 请求错误信息,仅状态为"error"时使用 |
<GetOpenAuctionsContent></GetOpenAuctionsContent> | 公开拍卖内容标签,仅当状态为"success"时使用 |
<Auction></Auction> | 拍卖项目标签,仅状态为"success"时使用 |
<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> | 域名年龄 |
示例
此处,使用API查询拍卖域名列表,类型为过期域名拍卖。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_auctions¤cy=usd&type=expired
Response (XML format)
<GetOpenAuctionsResponse>
<GetOpenAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenAuctionsHeader>
<GetOpenAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
.
.
.
</GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
请求(csv格式)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions¤cy=usd&type=expired
响应
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.
Request (JSON format)
https://api.dynadot.com/api3.json?key=[API Key]&command=get_open_auctions¤cy=usd&type=expired
Response (JSON format)
{
"status": "success",
"auction_list": [
{
"auction_id": 11,
"domain": "domain.com",
"utf_name": "domain.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "124.00",
"bids": 4,
"bidders": 2,
"time_left": "1 day, 23 hours",
"start_time": "2022/03/28 02:20 PST",
"start_time_stamp": 1648459234033,
"end_time": "2022/04/04 02:20 PST",
"end_time_stamp": 1649064034033,
"visitors": 223,
"links": "-",
"age": 0,
"estibot_appraisal": "-"
},
{
"auction_id": 12,
"domain": "domain0.com",
"utf_name": "domain0.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "44.99",
"bids": 1,
"bidders": 1,
"time_left": "2 days, 23 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"visitors": 245,
"links": "-",
"age": 0,
"estibot_appraisal": "-"
}
...
]
}
在网页中,其显示样式如下:(示例为实际操作,由于列表长度过长这里只展示其中一种格式。)
CSV格式