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

...