API de leilões Dynadot (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!

Comece a usar a API do leilão Dynadot

Requests to our Dynadot Auction API are sent to the following URL:

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

Note que as solicitações devem ser enviadas por https (soquete seguro) por segurança. Apenas 1 solicitação pode ser processada por vez. Por favor, aguarde o término da solicitação atual antes de enviar outra. A solicitação deve ter os seguintes parâmetros:

Parâmetro de Solicitação
Explicação
api_keySua chave para acessar a API, disponível no seu painel de controle.
commandThe commands supported right now are "get-auction-list" , "get-auction-item","place-auction-bid" and "get-auction-bids"
currency(optional)You can decide which currency to display auction data and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on.If you missed this parameter,we will use USD acquiescently

Os resultados são enviados como um texto json.

Campo de Resultado
Explicação
statusThe result of this API call:
success - the command was successful
error - the command was not successful
contentMais informações sobre o resultado, usado somente quando o resultado é um "erro"

Comando para obter lista do leilão

If calling the "get auction list" command, the following parameters should be included:

Obter parâmetro de solicitação da lista de leilões
Explicação
auction_typeThe auction type you want to request,now supported are "expired","user","backorder".You can request one or more auction types.If there are more than two types, you must use "," to split each auction type

There will be many results for auction list you request. Each auction will have fields as below

Obter campo de resultados de lista do leilão
Explicação
auction_idO parâmetro auction_id, por exemplo: 1
domainO nome de domínio deste leilão, por exemplo: domain-haha1.cn
utf_nameThe utf domain name of this auction, for example: domain-haha1.cn
is_idnIf this domain is international domain name, for example: false
auction_typeO tipo desse leilão, por exemplo: expired
currencyA moeda do preço atual, por exemplo: USD
current_bid_priceThe current bid price for this auction, for example: 28.99
bidsOs horários dos lances deste leilão, por exemplo: 5
biddersThe amount of people who take part in this auction bid, for example: 3
time_leftThe remaining time of this auction, for example: 11 hours, 30 min
start_timeA hora de início deste leilão, por exemplo: 2019/02/13 05:00 PST
start_time_stampThe start time stamp of this aucion, for example: 1550062850113
end_timeO horário de término deste leilão, por exemplo: 2019/02/20 05:00 PST
end_time_stampThe end time stamp of this auction, for example: 1550667650113
visitorsA quantidade de visitantes, por exemplo: 40
linksA quantidade de links, por exemplo: 365
ageA idade sobre este domínio, por exemplo: 2
estibot_appraisalThe price on estibot_appraisal for this domain, for example: $388.03

Exemplo de obtenção de lista do leilão

Solicitação

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

Resposta

{

"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 */},

...

Comando para obter item do leilão

If calling the "get auction Item" command, the following parameters should be included:

Obter parâmetro de solicitação de item do leilão
Explicação
domainThe auction details you want to request by domain to get

There will be 1 result for auction by domain under you request. The auction details will have some new fields compared with list conmand as below.The command now are supported auctions that have not ended and have ended within 1 hour

Obter campo de resultados de item do leilão
Explicação
accepted_bid_priceThe acceptable price to bid at this auction, for example: 33.99
is_high_bidderSe você deu o maior lance, por exemplo: true
auction_endedSe o leilão terminou, por exemplo: false
customer_bidedIf you has take part in this auction, for example: true
customer_bidO preço do seu lance, por exemplo: 33.99
customer_proxy_bidO preço do seu lance automático, por exemplo: $100
bidder_nameO nome do licitante, por exemplo: bidder 1
bid_priceO valor desse lance, por exemplo: 35.99
timestampThe timestamp when the bidder bid at this auction, for example: 1550637925300
bid_statusYour status at this auction,"high bidder" means you are the highest bidder,, for example: High Bidder
is_proxy_auto_bidSe esse lance for automático, por exemplo: false

Exemplo de obtenção de item do leilão

Solicitação

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

Resposta

{

"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 */},

...

Comando de Colocação de Lance no Leilão

If calling the "Place Auction Bid" command, the following parameters should be included:

Parâmetro de Solicitação de Colocação de Lance em Leilão
Explicação
domainO domínio do leilão no qual você deseja dar um lance
bid_priceA quantia que você deseja dar de lance, em dólar. Por exemplo, 85.99

If your bid is successful.There will be 1 result for auction is similar to get-auction-item command.

Exemplo de Colocação de Lance no Leilão

Solicitação

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

Resposta

{

"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 */},

...

Comando para obter lances do leilão

Obter campo de resultados de lances do leilão
Explicação
bid_idIf your request is successful.There will be some bids you have taken part in.There will be some fields as belowThe id for this bid, for example: 15
auction_idA id deste leilão, por exemplo: 5
account_idA id desta conta, por exemplo: 3
domainO domínio para esse leilão, por exemplo: domain-haha1.com
domain_utfO domain_utf deste leilão, por exemplo: domain-haha1.com
auction_typeThe auction type for this auction , for example: expired
is_idnSe este domínio é internacional, por exemplo: false
current_bidThe current bid price for this auction, for example: $33.99
your_statusO status do seu lance neste leilão, por exemplo: High Bidder
proxy_bidO preço do seu lance automático, por exemplo: $37.99
active_biddersThe amount of bidders at this domain auction , for example: 10
ends_onO horário de término do leilão, por exemplo: Feb 20, 2019 10:00am PST
end_timeO horário de término deste leilão, por exemplo: 2019/02/20 05:00:00 PST
end_time_stampThe end time stamp of this auction, for example: 1550667650113

If your request is successful,there will be some results as you see in the example section.

Exemplo de obtenção de lances do leilão

Solicitação

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

Resposta

{

"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 */},

...