API de leilões Dynadot (Beta)

Nosso Leilão API Dynadot é uma poderosa ferramenta que ajuda a aproveitar o máximo do nosso mercado de domínio. O API permite que você consiga os detalhes dos lances do leilão nos nossos leilões de domínios expirados e leilões de usuários. Com alguns simples comandos API você pode aproveitar ao máximo o mercado da Dynadot. Nosso Mercado API está disponível para todas as contas, então comece agora!

Comece a usar a API do leilão Dynadot

Os pedidos para nosso Leilão API Dynadot são enviados para a seguinte 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.
commandOs comandos suportados agora são "encontrar-lista-de-leilão", "encontrar-item-em-leilão", "fazer-oferta-em-leilão" e "ver-ofertas-de-leilão"
currency(optional)Você pode decidir que moeda mostrar para dados de leilão as moedas suportadas por este parâmetro são "USD","CNY", "GBP","EUR","INR","CAD" e muito mais. Se você não definir este parâmetro, nós usaremos USD como padrão

Os resultados são enviados como um texto json.

Campo de Resultado
Explicação
statusO resultado desta chamada API:
success - o comando foi realizado com sucesso
error - o comando não foi bem-sucedido
contentMais informações sobre o resultado, usado somente quando o resultado é um "erro"

Comando para obter lista do leilão

Ao fazer o comando "encontrar uma lista de leilão", os seguintes parâmetros devem estar inclusos:

Obter parâmetro de solicitação da lista de leilões
Explicação
auction_typeO tipo de leilão que você quer pedir suportados agora são "de expirados", "de usuários", "de pedidos abertos". Você tem como pedir um ou mais tipos de leilões se estão mais do que dois tipos, você deve usar "," para separar cada tipo de leilão

Haverá many resultados por lista de leilão que você pedir. Cada leilão terá campos como mostrado abaixo

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_nameO nome de domínio utf desde leilão, por exemplo: domain-haha1.cn
is_idnSe este domínio é um nome de domínio internacional, por exemplo: false
auction_typeO tipo desse leilão, por exemplo: expired
currencyA moeda do preço atual, por exemplo: USD
current_bid_priceO lance atual para este leilão, por exemplo: 28.99
bidsOs horários dos lances deste leilão, por exemplo: 5
biddersA quantidade de pessoas que fizeram parte neste lance de leilão, por exemplo: 3
time_leftO tempo restante deste leilão, por exemplo: 11 hours, 30 min
start_timeA hora de início deste leilão, por exemplo: 2019/02/13 05:00 PST
start_time_stampO tempo de início deste leilão, por exemplo: 1550062850113
end_timeO horário de término deste leilão, por exemplo: 2019/02/20 05:00 PST
end_time_stampO tempo para o fim desse leilão, por exemplo: 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_appraisalO preço na avaliação_estibot para este domínio, por exmplo: $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

Ao fazer o comando "procurar item de leilão", os seguintes parâmetros devem ser inclusos:

Obter parâmetro de solicitação de item do leilão
Explicação
domainOs detalhes do leilão que quer pedir para o domínio a encontrar

Have´ra 1 resultados por leilão por domínio no seu pedido. Os detalhes da seção terá sempre alguns campos comparados com a lista de comandos abaixo. Os comandos suportados para leilões que não se encerraram e que tenham terminado em 1 hora

Obter campo de resultados de item do leilão
Explicação
accepted_bid_priceO preço aceitável para lances nesse leilão, por exemplo: 33.99
is_high_bidderSe você deu o maior lance, por exemplo: true
auction_endedSe o leilão terminou, por exemplo: false
customer_bidedSe você fez parte deste leilão, por exemplo: 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
timestampA data de quando este lance foi dado neste leilão, por exemplo: 1550637925300
bid_statusSeu status neste leilão foi de "ofertante alto" significa que você foi aquele que fez ofertas mais altas, por exemplo: 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

Ao fazer um comando de "Fazer um Lance de Leilão", os seguintes parâmetros devem ser inclusos:

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

Se seu lance for bem-sucedido. Haverá 1 resultados por leilão similar ao comando encontrar_item-no-leilão

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_idSe seu pedido for bem-sucedido. Haverá some lances que você fez parte. Haverá alguns campos como abaixo o id deste lance, por exemplo: 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_typeO tipo deste leilão, por exemplo:expired
is_idnSe este domínio é internacional, por exemplo: false
current_bidO lance atual para este leilão, por exemplo: $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_biddersA quantidade de ofertantes neste leilão de domínio, por exemplo: 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_stampO tempo para o fim desse leilão, por exemplo: 1550667650113

Se seu pedido for bem-sucedido, haverá alguns resultados assim como pode ser visto na seção de exemplo.

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

...