API d'Enchères Dynadot (Beta)

Notre API d'enchères Dynadot est un outil puissant pour vous aider à tirer le meilleur de notre marché de domaines. L'API vous permet d'obtenir des informations sur les enchères et de faire des offres sur nos enchères sur domaines expirés, domaines en attente et sur nos enchères utilisateurs. Grâce à quelques appels API simples, vous pouvez tirer le meilleur du marché Dynadot ! Notre API de Marché est disponible pour tous les comptes, alors lancez-vous sans attendre !

Commencez à Utiliser Notre API d'Enchères Dynadot

Les requêtes à notre API d'Enchères Dynadot sont envoyées à l'URL suivante:

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

Notez que les requêtes doivent être envoyées en https (socket sécurisée) pour la sécurité. Seul 1 requête peut être traitée à la fois, veuillez donc attendre que la requête en cours soit terminée avant d'en envoyer une autre. La requête doit contenir les paramètres suivants :

Paramètre de RequêteExplication

Paramètre de Requête
Explication

api_keyVotre clé pour accéder à l'API, disponible dans le tableau de bord de votre compte

commandLes commandes acceptés pour le moment sont "get-auction-list" , "get-auction-item","place-auction-bid" et "get-auction-bids"

currency(optional)Vous pouvez choisir la devise à afficher pour les données d'enchères et les valeurs supportées sont "USD","CNY", "GBP","EUR","INR","CAD". Si vous n'avez pas défini ce paramètre, USD sera utilisé.

Les résultats sont envoyés sous forme de texte json.

Champ de RésultatExplication

Champ de Résultat
Explication

statusRésultat de cet appel API:
success - la commande a réussi
error - la commande a échoué

contentPlus d'informations sur le résultat. Utilisé seulement quand le résultat est "error"

Commande Get Auction List

Lors d'un appel de la commande "get auction list", les paramètres suivants doivent être inclus :

Paramètre de Requête Get Auction ListExplication

Paramètre de Requête Get Auction List
Explication

auction_typeLe type d'enchère que vous voulez obtenir, "expired", "user", "backorder" (domaines expirés, utilisateur, domaines en attente). Vous pouvez demander un ou plusieurs types d'enchères. S'il y a plus de deux types, vous devez utiliser "," pour séparer chaque type d'enchère.

Il y aura many résultats pour la liste d'enchères que vous demandez. Chaque enchère contiendra les champs ci-dessous

Champ de Résultat de Get Auction ListExplication

Champ de Résultat de Get Auction List
Explication

auction_idLe paramètre auction_id, par exemple : 1

domainLe nom de domaine de cette enchère, par exemple : domain-haha1.cn

utf_nameLe nom de domaine utf de cette enchère, par exemple : domain-haha1.cn

is_idnSi ce domaine est un nom de domaine international, par exemple : false

auction_typeLe type de cette enchère, par exemple : expired

currencyLa devise du prix actuel, par exemple : USD

current_bid_priceLe montant de l'offre actuelle pour cette enchère, par exemple : 28.99

bidsLe nombre d'offres pour cette enchère, par exemple : 5

biddersLe nombre de personne qui prennent part à cette enchère, par exemple : 3

time_leftLe temps restant pour cette enchère, par exemple : 11 hours, 30 min

start_timeL'heure de début de cette enchère, par exemple : 2019/02/13 05:00 PST

start_time_stampLa date de début de cette enchère, par exemple : 1550062850113

end_timeLa date de fin de cette enchère, par exemple : 2019/02/20 05:00 PST

end_time_stampLa date de fin de cette enchère, par exemple : 1550667650113

visitorsLe nombre de visiteurs, par exemple : 40

linksLe nombre de liens, par exemple : 365

ageL'âge de ce domaine, par exemple : 2

estibot_appraisalLe prix de ce domaine sur estibot_appraisal, par exemple : $388.03

Exemple de Get Auction List

Requête

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

Réponse

{

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

...

Commande Get Auction Item

Lors d'un appel de la commande "get auction item", les paramètres suivants doivent être inclus :

Paramètre de Requète Get Auction ItemExplication

Paramètre de Requète Get Auction Item
Explication

domainLes informations d'enchère que vous voulez obtenir par domaine

Il y aura 1 résultat d'enchère par domaine de votre requête. Les informations d'enchère comporteront certains champs nouveaux, voir ci-dessous. Les commandes s'appliquent aux enchères qui ne sont pas terminées et qui sont terminées depuis 1 heure

Champ de Résultat de Get Auction ItemExplication

Champ de Résultat de Get Auction Item
Explication

accepted_bid_priceLe montant acceptable d'une offre pour cette enchère, par exemple : 33.99

is_high_bidderSi votre offre est la plus élevée, par exemple : true

auction_endedSi l'enchère est terminée, par exemple : false

customer_bidedSi vous avez pris part à cette enchère, par exemple : true

customer_bidLe montant de votre offre, par exemple : 33.99

customer_proxy_bidVotre prix d'enchère par procuration (proxy_bid), par exemple : $100

bidder_nameLe nom de l'enchérisseur, par exemple : bidder 1

bid_priceLe montant de cette enchère, par exemple : 35.99

timestampLa date et l'heure d'une offre passée dans cette enchère, par exemple : 1550637925300

bid_statusVotre statut pour cette enchère, "high bidder" signifie que vous avez fait l'offre la plus élevée, par exemple : High Bidder

is_proxy_auto_bidSi cette offre est une enchère par procuration (prox_bid), par exemple : false

Exemple de Get Auction Item

Requête

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

Réponse

{

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

...

Commande Place Auction Bid (Enchérir)

Pour la commande "Place Auction Bid", les paramètres suivants doivent être inclus :

Paramètre de Requête Place Auction BidExplication

Paramètre de Requête Place Auction Bid
Explication

domainLe domaine de l'enchère sur lequel vous voulez enchérir

bid_priceLe montant de l'offre que vous voulez faire, en dollars. Par ex 85.99

Si votre offre est réussie. Il y aura un résultat 1 pour l'enchère, similaire à la commande get-auction-item.

Exemple Place Auction Bid

Requête

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

Réponse

{

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

...

Commande Get Auction Bids

Champ de Résultat de Get Auction BidsExplication

Champ de Résultat de Get Auction Bids
Explication

bid_idSi votre requète est réussie. Il y aura some enchères auxquelles vous participez. Il y aura quelques champs, tels que ci-dessous. L'id pour cette enchère, par exemple : 15

auction_idL'id de cette enchère, par exemple : 5

account_idL'id pour ce compte, par exemple : 3

domainLe domaine de cette enchère, par exemple : domain-haha1.com

domain_utfLe domain_utf pour cette enchère, par exemple : domain-haha1.com

auction_typeLe type d'enchère de cette enchère, par exemple : expired

is_idnSi ce domaine est international, par exemple : false

current_bidLe montant de l'offre actuelle pour cette enchère, par exemple : $33.99

your_statusVotre statut dans cette enchère, par exemple : High Bidder

proxy_bidLe montant de votre enchère par procuration, par exemple : $37.99

active_biddersLe nombre d'enchérisseurs à cette enchère de domaine, par exemple : 10

~~ends_onLa date et l'heure de fin de cette enchère, par exemple : Feb 20, 2019 10:00am PST~~

end_timeLa date de fin de cette enchère, par exemple : 2019/02/20 05:00:00 PST

end_time_stampLa date de fin de cette enchère, par exemple : 1550667650113

Si votre requête est réussie, vous obtiendrez des résultats comme dans l'exemple.

Exemple de Get Auction Bids

Requête

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

Réponse

{

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

...