前言
Dynadot是通过ICANN认证的域名注册商,自2002年成立以来,服务于全球108个国家和地区的客户,为数以万计的客户提供简洁,优惠,安全的域名注册以及管理服务。
Dynadot平台操作教程索引(包括域名邮箱,解析,建站,长期更新)
Dynadot.com提供的API是专为效率而构建的高级域名管理和获取工具包。在Dynadot平台上,我们提供了50多个命令来设置,管理,注册和竞标域名。
在具体的功能API代码前,请阅读关于Dynadot的API使用须知。
使用Dynadot API,可以查看当前用户在Dynadot平台已参与的域名拍卖列表。
命令参数
如果发送查询Dynadot拍卖的某域名出价的命令,则须包含下列参数:
获取拍卖竞标请求参数 | 解释 |
currency (可选) | 您竞拍的货币,应为"usd", "eur", 或 "cny",,默认货币为美元 |
在成功发送查看域名拍卖出价信息的命令之后,返回的结果将以XML、CSV或是JSON格式的标签返回,其中XML的结果标签所代表含义由下图所示:
XML结果标签 | 解释 |
<GetAuctionBidsResponse></GetAuctionBidsResponse> | 获取拍卖竞标响应的标记,它是响应XML文档的根节点 |
<GetAuctionBidsHeader></GetAuctionBidsHeader> | 获取拍卖竞标标头 |
<SuccessCode></SuccessCode> | 如果操作成功,"0"为成功,"-1"为失败 |
<Status></Status> | 请求状态 |
<Error></Error> | 请求错误信息,仅状态为"error"时使用 |
<GetAuctionBidsContent></GetAuctionBidsContent> | 获取拍卖竞标内容的标签,仅在状态为 "success" 时使用 |
<BidList></BidList> | 竞标清单 |
<Bid></Bid> | 竞标项 |
<BidId></BidId> | 竞标ID |
<AuctionId></AuctionId> | 拍卖ID |
<AccountId></AccountId> | 账户ID |
<Domain></Domain> | 拍卖的域名 |
<DomainUtf></DomainUtf> | 域 utf 拍卖名称 |
<AuctionType></AuctionType> | 拍卖类型 |
<IsIdn></IsIdn> | 如果此域名是国际化域名 |
<CurrentBid></CurrentBid> | 拍卖的当前竞价价格 |
<YourStatus></YourStatus> | 您的拍卖竞标状态 |
<ProxyBid></ProxyBid> | 您的委托竞拍出价 |
<ActiveBidders></ActiveBidders> | 参加此次拍卖的竞标者数量 |
<TimeLeft></TimeLeft> | 拍卖剩余时间 |
<EndTime></EndTime> | 拍卖结束时间 |
<EndTimestamp></EndTimestamp> | 拍卖的结束时间戳 |
示例
此处,使用API查询已出价的拍卖的域名。
将高级域API请求发送到以下URL:https://api.dynadot.com/api3.xml。
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_auction_bids¤cy=usd
Response (XML format)
<GetAuctionBidsResponse>
<GetAuctionBidsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionBidsHeader>
<GetAuctionBidsContent>
<BidList>
<Bid>
<BidId>0</BidId>
<AuctionId>11</AuctionId>
<AccountId>1</AccountId>
<Domain>domain.com</Domain>
<DomainUtf>domain.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$124.00</CurrentBid>
<YourStatus>Out Bid</YourStatus>
<ProxyBid>$119.00</ProxyBid>
<ActiveBidders>2</ActiveBidders>
<TimeLeft>1 day, 6 hours</TimeLeft>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Bid>
<Bid>
<BidId>9</BidId>
<AuctionId>12</AuctionId>
<AccountId>1</AccountId>
<Domain>domain0.com</Domain>
<DomainUtf>domain0.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$44.99</CurrentBid>
<YourStatus>High Bidder</YourStatus>
<ProxyBid>$121.00</ProxyBid>
<ActiveBidders>1</ActiveBidders>
<TimeLeft>2 days, 6 hours</TimeLeft>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Bid>
</BidList>
</GetAuctionBidsContent>
</GetAuctionBidsResponse>
Request (JSON format)
https://api.dynadot.com/api3.json?key=[API Key]&command=get_auction_bids¤cy=usd
Response (JSON format)
{
"status": "success",
"auction_bids": [
{
"bid_id": 0,
"auction_id": 11,
"account_id": "1",
"domain": "domain.com",
"domain_utf": "domain.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "1 day, 23 hours",
"end_time": "2022/04/04 02:20:34 PST",
"end_time_stamp": 1649064034033
},
{
"bid_id": 2,
"auction_id": 12,
"account_id": "1",
"domain": "domain0.com",
"domain_utf": "domain0.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "2 days, 23 hours",
"end_time": "2022/04/05 02:20:34 PST",
"end_time_stamp": 1649150434049
}
...
]
}
在网页中,其显示样式如下:(示例为实际操作。)
XML格式
JSON格式