Dynadot竞拍API(Beta)

Our Dynadot Auction API is a powerful tool to help you make the most of our domain marketplace. The API allows you to get auction details and place bids on our expired domain auctions, backorders and user auctions. With a few simple API calls you can get the most out of the Dynadot aftermarket! Our Marketplace API is available to all accounts, so get started today!

开始使用我们的Dynadot竞拍API

对我们Dynadot竞拍API的请求将发送至以下URL:

https://www.dynadot.com/auction-api/{command}

请注意,请求应通过https(安全套接)发送,以确保安全性。一次仅能处理1条请求,所以请您等待当前请求处理完毕再发送另一条请求。请求应包含下列参数:

请求参数
解释
api_key您进入API的密匙,位于您账户的控制面板中
command现在支持的命令为"get-auction-list"、"get-auction-item"、"place-auction-bid"和"get-auction-bids"
currency(optional)您可以决定使用哪种货币显示竞拍数据,此参数支持的为"USD"、"CNY"、"GBP"、"EUR"、"INR"、"CAD"等。如果缺少此参数,我们将使用USD

结果以json文本发出。

结果字段
解释
status此API调用的结果:
success - 命令成功
error - 命令不成功
content关于结果的更多信息,仅结果为“错误”时使用

获取竞拍列表(Get Auction List)命令

如果调用"get auction list"命令,应包括以下参数:

获取竞拍列表(Get Auction List)请求参数
解释
auction_type您要请求的竞拍类型现在得到支持的为"expired"、"user"、"backorder"。您可以以请求一种或多种竞拍类型。如果有多于两种类型,您必须使用”,“分隔每一竞拍类型

您为竞拍清单请求的many结果。每一竞拍将具有以下字段

获取竞拍列表(Get Auction List)结果字段
解释
auction_idauction_id参数,例如:1
domain此竞拍的域名,例如:domain-haha1.cn
utf_name此竞拍的utf域名,例如:domain-haha1.cn
is_idn如果此域名是国际域名,例如:false
auction_type此竞拍的类型,例如:expired
currency当前价格货币,例如:USD
current_bid_price此竞拍的当前出价,例如:28.99
bids关于此竞拍的出价次数,例如:5
bidders参加此次竞拍出价的人数,例如:3
time_left此竞拍的剩余时间,例如:11 hours, 30 min
start_time此竞拍的开始时间,例如:2019/02/13 05:00 PST
start_time_stamp此竞拍的开始时间戳,例如:1550062850113
end_time此竞拍的结束时间,例如:2019/02/20 05:00 PST
end_time_stamp此竞拍的结束时间戳,例如:1550667650113
visitors访客数量,例如:40
links链接数量,例如:365
age此域名的年龄,例如:2
estibot_appraisal此域名在estibot_appraisal上的价格,例如:$388.03

获取竞拍列表(Get Auction List)示例

请求

https://www.dynadot.com/auction-api/get-auction-list?api_key=MY_API_KEY&auction_type=expired

响应

