API de Subastas de Dynadot (Beta)

Nuestra API de Subastas de Dynadot es una poderosa herramienta para ayudarte a aprovechar al máximo nuestro portal de dominios. La API te permite obtener detalles de la subasta y realizar pujas en nuestras subastas de dominios caducados, pedidos en espera y subastas de usuario. ¡Con unas pocas llamadas a la API, puedes aprovechar al máximo el mercado secundario de nombres de dominio de Dynadot! Nuestra API del portal está disponible para todas las cuentas, ¡así que comience hoy!

Comenzando con nuestra API de Subastas de Dynadot

Las solicitudes a nuestra API de Subastas de Dynadot se envían a la siguiente URL:

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

Toma en cuenta que se debe enviar solicitudes por https (conexión segura) para seguridad. Sólo se puede procesar 1 solicitudes a la vez, así que por favor espera que tu solicitud actual termine antes de enviar otra. Hay que incluir los siguientes parámetros en la solicitud:

Parámetro de solicitud
Explicación
api_keyTu clave para acceder el API, disponible en tu panel de control en tu cuenta
commandLos comandos admitidos actualmente son "get-auction-list", "get-auction-item", "place-auction-bid" y "get-auction-bids".
currency(optional)Puede decidir en qué moneda mostrar los datos de la subasta y este parámetro admite "USD", "CNY", "GBP", "EUR", "INR", "CAD", entre otros. Si omite este parámetro, utilizaremos USD

Los resultados se envían como un texto json.

Campo de Resultados
Explicación
statusEl resultado de esta llamada API:
success - el comando fue exitoso
error - el comando no tuvo éxito
contentMás información sobre el resultado, sólo se usa cuando el resultado sea "error"

Comando Obtener Lista de Subastas

Si llama al comando "obtener lista de subastas", se deben incluir los siguientes parámetros:

Parámetro de Solicitud Obtener Lista de Subasta
Explicación
auction_typeEl tipo de subasta que deseas solicitar, ahora se admiten los siguientes tipos "caducado", "usuario", "pedido en espera". Puedes solicitar uno o más tipos de subasta. Si hay más de dos tipos, debes usar "," para dividir cada tipo de subasta

Habrá many resultados para la lista de subastas que solicite. Cada subasta tendrá los campos indicados a continuación.

Obtener el Campo de Resultados de la Lista de Subastas
Explicación
auction_idEl parámetro auction_id (ID de subasta), por ejemplo: 1
domainEl nombre de dominio de esta subasta, por ejemplo: domain-haha1.cn
utf_nameEl nombre de dominio en formato UTF de esta subasta, por ejemplo: domain-haha1.cn
is_idnSi este dominio es un nombre de dominio internacional, por ejemplo: false
auction_typeEl tipo de esta subasta, por ejemplo: expired
currencyLa moneda actual del precio, por ejemplo: USD
current_bid_priceEl precio de la puja actual para esta subasta, por ejemplo: 28.99
bidsLos horas de las pujas sobre esta subasta, por ejemplo: 5
biddersLa cantidad de personas que participan en esta puja de subasta, por ejemplo: 3
time_leftEl tiempo restante de esta subasta, por ejemplo: 11 hours, 30 min
start_timeLa hora de inicio de esta subasta, por ejemplo: 2019/02/13 05:00 PST
start_time_stampLa marca de tiempo de inicio de esta acción, por ejemplo: 1550062850113
end_timeLa hora de finalización de este subasta, por ejemplo: 2019/02/20 05:00 PST
end_time_stampLa marca de tiempo de finalización de esta subasta, por ejemplo: 1550667650113
visitorsLa cantidad de visitantes, por ejemplo: 40
linksLa cantidad de enlaces, por ejemplo: 365
ageLa antigüedad de este dominio, por ejemplo: 2
estibot_appraisalEl precio en estibot_appraisal (evaluación de Estibot) para este dominio, por ejemplo: $388.03

