واجهة برمجة تطبيقات مزادات دينادوت (تجريبي)

تعد واجهة برمجة تطبيقات النطاقات أداة مهمة تساعدك على تحقيق أقصى استفادة من سوق نطاقاتنا. وتتيح لك هذه الواجهة الحصول على تفاصيل المزاد والمزايدة في مزادات النطاقات منتهية الصلاحية ومزادات المستخدم والمزايدة على طلبات الحجز المسبق. مع بعض الأوامر البسيطة عبر واجهة برمجة التطبيقات، يمكنك تحقيق أقصى استفادة من سوق دينادوت الثانوي. ومن ناحية أخرى، تتوفر واجهة برمجة تطبيقات النطاقات الخاصة بسوقنا لجميع الحسابات، لذا يمكنك البدء باستخدامها اليوم.

ابدأ باستخدام واجهة برمجة تطبيقات النطاقات الخاصة بنا

يتم إرسال الطلبات الموجهة إلى API مزاد دينادوت إلى الرابط التالي:

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

يرجى مراعاة ضرورة إرسال الطلبات عبر https (مأخذ توصيل آمن) لغرض الأمان. لا يمكن معالجة أكثر من 1 طلب/طلبات في نفس الوقت، لذا يرجى الانتظار حتى ينتهي الطلب الحالي قبل إرسال آخر. ينبغي أن يضم الطلب المعلمات التالية:

معلمة الطلب
الشرح
api_keyمفتاحك للوصول إلى API، يوجد على لوحة التحكم في حسابك
commandالأوامر المدعومة الآن هي: "get-auction-list" و "get-auction-item" و"place-auction-bid" و"get-auction-bids"
currency(optional)يمكنك تحديد العملة التي ترغب بها لعرض بيانات المزاد، وهذه المعلمات المدعومة هي "USD" و"CNY" و"GBP" و"EUR" و"INR" و"CAD" وغيرها. إذا لم تستخدم هذه المعلمة فإننا سنستخدم الدولار.

تُرسل النتائج كنص json.

حقل النتيجة
الشرح
statusنتيجة طلب هذا الـ API :
success - نجح الأمر
error - لم يكن الأمر ناجحاً
contentمعلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'

أمر الحصول على قائمة المزاد

عند استدعاء أمر "الحصول على قائمة المزاد" يجب تضمين المعلمات التالية:

معلمة طلب الحصول على قائمة المزاد
الشرح
auction_typeنوع المزاد الذي ترغب بطلبه ومدعوم حالياً: "منتهي الصلاحية" و"المستخدم" و"طلب الحجز المسبق". يمكنك طلب نوع واحد أو أكثر من أنواع المزادات، وإذا كان هنالك أكثر من نوعين فيجب عليك استخدام "," لفصل كل نوع على حدى

سيكون هنالك many نتائج لقائمة المزاد التي تطلبها، وسيكون لكل مزاد عدة حقول كما يوجد أدناه

حقل الحصول على نتيجة المزاد
الشرح
auction_idمعلمة auction_id هي على سبيل المثال: 1
domainاسم النطاق لهذا المزاد هو على سبيل المثال: domain-haha1.cn
utf_nameاسم النطاق المطابق لصيغة التحويل الموحد في هذا المزاد، على سبيل المثال: domain-haha1.cn
is_idnإذا كان هذا النطاق هو اسم نطاق دولي، على سبيل المثال: false
auction_typeنوع هذا المزاد هو على سبيل المثال: expired
currencyعملة السعر الحالية هي على سبيل المثال: USD
current_bid_priceسعر العرض الحالي في هذا المزاد هو على سبيل المثال: 28.99
bidsأوقات عرض الأسعار لهذا المزاد هي على سبيل المثال: 5
biddersعدد الأشخاص المشاركين في هذا المزاد، على سبيل المثال: 3
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عدد الزوار هو على سبيل المثال: 40
linksعدد الروابط هو على سبيل المثال: 365
ageعمر هذا النطاق، على سبيل المثال: 2
estibot_appraisalالسعر على estibot_appraisal من أجل هذا النطاق هو على سبيل المثال: $388.03

