Dynadot Auktions-API

Unsere Dynadot Auktions-API ist ein leistungsstarkes Tool, mit dem Sie unseren Domain-Marktplatz optimal nutzen können. Mit der API können Sie Auktionsdetails abrufen und Gebote für unsere abgelaufenen Domain-Auktionen, Rückstände und Nutzerauktionen abgeben. Mit ein paar einfachen API-Aufrufen können Sie den Dynadot-Ersatzteilmarkt optimal nutzen! Unsere Marketplace-API ist für alle Konten verfügbar. Starten Sie also noch heute!

Starten Sie mit unserer Dynadot Auktions-API

Anfragen an unsere Dynadot Auktions-API werden an folgende URL gesendet:

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

Bitte beachten Sie, dass Anfragen aus Sicherheitsgründen über https (secure Socket) geschickt werden sollten. Nur 1-Anfrag kann gleichzeitig durchgeführt werden, warten Sie also bitte, bis die aktuelle Anfrage beendet ist, bevor Sie eine weitere Anfrage absenden. Die Anfrage sollte die folgenden Parameter enthalten:

Anfrageparameter
Erklärung
api_keyIhr API-Schlüssel, erhältlich im Controlpanel Ihres Kontos
commandDie momentan unterstützten Befehle sind "Get-Auction-List", "Get-Auction-Item", "Place-Auction-Gebot" und "Get-Auction-Gebote".
currency(optional)Sie können entscheiden, welche Währung für die Anzeige der Auktionsdaten verwendet werden soll. Diese Parameter werden unterstützt: "USD", "CNY", "GBP", "EUR", "INR", "CAD" usw. Wenn Sie diesen Parameter nicht angegeben haben, werden wir USD anzeigen

Die Ergebnisse werden als JSON-Text gesendet.

Ergebnisfeld
Erklärung
statusDas Ergebnis dieses API-Aufrufs:
success - der Befehl war erfolgreich
error - der Befehl war nicht erfolgreich
contentWeitere Informationen über das Ergebnis; wird nur beim Ergebnis "Fehler" genutzt

Get Auction List Befehl

Bei Aufruf des Befehls "get auction list" sollten folgende Parameter enthalten sein:

Get Auction List Anfrageparameter
Erklärung
auction_typeDer Auktionstyp, den Sie anfordern möchten. Aktuell unterstützt werden "abgelaufen", "Benutzer", "Rückstand". Sie können eine oder mehrere Auktionstypen anfordern. Wenn es mehr als zwei Arten gibt, müssen Sie "," verwenden, um jede Auktion aufzuteilen Art

Es gibt many Ergebnisse für die angeforderte Auktionsliste. Jede Auktion hat die unten genannten Felder

Get Auction List Ergebnisfeld
Erklärung
auction_idDer Parameter auction_id, zum Beispiel: 1
domainDer Domainname dieser Auktion, zum Beispiel: domain-haha1.cn
utf_nameDer utf Domainname dieser Auktion, zum Beispiel: domain-haha1.cn
is_idnOb diese Domain ein internationaler Domainname ist, zum Beispiel: false
auction_typeDer Typ dieser Auktion, zum Beispiel: expired
currencyDie aktuelle Währung, zum Beispiel: USD
current_bid_priceDer aktuelle Gebotspreis für diese Auktion, zum Beispiel: 28.99
bidsDie Gebot-Zeiten dieser Auktion, zum Beispiel: 5
biddersDie Anzahl der Personen, die an dieser Auktion teilnehmen, zum Beispiel: 3
time_leftDie verbleibende Zeit dieser Auktion, zum Beispiel: 11 hours, 30 min
start_timeDie Startzeit dieser Auktion, zum Beispiel: 2019/02/13 05:00 PST
start_time_stampStempel der Startzeit dieser Auktion, zum Beispiel: 1550062850113
end_timeEndzeit dieser Auktion, zum Beispiel: 2019/02/20 05:00 PST
end_time_stampDer Endzeit-Stempel dieser Auktion, zum Beispiel: 1550667650113
visitorsDie Anzahl der Besucher, zum Beispiel: 40
linksDie Anzahl an Links, zum Beispiel: 365
ageDas Alter dieser Domain, zum Beispiel: 2
estibot_appraisalDer Preis bei estibot_appraisal für diese Domain, zum Beispiel: $388.03

