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

تعد واجهة برمجة تطبيقات النطاقات أداة مهمة تساعدك على تحقيق أقصى استفادة من سوق نطاقاتنا. وتتيح لك هذه الواجهة الحصول على تفاصيل المزاد والمزايدة في مزادات النطاقات منتهية الصلاحية ومزادات المستخدم والمزايدة على طلبات الحجز المسبق. مع بعض الأوامر البسيطة عبر واجهة برمجة التطبيقات، يمكنك تحقيق أقصى استفادة من سوق دينادوت الثانوي. ومن ناحية أخرى، تتوفر واجهة برمجة تطبيقات النطاقات الخاصة بسوقنا لجميع الحسابات، لذا يمكنك البدء باستخدامها اليوم.
ابدأ باستخدام واجهة برمجة تطبيقات النطاقات الخاصة بنا
يتم إرسال الطلبات الموجهة إلى API مزاد دينادوت إلى الرابط التالي:
https://www.dynadot.com/auction-api/{command}
يرجى مراعاة ضرورة إرسال الطلبات عبر https (مأخذ توصيل آمن) لغرض الأمان. لا يمكن معالجة أكثر من 1 طلب/طلبات في نفس الوقت، لذا يرجى الانتظار حتى ينتهي الطلب الحالي قبل إرسال آخر. ينبغي أن يضم الطلب المعلمات التالية:
الشرح
تُرسل النتائج كنص json.
الشرح
success - نجح الأمر
error - لم يكن الأمر ناجحاً
أمر الحصول على قائمة المزاد
عند استدعاء أمر "الحصول على قائمة المزاد" يجب تضمين المعلمات التالية:
الشرح
سيكون هنالك many نتائج لقائمة المزاد التي تطلبها، وسيكون لكل مزاد عدة حقول كما يوجد أدناه
الشرح
مثال عن الحصول على قائمة المزاد
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" يجب تضمين المعلمات التالية:
الشرح
سيكون هنالك نتيجة 1 للمزاد حسب النطاق الذي تطلبه، وستحتوي تفاصيل المزاد على بعض الحقول الجديدة مقارنةً مع قائمة الأوامر الموضحة أدناه. يجب الآن دعم المزادات التي لم تنتهي بعد والمزادات التي انتهت في غضون ساعة واحدة أيضًا.
الشرح
مثال على 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" يجب تضمين المعلمات التالية:
الشرح
إذا نجحت مزايدتك فسيكون هنالك 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 */},
...
أمر الحصول على المزايدات
الشرح
إذا نجح طلبك، ستظهر النتائج كما ترى في قسم الأمثلة.
مثال الحصول على المزايدات
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 */},
...