مثال عن الحصول على قائمة المزاد

الطلب

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

الاستجابة

{

"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" يجب تضمين المعلمات التالية:

معلمة طلب Get Auction Item
الشرح
domainتفاصيل المزاد التي تريد الحصول عليها حسب اسم النطاق

سيكون هنالك نتيجة 1 للمزاد حسب النطاق الذي تطلبه، وستحتوي تفاصيل المزاد على بعض الحقول الجديدة مقارنةً مع قائمة الأوامر الموضحة أدناه. يجب الآن دعم المزادات التي لم تنتهي بعد والمزادات التي انتهت في غضون ساعة واحدة أيضًا.

حقل نتيجة Get Auction Item
الشرح
accepted_bid_priceالسعر المقبول للمزايدة في هذا المزاد هو على سبيل المثال: 33.99
is_high_bidderإذا كنت صاحب أعلى مزايدة، على سبيل المثال: true
auction_endedإذا انتهى المزاد على سبيل المثال: false
customer_bidedإذا شاركت في هذا المزاد، على سبيل المثال: true
customer_bidسعر المزايدة لديك هو على سبيل المثال: 33.99
customer_proxy_bidسعر المزايدة بالوكالة لديك هو على سبيل المثال: $100
bidder_nameاسم المزايد هو على سبيل المثال: bidder 1
bid_priceمقدار هذه المزايدة هو على سبيل المثال: 35.99
timestampالوقت الذي يقوم فيه المزايد بالمزايدة، على سبيل المثال: 1550637925300
bid_statusحالتك في هذا المزاد هي "المزايد الأعلى" وهذا يعني أنك صاحب أعلى مزايدة هنا، على سبيل المثال: High Bidder
is_proxy_auto_bidإذا كانت هذه المزايدة هي مزايدة_بالوكالة، على سبيل المثال: false

مثال على Get Auction Item

الطلب

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

الاستجابة

{

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

...

أمر إرسال عرض في مزاد

عند استدعاء أمر "Place Auction Bid" يجب تضمين المعلمات التالية:

معلمة طلب إرسال عرض في مزاد
الشرح
domainنطاق المزاد الذي ترغب بالمزايدة ضمنه
bid_priceالمبلغ الذي ترغب بالمزايدة به هو على سبيل المثال 85.99 دولار

إذا نجحت مزايدتك فسيكون هنالك 1 نتائج للمزاد مماثلة للأمر get-auction-item.

مثال لإرسال عرض في مزاد

الطلب

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

الاستجابة

{

"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
الشرح
bid_idإذا نجح طلبك فسيكون هنالك some المزايدات التي يمكنك المشاركة فيها، كما سيكون هنالك بعض الحقول التي تعرّف المزايدة كما في أدناه، فعلى سبيل المثال: 15
auction_idمعرّف هذا المزاد على سبيل المثال: 5
account_idمعرّف هذا الحساب هو على سبيل المثال: 3
domainنطاق هذا المزاد هو على سبيل المثال: domain-haha1.com
domain_utfutf_النطاق من أجل هذا المزاد هو على سبيل المثال: domain-haha1.com
auction_typeنوع هذا المزاد هو على سبيل المثال: expired
is_idnإذا كان هذا النطاق عالميًا، على سبيل المثال: false
current_bidسعر العرض الحالي في هذا المزاد هو على سبيل المثال: $33.99
your_statusحالة مزايدتك في هذا المزاد هي على سبيل المثال: High Bidder
proxy_bidسعر المزايدة بالوكالة الخاص بك، على سبيل المثال: $37.99
active_biddersعدد المزايدين في مزاد النطاقات، على سبيل المثال: 10
ends_onوقت انتهاء هذا المزاد هو على سبيل المثال: Feb 20, 2019 10:00am PST
end_timeوقت انتهاء هذا المزاد هو على سبيل المثال: 2019/02/20 05:00:00 PST
end_time_stampانتهى وقت هذا المزاد، على سبيل المثال: 1550667650113

إذا نجح طلبك، ستظهر النتائج كما ترى في قسم الأمثلة.

مثال الحصول على المزايدات

الطلب

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

الاستجابة

{

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

...