Ejemplo de Obtener Lista de Subastas

Solicitud

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

Resultado

{

"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 Obtener Ítem de Subasta

Si llama al comando "obtener ítem de subasta", se deben incluir los siguientes parámetros:

Parámetro de Solicitud Obtener Ítem de Subasta
Explicación
domainLos detalles de la subasta que deseas solicitar por dominio a obtener

Habrá 1 resultado para la subasta por dominio bajo su solicitud. Los detalles de la subasta tendrán algunos campos nuevos en comparación con el comando listar como se muestra a continuación. El comando admite subastas que no han finalizado y aquellas que han finalizado en el lapso de 1 hora.

Campo de Resultado Obtener Ítem de subasta
Explicación
accepted_bid_priceEl precio aceptable para realizar una puja en esta subasta, por ejemplo: 33.99
is_high_bidderSi usted es el pujador con la puja más alta, por ejemplo: true
auction_endedSi la subasta ha finalizado, por ejemplo: false
customer_bidedSi has participado en esta subasta, por ejemplo: true
customer_bidEl precio de su puja, por ejemplo: 33.99
customer_proxy_bidSu precio de proxy_bid (puja máxima) por ejemplo: $100
bidder_nameEl nombre del pujador, por ejemplo: bidder 1
bid_priceEl monto de esta puja, por ejemplo: 35.99
timestampLa marca de tiempo cuando el pujador oferta en esta subasta, por ejemplo: 1550637925300
bid_statusSu estado en esta subasta, "mejor pujador" significa que usted es el pujador con la puja más alta, por ejemplo: High Bidder
is_proxy_auto_bidSi esta puja es proxy_bid (puja máxima), por ejemplo: false

Ejemplo Obtener Ítem de Subasta

Solicitud

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

Resultado

{

"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 Colocar Puja en Subasta

Si llama al comando "Colocar una Puja en Subasta", se deben incluir los siguientes parámetros:

Parámetros de Solicitud Colocar Puja en Subasta
Explicación
domainEl dominio de la subasta en la que desea colocar la puja.
bid_priceLa cantidad que desea ofertar, en dólares. p.ej. 85.99

Si su puja es exitosa. Habrá 1 resultado para la subasta similar al comando get-auction-item (obtener ítem de subasta).

Ejemplo Colocar Puja en Subasta

Solicitud

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

Resultado

{

"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 Obtener Pujas de Subasta

Campo de Resultado Obtener Pujas de Subasta
Explicación
bid_idSi su solicitud es exitosa. Habrá some pujas en las que ha participado. Habrá algunos campos como se muestra abajo. El ID de esta puja, por ejemplo: 15
auction_idEl id para esta subasta, por ejemplo: 5
account_idLa id para esta cuenta, por ejemplo: 3
domainEl dominio para esta subasta, por ejemplo: domain-haha1.com
domain_utfEl domain_utf (dominio en formato UTF) para esta subasta, por ejemplo: domain-haha1.com
auction_typeEl tipo de subasta para esta subasta, por ejemplo: expired
is_idnSi este dominio es internacional, por ejemplo: false
current_bidEl precio de la puja actual para esta subasta, por ejemplo: $33.99
your_statusEl estado de su puja en esta subasta, por ejemplo: High Bidder
proxy_bidSu precio de puja máxima, por ejemplo: $37.99
active_biddersLa cantidad de pujadores en esta subasta de dominio, por ejemplo: 10
ends_onLa hora de finalización de la subasta, por ejemplo: Feb 20, 2019 10:00am PST
end_timeLa hora de finalización de este subasta, por ejemplo: 2019/02/20 05:00:00 PST
end_time_stampLa marca de tiempo de finalización de esta subasta, por ejemplo: 1550667650113

Si su solicitud es exitosa, habrá algunos resultados como verá en la sección de ejemplos.

Ejemplo de Obtener Pujas de Subasta

Solicitud

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

Resultado

{

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

...