Dynadot竞拍API(Beta)

我们的Dynadot竞拍API是能够帮助您最有效地利用我们域名市场的一种强大工具。该API让您能够获取关于我们过期域名竞拍、域名预订和用户竞拍的竞拍详情并进行出价。通过少数简单的API调用,您可以最有效地利用Dynadot二级市场!我们的市场API对所有账户可用,立即开始吧!

开始使用我们的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/place-auction-bid?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竞拍结束时间,例如: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 */},

...