{

"status": "success",

"auction_list": [

    {

        "auction_id": 1,

        "domain": "domain-haha1.cn",

        "utf_name": "domain-haha1.cn",

        "is_idn": false,

        "auction_type": "expired",

        "currency": "USD",

        "current_bid_price": "57.99",

        "bids": 41,

        "bidders": 10,

        "time_left": "11 hours, 30 min",

        "start_time": "2019/02/13 05:00 PST",

        "start_time_stamp": 1550062850113,

        "end_time": "2019/02/20 05:00 PST",

        "end_time_stamp": 1550667650113,

        "visitors": 50,

        "links": 35,

        "age": 2,

        "estibot_appraisal": "$388.03",

    },

    { /* expired-auction2 data */},

    { /* expired-auction3 data */},

...

获取竞拍项目(Get Auction Item)命令

如果调用"get auction Item"命令,应包括以下参数:

获取竞拍项目(Get Auction Item)请求参数
解释
domain您希望按域名的不同来获取的竞拍详情

在您的请求下按域名的不同将有竞拍的1结果。竞拍详情将具有在以下和清单命令进行比较的一些新字段。命令现在支持未结束或结束后1小时内的竞拍

获取竞拍项目(Get Auction Item)结果字段
解释
accepted_bid_price在此竞拍中可接受的出价,例如:33.99
is_high_bidder如果您是出价较高者,例如:true
auction_ended如果竞拍已结束,例如:false
customer_bided如果您已参加此次竞拍,例如:true
customer_bid您的出价,例如:33.99
customer_proxy_bid您的proxy_bid价格,例如:$100
bidder_name出价者姓名,例如:bidder 1
bid_price此出价的金额,例如:35.99
timestamp当出价者在此次竞拍出价时的时间戳,例如:1550637925300
bid_status您在此竞拍中的状态,"high bidder"表示您是最高出价者,例如:High Bidder
is_proxy_auto_bid如果此竞拍为proxy_bid,例如:false

获取竞拍项目(Get Auction Item)示例

请求

https://www.dynadot.com/auction-api/get-auction-item?api_key=MY_API_KEY&domain=domain-haha1.cn

响应

{

"status": "success",

"auction_json":

    {

        "auction_id": 1,

        "domain": "domain-haha1.cn",

        "utf_name": "domain-haha1.cn",

        "is_idn": false,

        "auction_type": "expired",

        "accepted_bid_price": "57.99",

        "currency": "USD",

        "is_high_bidder": false,

        "current_bid_price": "57.99",

        "bids": 41,

        "bidders": 10,

        "time_left": "11 hours, 30 min",

        "start_time": "2019/02/13 05:00 PST",

        "start_time_stamp": 1550062850113,

        "end_time": "2019/02/20 05:00 PST",

        "end_time_stamp": 1550667650113,

        "visitors": 50,

        "links": 35,

        "age": 2,

        "estibot_appraisal": "$388.03",

        "auction_ended": false,

        "customer_bided": true,

        "costomer_bid": "27.99",

        "customer_proxy_bid": "$159.00",

    },

    "bid_history": [

    {

        "bidder_name": "bidder 1",

        "bid_price": "$159.00",

        "currency": "USD",

        "timestamp": "1550667650113",

        "bid_status": "High Bidder",

        "is_proxy_auto_bid": "false"

    }

    { /* bid history2 data */},

    { /* bid history3 data */},

...

竞拍出价命令

如果调用"Place Auction Bid"命令,应包括以下参数:

竞拍出价请求参数
解释
domain您希望出价竞拍的域名
bid_price您需要的出价,按美元计算,例如85.99

如果您的出价成功,将会有类似于get-auction-item命令的1竞拍结果。

竞拍出价示例

请求

https://www.dynadot.com/auction-api/get-auction-item?api_key=MY_API_KEY&domain=domain-haha1.cn&bid_price=100

响应

{

"status": "success",

"auction_json":

    {

        "auction_id": 1,

        "domain": "domain-haha1.cn",

        "utf_name": "domain-haha1.cn",

        "is_idn": false,

        "auction_type": "expired",

        "accepted_bid_price": "57.99",

        "currency": "USD",

        "is_high_bidder": false,

        "current_bid_price": "57.99",

        "bids": 41,

        "bidders": 10,

        "time_left": "11 hours, 30 min",

        "start_time": "2019/02/13 05:00 PST",

        "start_time_stamp": 1550062850113,

        "end_time": "2019/02/20 05:00 PST",

        "end_time_stamp": 1550667650113,

        "visitors": 50,

        "links": 35,

        "age": 2,

        "estibot_appraisal": "$388.03",

        "auction_ended": false,

        "customer_bided": true,

        "costomer_bid": "27.99",

        "customer_proxy_bid": "$159.00",

    },

    "bid_history": [

    {

        "bidder_name": "bidder 1",

        "bid_price": "$159.00",

        "currency": "USD",

        "timestamp": "1550667650113",

        "bid_status": "High Bidder",

        "is_proxy_auto_bid": "false"

    }

    { /* bid history2 data */},

    { /* bid history3 data */},

...

获取竞拍出价(Get Auction Bids)命令

获取竞拍出价(Get Auction Bids)结果字段
解释
bid_id如果您的请求成功,将有您参与的some次出价。将有以下一些字段。此出价的id,例如:15
auction_id此竞拍的id,例如:5
account_id此账户的id,例如:3
domain此竞拍的域名:例如:domain-haha1.com
domain_utf此竞拍的domain_utf,例如:domain-haha1.com
auction_type此竞拍的竞拍类型,例如:expired
is_idn如果此域名为国际域名,例如:false
current_bid此竞拍的当前出价,例如:$33.99
your_status您在此竞拍中的出价状态,例如:High Bidder
proxy_bid您的代理出价,例如:$37.99
active_bidders在此域名竞拍中出价者的数量,例如:10
ends_on (deprecated)竞拍结束时间,例如:Feb 20, 2019 10:00am PST
end_time此竞拍的结束时间,例如:2019/02/20 05:00:00 PST
end_time_stamp此竞拍的结束时间戳,例如:1550667650113

如果您的请求成功,您将在示例部分看到一些结果。

获取竞拍出价(Get Auction Bids)示例

请求

https://www.dynadot.com/auction-api/get-auction-bids?api_key=MY_API_KEY

响应

{

"status": "success",

"auction_bids": [

    {

        "bid_id": 1,

        "auction_id": 1,

        "account_id": 1,

        "domain": "domain-haha1.cn",

        "domain_utf": "domain-haha1.cn",

        "auction_type": "expired",

        "is_idn": false,

        "current_bid": "$57.99",

        "proxy_bid": "$85.88",

        "your_status": "High Bidder",

        "active_bidders": 10,

        "time_left": "11 hours, 30 min",

        "ends_on": "2019/02/20 05:00 PST",

        "end_time": "2019/02/20 05:00:00 PST",

        "end_time_stamp": "1554774971733",

    },

    { /* bid2 data */},

    { /* bid3 data */},

...