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 solicitudExplicación

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 ResultadosExplicación

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 SubastaExplicación

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 SubastasExplicació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 SubastaExplicación

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 subastaExplicación

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 SubastaExplicación

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 SubastaExplicación

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

...