Get Auction List Beispiel

Anfrage

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

Antwort

{

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

...

Get Auction Item Befehl

Beim Aufruf des Befehls "get auction item" sollten folgende Parameter enthalten sein:

Get Auction Item Anfrageparameter
Erklärung
domainDie Auktionsdetails, die Sie nach Domain anfragen möchten zum Erhalt von

Es wird ein 1 Ergebnis für die Auktion nach Domain unter Ihrer Anfrage geben. Die Auktionsdetails haben im Vergleich zum Listenbefehl einige neue Felder. Der Befehl ist jetzt unterstützte Auktionen, die noch nicht beendet sind und innerhalb einer Stunde enden

Get Auction Item Ergebnisfeld
Erklärung
accepted_bid_priceDer annehmbare Preis, um bei dieser Auktion zu bieten, zum Beispiel: 33.99
is_high_bidderWenn Sie der Höchstbietende sind, zum Beispiel: true
auction_endedOb die Auktion beendet ist, zum Beispiel: false
customer_bidedWenn Sie an dieser Auktion teilnehmen, zum Beispiel: true
customer_bidIhr Gebot, zum Beispiel: 33.99
customer_proxy_bidIhr proxy_bid Preis, zum Beispiel: $100
bidder_nameDer Name des Bieters, zum Beispiel: bidder 1
bid_priceDie Höhe dieses Gebots, zum Beispiel: 35.99
timestampDer Zeitstempel, wenn der Bieter bei dieser Auktion ein Gebot abgibt, zum Beispiel: 1550637925300
bid_statusIhr Status in dieser Auktion. "Höchstbietender" bedeutet, das Sie das höchste Gebot abgegeben haben, zum Beispiel: High Bidder
is_proxy_auto_bidWenn es ein proxy_bid ist, zum Beispiel: false

Get Auction Item Beispiel

Anfrage

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

Antwort

{

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

...

Platzieren Sie ein Auktionsangebot ab

Beim Aufruf des Befehls "Place Auction Bid" sollten folgende Parameter enthalten sein:

Anfrageparameter place auction bid
Erklärung
domainDie Domain der Auktion, bei der Sie ein Gebot abgeben möchten
bid_priceDer Betrag in Dollar, den Sie bieten möchten, z. B. 85.99

Wenn Ihr Gebot erfolgreich ist. Es gibt das 1-Ergebnis für die Auktion, ähnlich wie der Befehl get-auction-item.

Beispiel für place auction bid

Anfrage

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

Antwort

{

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

...

Get Auction Bids Befehl

Get Auction Bids Ergebnisfeld
Erklärung
bid_idWenn Ihre Anfrage erfolgreich war. Es gibt some Gebote, an denen Sie teilgenommen haben. Es werden einige Felder wie unten angegeben.Die ID für dieses Gebot ist beispielsweise: 15
auction_idDie ID für diese Auktion, zum Beispiel: 5
account_idDie ID für dieses Konto, zum Beispiel: 3
domainDie Domain für diese Auktion, zum Beispiel: domain-haha1.com
domain_utfDie domain_utf für diese Auktion, zum Beispiel: domain-haha1.com
auction_typeDer Auktionstyp für diese Auktion, zum Beispiel: expired
is_idnOb diese Domain international ist, zum Beispiel: false
current_bidDer aktuelle Gebotspreis für diese Auktion, zum Beispiel: $33.99
your_statusDer Status Ihres Gebots in dieser Auktion, zum Beispiel: High Bidder
proxy_bidIhr Proxy-Gebot: zum Beispiel: $37.99
active_biddersDie Anzahl an Bietern bei dieser Domain-Auktion, zum Beispiel: 10
ends_onDie Endzeit für die Auktion, zum Beispiel: Feb 20, 2019 10:00am PST
end_timeEndzeit dieser Auktion, zum Beispiel: 2019/02/20 05:00:00 PST
end_time_stampDer Endzeit-Stempel dieser Auktion, zum Beispiel: 1550667650113

Wenn Ihre Anfrage erfolgreich ist, gibt es einige Ergebnisse, wie Sie an den Beispielen sehen können.

Get Auction Bids Beispiel

Anfrage

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

Antwort

{

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

...