النطاقات

قائمة أوامر API النطاق

واجهة برمجة التطبيقات (API) الخاصة بنا هي مجموعة أدواتك المتقدمة لإدارة النطاقات واقتنائها، والمصممة لتحقيق الكفاءة. مع أكثر من 50 أمرًا للإعداد والإدارة والتسجيل والمزايدة عبر منصة Dynadot، ستحصل على تحكم كامل في حسابك وإعدادات نطاقك على أي برنامج API تختاره. واجهة برمجة التطبيقات للنطاقات متاحة لجميع الحسابات، لذا ابدأ اليوم!

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

واجهة API القديمة, مجدولة للإيقاف. يرجى استخدام RESTful API الخاصة بنا بدلاً منها:

https://www.dynadot.com/domain/api-document

يتم إرسال الطلبات إلى واجهة برمجة التطبيقات المتقدمة للنطاقات الخاصة بنا إلى عنوان URL التالي:

https://api.dynadot.com/api3.xml

يجب إرسال الطلبات عبر https (مقبس آمن) للأمان. يجب أن يحتوي الطلب على المعاملين التاليين, 'مفتاح' و 'أمر'. يمكن النقر على كل أمر لرؤية المعاملات المرتبطة به.

ستتلقى أعدادًا مختلفة من الخيوط بناءً على مستوى الإنفاق لحسابك:

مستوى الإنفاقعدد الخيوطحد المعدل
عاديخيط واحد60/دقيقة (1/ثانية)
حساب Bulk5 مواضيع600/دقيقة (10/ثانية)
الجملة الفائقة35 خيطًا6000/دقيقة (100/ثانية)

 
معامل الطلب
شرح
Keyمفتاحك للوصول إلى API، متاح في لوحة التحكم بحساب Dynadot تحت قائمة 'Tools' -> 'API' الجانبية.
Command
النطاق:
search, register, delete, renew, push, transfer, bulk_register, restore

domain_info, set_whois, set_ns, set_parking, set_forwarding, set_stealth, set_hosting, set_dns2, set_email_forward, set_clear_domain_setting, set_folder, set_note, set_renew_option, set_privacy, tld_price, list_domain, lock_domain, suggestion_search, set_dnssec, get_dnssec, clear_dnssec

cancel_transfer, get_transfer_status, set_transfer_auth_code, authorize_transfer_away, get_transfer_auth_code

get_domain_push_request, set_domain_push_request
جهة الاتصال:
create_cn_audit, get_cn_audit_status, create_contact, edit_contact, delete_contact, contact_list, get_contact

set_contact_eu_setting, set_contact_lv_setting, set_contact_lt_setting
خادم الأسماء:
get_ns, add_ns, register_ns, set_ns_ip, delete_ns, delete_ns_by_domain, server_list, get_dns
الحساب:
account_info, get_account_balance, set_default_whois, set_default_ns, set_default_parking, set_default_forwarding, set_default_stealth, set_default_hosting, set_default_dns, set_default_dns2, set_default_email_forward, set_clear_default_setting, set_default_renew_option
Folder:
create_folder, delete_folder, set_folder_whois, set_folder_ns, set_folder_parking, set_folder_forwarding, set_folder_stealth, set_folder_hosting, set_folder_dns, set_folder_dns2, set_folder_email_forward, set_clear_folder_setting, set_folder_name, set_folder_renew_option, folder_list
السوق الثانوي:
add_backorder_request, delete_backorder_request, backorder_request_list

get_open_auctions, get_auction_details, get_auction_bids, place_auction_bid, get_closed_auctions

get_open_backorder_auctions, get_backorder_auction_details, place_backorder_auction_bid, get_closed_backorder_auctions, get_expired_closeout_domains, buy_expired_closeout_domain, get_listings, get_listing_item, buy_it_now, add_new_lead
أخرى:
set_afternic_confirm_action, set_sedo_confirm_action, get_whois_stats, order_list, set_for_sale, get_order_status, is_processing, transfer_out_domain_list, list_coupons, download_all_listings

تنسيق XML. يجب أن تحتوي الاستجابة التي تتلقاها على 2 أو 3 من الحقول التالية:

وسم XML للنتيجة
شرح
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
 

أمر البحث

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر البحث, فيجب تضمين المعلمات التالية:

معامل طلب البحث
شرح
domain0 - domain99اسم النطاق الذي تبحث عنه، يمكن للحساب العادي تحديد نطاق واحد لكل أمر، ويمكن لحساب الجملة والحساب فائق الجملة تحديد ما يصل إلى 100 نطاق
language0 - language99 (optional)وسم اللغة الخاص بالنطاق المعني، استخدم هذا فقط للنطاقات الدولية IDNs
show_price (optional)إذا كنت تريد عرض السعر بعملة حسابك، فاضبطه على "1". إذا كان النطاق متاحًا، فسيتم عرض تفاصيله المميزة ومعلومات السعر.
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
وسم XML للنتيجة
شرح
<Results></Results>العقدة الجذرية لاستجابة XML لأمر البحث
<SearchResponse></SearchResponse>وسم استجابة البحث
<SearchHeader></SearchHeader>وسم رأس البحث
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<DomainName></DomainName>اسم النطاق الذي بحثت عنه للتو
<Available></Available>إذا كان اسم النطاق متاحًا
<Price></Price>إذا قمت بتعيين "show_price" لتساوي "1"، فسيخبرك بمعلومات السعر إذا كان هذا النطاق متاحًا.
<Language></Language>معلومات اللغة حول اسم النطاق

مثال البحث

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
الاستجابة (تنسيق XML)
<Results>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.com</DomainName>
      <Available>yes</Available>
      <Price>77.00 in USD</Price>
    </SearchHeader>
  </SearchResponse>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.net</DomainName>
      <Available>yes</Available>
      <Price>44.00 in USD and domain is not premium</Price>
    </SearchHeader>
  </SearchResponse>
</Results>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
الاستجابة (تنسيق JSON)
{
   "SearchResponse":{
      "ResponseCode":"0",
      "SearchResults":[
         {
            "DomainName":"mydomain.com",
            "Available":"yes",
            "Price":"77.00 in USD"
         },
         {
            "DomainName":"mydomain.net",
            "Available":"yes",
            "Price":"44.00 in USD"
         }
      ]
   }
}
 

أمر تسجيل

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر التسجيل سينشئ ويعالج طلب تسجيل. يجب أن يكون لديك رصيد حساب كافٍ لدفع ثمن الطلب. إذا قمت باستدعاء أمر التسجيل، يجب تضمين المعلمات التالية:

معلمة طلب التسجيل
شرح
domainاسم النطاق الذي تريد تسجيله, يمكن تسجيل نطاق واحد فقط لكل طلب
language (optional)علامة اللغة للنطاق المطلوب, تكون مطلوبة فقط إذا كان النطاق IDN
durationكم مدة تسجيل النطاق
registrant_contact (optional)جهة اتصال المسجل التي تريد استخدامها على النطاق
admin_contact (optional)جهة الاتصال الإدارية التي تريد استخدامها على النطاق
technical_contact (optional)جهة الاتصال الفنية التي تريد استخدامها للنطاق
billing_contact (optional)جهة اتصال الفوترة التي تريد استخدامها على النطاق
option0 (if necessary)
اسم المسجّل في .AT, .BE
option1 (if necessary).AT, .BE, منظمة المسجّل (اختياري)
بالنسبة لـ .AT، يمكنك تحديد إما option0، أو option1، أو كليهما
premium (optional)إذا أردت تسجيل نطاق بريميوم، فاضبطه على "1" (اختياري)
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
وسم XML للنتيجة
شرح
<RegisterResponse></RegisterResponse>وسم استجابة التسجيل
<RegisterHeader></RegisterHeader>وسم ترويسة التسجيل
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<RegisterContent></RegisterContent>وسم محتوى التسجيل
<Expiration></Expiration>تاريخ الانتهاء بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"
<Registration></Registration>تاريخ التسجيل بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"

تسجيل مثال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=register&domain=domain1.net&duration=3&currency=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=register&domain=domain1.net&duration=3&currency=USD
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=register&domain=domain1.net&duration=3&currency=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=register&domain=domain1.net&duration=3&currency=USD
الاستجابة (تنسيق JSON)
{
  "RegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainName": "domain1.net",
    "Expiration": 1458379145266
  }
}
 

أمر الحذف

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء الأمر delete إلى حذف نطاق لا يزال في فترة السماح. سيتم إعادة رصيد حسابك بقيمة رسوم التسجيل. النطاقات التي تم تجديدها, أو التي تم نقلها إلى حساب جديد لا يمكن حذفها عبر API. إذا قمت باستدعاء الأمر delete, يجب تضمين المعاملات التالية:

معلمة طلب الحذف
شرح
domainاسم النطاق الذي تريد حذفه، يمكن حذف نطاق واحد فقط لكل طلب
وسم XML للنتيجة
شرح
<DeleteResponse></DeleteResponse>وسم استجابة الحذف
<DeleteHeader></DeleteHeader>وسم رأس الحذف
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال الحذف

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete&domain=domain1.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete&domain=domain1.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResponse>
  <DeleteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteHeader>
</DeleteResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete&domain=domain1.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete&domain=domain1.com
الاستجابة (تنسيق JSON)
{
  "DeleteResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainName": "domain1.com"
  }
}
 

أمر التجديد

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء أمر التجديد إلى إنشاء طلب تجديد ومعالجته. يجب أن يكون لديك رصيد حساب كافٍ لدفع ثمن الطلب. عند استدعاء أمر التجديد, يجب تضمين المعلمات التالية:

معامل طلب التجديد
شرح
domainاسم النطاق الذي تريد تجديده, يمكن تجديد نطاق واحد فقط لكل طلب
durationعدد السنوات لتجديد النطاق
year (optional)السنة الحالية التي ينتهي فيها النطاق
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
price_check (optional)يمكنك إضافة هذه المعلمة إلى الأمر للتحقق من تفاصيل سعر تجديد هذا النطاق. ملاحظة: عند إضافة هذه المعلمة إلى الأمر، لن تقوم واجهة api الخاصة بنا بتجديد النطاق، بل ستعرض معلومات السعر فقط.
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
no_renew_if_late_renew_fee_needed (optional)يمكنك إضافة هذا المعامل إلى الأمر لتجنب التجديد إذا كان النطاق يتطلب رسوم تجديد متأخرة. إذا كان النطاق يتطلب بالفعل رسوم تجديد متأخرة لتجديده, وتم تمرير "no_renew_if_late_renew_fee_needed = 1" في الأمر, فلن يتم تجديد النطاق.
وسم XML للنتيجة
شرح
<RenewResponse></RenewResponse>وسم استجابة التجديد، وهو العقدة الجذرية لمستند XML للاستجابة
<RenewHeader></RenewHeader>ترويسة التجديد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<PriceInfo></PriceInfo>وسم معلومات السعر, يُستخدم فقط عندما تكون الحالة "price_check_success"
<RenewContent></RenewContent>وسم محتوى التجديد, يُستخدم فقط عندما تكون الحالة "success"
<Expiration></Expiration>تاريخ الانتهاء بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"

مثال على التجديد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
الاستجابة (تنسيق XML)
<RenewResponse>
  <RenewHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RenewHeader>
  <RenewContent>
    <Expiration>73984579834</Expiration>
  </RenewContent>
</RenewResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
الاستجابة (تنسيق JSON)
{
   "RenewResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.com",
      "Expiration":"73984579834"
   }
}
 

أمر الدفع

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء أمر الدفع إلى إنشاء طلب دفع ومعالجته. يجب عليك إلغاء قفل نطاقك وحسابك من أجل الطلب. يحتاج حساب المستلم إلى رفض/قبول النطاق لإكمال الطلب. إذا قمت باستدعاء أمر الدفع, يجب تضمين المعلمات التالية:

معلمة طلب الدفع
شرح
domainاسم النطاق الذي تريد نقله. ندعم أيضًا النقل الجماعي, يمكنك استخدام ";" لفصل النطاقات. مثال: domain1.com;domain2.com
receiver_push_usernameاسم مستخدم Push لحساب المستلم
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
unlock_domain_for_push(optional)اضبط هذه المعلمة على "1". إذا كان النطاق مقفلًا، فسنقوم بإلغاء قفله تلقائيًا، لذا لا تحتاج إلى إلغاء قفل النطاق يدويًا
receiver_email(optional)البريد الإلكتروني لحساب المستلم
وسم XML للنتيجة
شرح
<PushResponse></PushResponse>وسم استجابة push, إنه العقدة الجذرية لمستند XML للاستجابة
<PushHeader></PushHeader>ترويسة الدفع
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال الدفع

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
الاستجابة (تنسيق XML)
<PushResponse>
  <PushHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
  </PushHeader>
</PushResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
الاستجابة (تنسيق JSON)
{
   "PushResponse":{
      "ResponseCode":"0",
      "Status":"order created"
   }
}
 

أمر النقل

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر النقل سيُنشئ ويعالج طلب نقل. قد تتطلب بعض النطاقات العلوية (TLDs) تأكيدًا من المسجل الخاسر لإتمام الطلب. إذا استدعيت أمر النقل، يجب تضمين المعاملات التالية:

معامل طلب النقل
شرح
domainاسم النطاق الذي تريد نقله إلى Dynadot، يمكن نقل نطاق واحد فقط لكل طلب
authرمز التفويض لطلب النقل.
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
registrant_contact (optional)جهة اتصال المسجل التي تريد استخدامها عند اكتمال النقل. (ليست كل النطاقات العلوية تدعم هذه الميزة)
admin_contact (optional)جهة اتصال المشرف التي تريد استخدامها عند اكتمال النقل. (ليست كل نطاقات tld تدعم هذه الميزة)
technical_contact (optional)جهة الاتصال التقنية التي تريد استخدامها عند اكتمال النقل. (ليست كل النطاقات العلوية تدعم هذه الميزة)
billing_contact (optional)جهة اتصال الفوترة التي تريد استخدامها عند اكتمال النقل. (ليست كل النطاقات العلوية تدعم هذه الميزة)
premium (optional)إذا كنت تريد نقل نطاق مميز، فاضبطه على "1" (اختياري)
privacy (optional)حالة الخصوصية للنطاق الذي تريد ضبطها, يمكن أن تكون "on" أو "off". سيتم تطبيق مستوى الخصوصية الافتراضي للحساب إذا تم إدخال قيمة غير صحيحة أو لم يتم إدخال شيء
name_servers (optional)قائمة خوادم الأسماء التي سيتم تطبيقها على النطاق بعد اكتمال النقل. يمكنك استخدام "," لفصل خوادم الأسماء. مثال: ns1.domain1.com,ns2.domain2.com
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
وسم XML للنتيجة
شرح
<TransferResponse></TransferResponse>وسم استجابة النقل, إنه العقدة الجذرية لمستند XML للاستجابة
<TransferHeader></TransferHeader>عنوان النقل
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على النقل

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<TransferResponse>
  <TransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
    <DomainName>domain1.com</DomainName>
    <OrderId>1234567</OrderId>
  </TransferHeader>
</TransferResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
الاستجابة (تنسيق JSON)
{
  "TransferResponse": {
    "ResponseCode": 0,
    "Status": "order created",
    "DomainName": "domain1.com",
    "OrderId": "1234567"
  }
}
 

أمر التسجيل بالجملة

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر التسجيل بالجملة سيؤدي إلى إنشاء ومعالجة طلبات التسجيل. يجب أن يكون لديك رصيد كافٍ في الحساب لدفع ثمن الطلبات. إذا كنت تستدعي أمر التسجيل بالجملة، يجب تضمين المعلمات التالية:

معامل طلب التسجيل الجماعي
شرح
domain0-domain99أسماء النطاقات التي تريد تسجيلها، يمكن تسجيل 100 نطاق كحد أقصى لكل طلب
premium (optional)إذا أردت تسجيل نطاق بريميوم، فاضبطه على "1" (اختياري)
currency (optional)يمكنك تحديد نوع العملة، وقيم هذه المعلمة المدعومة هي "USD","CNY", "GBP","EUR","INR","CAD" وهكذا. إذا فاتتك هذه المعلمة، فسنستخدم العملة الافتراضية للحساب
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
وسم XML للنتيجة
شرح
<BulkRegisterResponse></BulkRegisterResponse>وسم استجابة التسجيل الجماعي
<BulkRegisterHeader></BulkRegisterHeader>وسم رأس التسجيل الجماعي
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<BulkRegisterContent></BulkRegisterContent>وسم محتوى التسجيل بالجملة
<Expiration></Expiration>تاريخ الانتهاء بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"
<Result></Result>نتيجة إجراء التسجيل
<Message></Message>رسالة خطأ لإجراء التسجيل، تُستخدم فقط عندما تكون النتيجة "error"

مثال على التسجيل بالجملة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
  <BulkRegisterHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BulkRegisterHeader>
  <BulkRegisterContent>
    <BulkRegister>
      <RegisterResult>
        <DomainName>domain0.com</DomainName>
        <Expiration>1234567890</Expiration>
        <Result>success</Result>
        <Message>-</Message>
      </RegisterResult>
      <RegisterResult>
        <DomainName>domain1.com</DomainName>
        <Expiration>-</Expiration>
        <Result>error</Result>
        <Message>not_available</Message>
      </RegisterResult>
    </BulkRegister>
  </BulkRegisterContent>
</BulkRegisterResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
الاستجابة (تنسيق JSON)
{
  "BulkRegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BulkRegister": [
      {
        "DomainName": "domain0.com",
        "Expiration": "1234567890",
        "Result": "success",
        "Message": "-"
      },
      {
        "DomainName": "domain1.com",
        "Expiration": "-",
        "Result": "error",
        "Message": "not_available"
      }
    ]
  }
}
 

أمر معلومات النطاق

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

معامل طلب معلومات النطاق
شرح
domainيُسمح بنطاق واحد فقط لكل طلب
وسم XML للنتيجة
شرح
<DomainInfoResponse></DomainInfoResponse>العقدة الجذرية لمستند XML للاستجابة
<DomainInfoResponseHeader></DomainInfoResponseHeader>ترويسة الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<DomainInfoContent></DomainInfoContent>محتوى الاستجابة
<Domain></Domain>نطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء صلاحية النطاق بتوقيت Unix (عدد المللي ثانية منذ منتصف ليل 1 يناير 1970 بتوقيت UTC)
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء للنطاق
<Type></Type>نوع خادم الأسماء للنطاق
<WithAds></WithAds>إذا كنت تريد صفحة إيقاف مؤقت لنطاقك
<Whois></Whois>معلومات Whois
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرّف جهة الاتصال
<Admin></Admin>معلومات المسؤول
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>حالة التمكين
<UdrpLocked></UdrpLocked>Udrp مقفل أم لا
<UdrpLocked></UdrpLocked>Udrp مقفل أم لا
<RegistrantUnverified></RegistrantUnverified>المسجل غير موثق
<Hold></Hold>حالة إيقاف العميل/المسجل
<Privacy></Privacy>حالة الخصوصية
<isForSale></isForSale>حالة البيع
<RenewOption></RenewOption>خيار التجديد
<Note></Note>ملاحظة
<Folder></Folder>معلومات المجلد
<FolderId></FolderId>معرّف المجلد
<FolderName></FolderName>اسم المجلد

مثال معلومات النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=domain_info&domain=domain1.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=domain_info&domain=domain1.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<DomainInfoResponse>
  <DomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </DomainInfoHeader>
  <DomainInfoContent>
    <Domain>
      <Name>domain1.com</Name>
      <Expiration>1361430589062</Expiration>
      <Registration>1234567890123</Registration>
      <NameServerSettings>
        <Type>Dynadot Parking</Type>
        <WithAds>Yes</WithAds>
      </NameServerSettings>
      <Whois>
        <Registrant>
          <ContactId>0</ContactId>
        </Registrant>
        <Admin>
          <ContactId>0</ContactId>
        </Admin>
        <Technical>
          <ContactId>0</ContactId>
        </Technical>
        <Billing>
          <ContactId>0</ContactId>
        </Billing>
      </Whois>
      <Locked>yes</Locked>
      <Disabled>no</Disabled>
      <UdrpLocked>no</UdrpLocked>
      <RegistrantUnverified>no</RegistrantUnverified>
      <Hold>no</Hold>
      <Privacy>none</Privacy>
      <isForSale>yes</isForSale>
      <RenewOption>no renew option</RenewOption>
      <Note/>
      <Folder>
        <FolderId>-1</FolderId>
        <FolderName>(no folder)</FolderName>
      </Folder>
      <Status>active</Status>
    </Domain>
  </DomainInfoContent>
</DomainInfoResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=domain_info&domain=domain1.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=domain_info&domain=domain1.com
الاستجابة (تنسيق JSON)
{
  "DomainInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainInfo": {
      "Name": "domain1.com",
      "Expiration": "1361430589062",
      "Registration": "1234567890123",
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      },
      "Whois": {
        "Registrant": {
          "ContactId": "0"
        },
        "Admin": {
          "ContactId": "0"
        },
        "Technical": {
          "ContactId": "0"
        },
        "Billing": {
          "ContactId": "0"
        }
      },
      "Locked": "yes",
      "Disabled": "no",
      "UdrpLocked": "no",
      "RegistrantUnverified": "no",
      "Hold": "no",
      "Privacy": "none",
      "isForSale": "yes",
      "RenewOption": "no renew option",
      "Note": "",
      "Folder": {
        "FolderId": "-1",
        "FolderName": "(no folder)"
      },
      "Status": "active"
    }
  }
}
 

أمر تعيين Whois

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر set Whois، فيجب تضمين المعاملات التالية:

تعيين معامل طلب Whois
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
registrant_contactمعلومات المُسجِّل الخاصة بالنطاق
admin_contactمعلومات المسؤول عن النطاق
technical_contactالمعلومات التقنية للنطاق
billing_contactمعلومات الفوترة الخاصة بالنطاق
وسم XML للنتيجة
شرح
<SetWhoisResponse></SetWhoisResponse>العقدة الجذرية لمستند XML للاستجابة
<SetWhoisHeader></SetWhoisHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين Whois

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق XML)
<SetWhoisResponse>
  <SetWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetWhoisHeader>
</SetWhoisResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق JSON)
{
   "SetWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين خوادم الأسماء

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين خوادم الأسماء، يجب تضمين المعاملات التالية:

معامل طلب تعيين خوادم الأسماء
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
ns0 - ns12خوادم الأسماء التي تريد تعيين نطاقك لاستخدامها، يمكنك تحديد حتى 13 خادم أسماء، ولكن يجب أن تكون موجودة بالفعل في حسابك
وسم XML للنتيجة
شرح
<SetNsResponse></SetNsResponse>علامة استجابة تعيين خادم الأسماء, إنها العقدة الجذرية لوثيقة XML للاستجابة
<SetNsHeader></SetNsHeader>وسم ترويسة استجابة تعيين خادم الأسماء
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال لتعيين NS

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetNsResponse>
  <SetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsHeader>
</SetNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
الاستجابة (تنسيق JSON)
{
  "SetNsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين الإيقاف

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين الباركينغ, يجب تضمين المعلمات التالية:

تعيين معامل طلب الركن
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
with_ads (optional)إذا كنت لا تريد إعلانات طرف ثالث، يمكنك استخدام هذه المعلمة مع "no"
وسم XML للنتيجة
شرح
<SetParkingResponse></SetParkingResponse>وسم استجابة set parking، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة
<SetParkingHeader></SetParkingHeader>تعيين رأس مجلد الإيقاف
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين الركن

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_parking&domain=domain1.com&with_ads=no
الاستجابة (تنسيق XML)
<SetParkingResponse>
  <SetParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetParkingHeader>
</SetParkingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_parking&domain=domain1.com&with_ads=no
الاستجابة (تنسيق JSON)
{
   "SetParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين إعادة التوجيه

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين إعادة التوجيه، فيجب تضمين المعلمات التالية:

معامل طلب تعيين إعادة التوجيه
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
forward_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (optional)حالة إعادة التوجيه للنطاق الذي تريده، القيمة الافتراضية هي "temporary"، وإذا كنت تريد إعادة التوجيه بشكل دائم، استخدم هذه المعلمة مع "no"
وسم XML للنتيجة
شرح
<SetForwardingResponse></SetForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetForwardingHeader></SetForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على إعداد إعادة التوجيه

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
الاستجابة (تنسيق XML)
<SetForwardingResponse>
  <SetForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetForwardingHeader>
</SetForwardingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
الاستجابة (تنسيق JSON)
{
   "SetForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

تعيين أمر التخفي

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر set stealth, يجب تضمين المعاملات التالية:

ضبط معامل طلب التخفي
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
stealth_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (optional)عنوان الصفحة
وسم XML للنتيجة
شرح
<SetStealthResponse></SetStealthResponse>العقدة الجذرية لمستند XML للاستجابة
<SetStealthHeader></SetStealthHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين التخفي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق XML)
<SetStealthResponse>
  <SetStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetStealthHeader>
</SetStealthResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق JSON)
{
   "SetStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين الاستضافة

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا استدعيت أمر تعيين الاستضافة، فيجب تضمين المعاملات التالية:

معامل طلب تعيين الاستضافة
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
hosting_typeنوع الاستضافة التي تريدها، يمكنك الاختيار بين "advanced" و"basic"
mobile_view_onفقط عندما يكون hosting_type هو "advanced"، يمكنك استخدام هذا المعامل كـ "yes"
وسم XML للنتيجة
شرح
<SetHostingResponse></SetHostingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetHostingHeader></SetHostingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين الاستضافة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
الاستجابة (تنسيق XML)
<SetHostingResponse>
  <SetHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetHostingHeader>
</SetHostingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
الاستجابة (تنسيق JSON)
{
   "SetHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط DNS2

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء الأمر set DNS2, فيجب تضمين المعاملات التالية:

يرجى ملاحظة أن تنفيذ الأمر SET_DNS2 سيؤدي افتراضيًا إلى الكتابة فوق إعدادات DNS الحالية. لتغيير هذا السلوك وإلحاق إعدادات DNS الجديدة بدلاً من ذلك، يمكنك استخدام المعامل الاختياري add_dns_to_current_setting.

تعيين معامل طلب DNS2
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
main_record_type0 - main_record_type19 (optional)نوع السجل الرئيسي، يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email"
main_record0 - main_record19حدد سجل DNS لنطاقك
main_recordx0 - main_recordx19مسافة Mx, نوع إعادة التوجيه(301 كـ "1", 302 كـ "2"), عنوان إعادة التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني, ضروري عندما يكون main_record_type هو "forward","mx","stealth","email".
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي (اختياري)
sub_record_type0 - sub_record_type99نوع سجل النطاق الفرعي، يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "srv"، "mx"، "stealth"، "email"
sub_record0 - sub_record99عنوان IP للنطاق الفرعي أو المضيف الهدف
sub_recordx0 - sub_recordx99مسافة Mx, نوع التحويل, عنوان التحويل المتخفي أو الاسم المستعار للبريد الإلكتروني, مطلوب عندما يكون main_record_type هو "forward","mx","stealth","email"
ttl (optional)مدة البقاء
add_dns_to_current_setting (optional)إذا كنت تريد إلحاق إعدادات DNS الجديدة بإعدادات Dns الموجودة. اضبطها على "1" (اختياري)
وسم XML للنتيجة
شرح
<SetDnsResponse></SetDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDnsHeader></SetDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين DNS2

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
  <SetDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnsHeader>
</SetDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
الاستجابة (تنسيق JSON)
{
  "SetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين DNSSEC

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر Set Dnssec سيضبط dnssec للنطاق. هذا الأمر متاح فقط بتنسيق XML و JSON. إذا استدعيت هذا الأمر، يجب تضمين المعلمات التالية:

يمكنك اختيار تعبئة قيم المعاملات المقابلة في الخيار بناءً على اسم النطاق الخاص بك.

الخيار 1 : domain_name , key_tag , digest_type , digest , algorithm

الخيار 2 : domain_name , flags , public_key , algorithm

ملاحظات: يرجى اختيار رقم التسمية المقابلة كقيمة للمعامل الخاص بك إن وُجد.

معلمة طلب Set Dnssec
شرح
domain_nameاسم النطاق الذي تحتاج إلى إعداد DNSSEC له
key_tagوسم المفتاح
digest_typeيمكنك اختيار رقم من القائمة التالية ليمثل نوع التوقيع الرقمي الخاص بك: SHA-1(1) SHA-256(2) GOSTR 34.11-94 (3) SHA-384(4)
digestيرجى إدخال القيمة المقابلة لنوع الملخص الذي اخترته
algorithmيمكنك اختيار رقم من القائمة التالية لتمثيل خوارزمية التوقيع الرقمي الخاصة بك: RSA/MD5(1) Diffie-Hellman (2) DSA/SHA-1(3) Elliptic Curve (4) RSA/SHA-1(5) DSA-NSEC3-SHA1(6) RSASHA1-NSEC3-SHA1(7) RSA/SHA-256(8) RSA/SHA-512(10) GOSTR 34.10-2001(12) ECDSA Curve P-256 with SHA-256(13 ECDSA Curve P-384 with SHA-384(14) ED25519(15 ED448(16) Indirect (252) Private DNS (253 Private OID (254)
flagsيمكنك اختيار رقم من القائمة التالية ليمثل رمز توقيعك الرقمي: ZSK(256) KSK(257)
public_keyيجب أن يكون المفتاح العام بترميز base64.
وسم XML للنتيجة
شرح
<SetDnssecResponse></SetDnssecResponse>العقدة الجذرية للاستجابة
<SetDnssecHeader></SetDnssecHeader>تعيين ترويسة Dnssec
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال إعداد Dnssec

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnssecResponse>
  <SetDnssecHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnssecHeader>
  <SetDnssecContent/>
</SetDnssecResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
الاستجابة (تنسيق JSON)
{
  "SetDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر إزالة Dnssec

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء أمر إزالة Dnssec إلى إزالة Dnssec من النطاق. هذا الأمر متاح فقط بتنسيق XML وJSON. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:

معلمة طلب مسح Dnssec
شرح
domain_nameاسم النطاق الذي تحتاج إلى إزالة Dnssec منه

مثال إزالة Dnssec

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=clear_dnssec&domain_name=domain-haha1.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=clear_dnssec&domain_name=domain-haha1.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<ClearDnssecResponse>
  <ClearDnssecHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ClearDnssecHeader>
</ClearDnssecResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=clear_dnssec&domain_name=domain-haha1.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=clear_dnssec&domain_name=domain-haha1.com
الاستجابة (تنسيق JSON)
{
  "ClearDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين إعادة توجيه البريد الإلكتروني

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء الأمر set email forward، يجب تضمين المعلمات التالية:

تعيين معامل طلب إعادة توجيه البريد الإلكتروني
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
forward_typeنوع التحويل, يمكن أن يكون "donot": عدم تحويل البريد الإلكتروني, "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX), "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم, يُستخدم فقط عندما تكون "forward_type" هي "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الموجود، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هو أعلى أولوية، يُستخدم فقط عندما يكون "forward_type" هو "mx"
وسم XML للنتيجة
شرح
<SetEmailForwardingResponse></SetEmailForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetEmailForwardingHeader></SetEmailForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إعادة توجيه البريد الإلكتروني

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
الاستجابة (تنسيق XML)
<SetEmailForwardingResponse>
  <SetEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetEmailForwardingHeader>
</SetEmailForwardingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
الاستجابة (تنسيق JSON)
{
   "SetEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر Set Clear Domain Setting

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر set clear domain setting، فيجب تضمين المعاملات التالية:

معامل طلب تعيين إعداد تفريغ النطاق
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، "dnssec"، و "nameservers"
وسم XML للنتيجة
شرح
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetClearDomainSettingHeader></SetClearDomainSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إعداد مسح النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
الاستجابة (تنسيق XML)
<SetClearDomainSettingResponse>
  <SetClearDomainSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDomainSettingHeader>
</SetClearDomainSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
الاستجابة (تنسيق JSON)
{
   "SetClearDomainSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا استدعيت الأمر set folder, فيجب تضمين المعاملات التالية:

تعيين معامل طلب المجلد
شرح
domainاسم النطاق المراد تحديثه, يمكن تعيين نطاق واحد فقط لكل طلب
folderاسم المجلد الذي تريد نقل نطاقك إليه. استخدم "Default" كاسم للمجلد إذا أردت نقل النطاق إلى المجلد الافتراضي. اسم المجلد حساس لحالة الأحرف. على سبيل المثال، "Folder1" و"folder1" هما اسمان مختلفان لمجلدين.
folder_id (optional)معرّف المجلد الذي تريد نقل نطاقك إليه
وسم XML للنتيجة
شرح
<SetFolderResponse></SetFolderResponse>وسم استجابة تعيين المجلد, إنه العقدة الجذرية لمستند XML للاستجابة
<SetFolderHeader></SetFolderHeader>تعيين رأس المجلد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال ضبط المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder&domain=domian1.com&folder=folder1
الاستجابة (تنسيق XML)
<SetFolderResponse>
  <SetFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHeader>
</SetFolderResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder&domain=domian1.com&folder=folder1
الاستجابة (تنسيق JSON)
{
   "SetFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين الملاحظة

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر set note، فيجب تضمين المعلمات التالية:

معامل طلب تعيين ملاحظة
شرح
domainالنطاق الذي تريد تعيينه، يمكن تعيين نطاق واحد فقط لكل طلب
noteملاحظة تريد تعيينها للنطاق، يمكن أن تكون فارغة
وسم XML للنتيجة
شرح
<SetNoteResponse></SetNoteResponse>العقدة الجذرية لمستند XML للاستجابة
<SetNoteHeader></SetNoteHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين ملاحظة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
الاستجابة (تنسيق XML)
<SetNoteResponse>
  <SetNoteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNoteHeader>
</SetNoteResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
الاستجابة (تنسيق JSON)
{
   "SetNoteResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

تعيين خيار التجديد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين خيار التجديد، يجب تضمين المعلمات التالية:

تعيين معامل طلب خيار التجديد
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
renew_optionيمكن أن يكون "donot"، "auto"، "reset"
وسم XML للنتيجة
شرح
<SetRenewOptionResponse></SetRenewOptionResponse>العقدة الجذرية لمستند XML للاستجابة
<SetRenewOptionHeader></SetRenewOptionHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين خيار التجديد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetRenewOptionResponse>
  <SetRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetRenewOptionHeader>
</SetRenewOptionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
الاستجابة (تنسيق JSON)
{
  "SetRenewOptionResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين الخصوصية

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر set privacy، يجب تضمين المعلمات التالية:

تعيين معلمة طلب الخصوصية
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
optionحالة الخصوصية للنطاق الذي تريد ضبطها, يمكن أن تكون "full", "partial", أو "off"
whois_privacy_optionحالة خصوصية whois للنطاق الذي تريد تعيينه, يمكن أن تكون "yes" أو "no"
وسم XML للنتيجة
شرح
<SetPrivacyResponse></SetPrivacyResponse>العقدة الجذرية لمستند XML للاستجابة
<SetPrivacyHeader></SetPrivacyHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين الخصوصية

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
الاستجابة (تنسيق XML)
<SetPrivacyResponse>
  <SetPrivacyHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetPrivacyHeader>
</SetPrivacyResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
الاستجابة (تنسيق JSON)
{
   "SetPrivacyResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أسعار TLD

دعم تعدد الخيوط
دعم بيئة اختبار API

هذه الميزة متاحة فقط بصيغة XML و JSON:

معامل طلب أسعار Tld
شرح
currency (optional)عملة نتيجة الإرجاع، يجب أن تكون "usd"، "eur"، أو "cny"، والعملة الافتراضية هي Api Default Currency في إعدادات الحساب
count_per_page (optional)كم عدد الكيانات التي تُعرض في كل صفحة
page_index (optional)كيانات أي صفحة تريد عرضها؟
sort (optional)يرجى تحديد أحد الخيارات التالية كقيمة لمعامل الفرز:
* إذا لم تختره، فسنستخدم الترتيب الافتراضي.
1) ترتيب تصاعدي (افتراضي)
2) وصف الترتيب
3) الاسم تصاعدي
4) الاسم والوصف
5) SalesAsc
6) وصف المبيعات
7) تاريخ الإطلاق تصاعديًا
8) وصف تاريخ الإطلاق
9) CountAsc
10) CountDesc
11) RegistryAsc
12) وصف السجل
وسم XML للنتيجة
شرح
<TldPriceResponse></TldPriceResponse>العقدة الجذرية لمستند XML للاستجابة
<TldPriceResponseHeader></TldPriceResponseHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<TldPriceContent></TldPriceContent>محتوى الاستجابة
<TldContent></TldContent>معلومات Tld
<Tld></Tld>نطاقات المستوى الأعلى
<Usage></Usage>استخدام امتداد النطاق
<Price></Price>معلومات السعر لهذا tld. تحتوي على وسوم فرعية: : وحدة السعر : سعر التسجيل : سعر التجديد : سعر النقل
<Privacy></Privacy>إذا كان هذا tld يدعم خصوصية whois
<GracePeriod></GracePeriod>معلومات فترة السماح لهذا النطاق العلوي. تحتوي على وسوم فرعية: : معلومات وحدة فترة السماح : فترة سماح للتجديد : حذف فترة السماح
<IDN></IDN>إذا كان هذا الـ tld يدعم أسماء النطاقات الدولية
<Restrictions></Restrictions>اسم النطاق

مثال أسعار النطاقات العلوية

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=tld_price&currency=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=tld_price&currency=USD
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
  <TldPriceResponseHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <PriceLevel>Regular Pricing</PriceLevel>
    <Currency>USD</Currency>
  </TldPriceResponseHeader>
  <TldPriceContent>
    <TldContent>
      <Tld>com</Tld>
      <Usage>General</Usage>
      <Price>
        <Unit>(Price/1 year)</Unit>
        <Register>15.00</Register>
        <Renew>15.00</Renew>
        <Transfer>15.00</Transfer>
        <Restore>10.00</Restore>
      </Price>
      <Privacy>10.00</Privacy>
      <GracePeriod>
        <Unit>10.00</Unit>
        <Renew>10.00</Renew>
        <Delete>30</Delete>
        <Restore>YES</Restore>
      </GracePeriod>
      <IDN>YES</IDN>
      <Restrictions>--</Restrictions>
      <OnSale>Yes</OnSale>
      <maxDuration>10</maxDuration>
      <minDuration>1</minDuration>
    </TldContent>
  </TldPriceContent>
</TldPriceResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=tld_price&currency=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=tld_price&currency=USD
الاستجابة (تنسيق JSON)
{
  "TldPriceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "PriceLevel": "Regular Pricing",
    "Currency": "USD",
    "TldPrice": [
      {
        "Tld": "com",
        "Usage": "General",
        "IDN": "YES",
        "Restrictions": "--",
        "OnSale": "Yes",
        "Privacy": "10.00",
        "Price": {
          "Unit": "(Price/1 year)",
          "Register": "15.00",
          "Renew": "15.00",
          "Transfer": "15.00",
          "Restore": "10.00"
        },
        "GracePeriod": {
          "Unit": "10.00",
          "Renew": "10.00",
          "Delete": "30",
          "Restore": "YES"
        },
        "maxDuration": 10,
        "minDuration": 1
      }
    ]
  }
}
 

أمر عرض النطاقات

دعم تعدد الخيوط
دعم بيئة اختبار API

هذه الميزة متاحة فقط بصيغة XML و JSON:

معلمة طلب قائمة النطاقات
شرح
customer_id (optional)تصفية البيانات حسب معرّف العميل (يمكن للموزعين فقط استخدام هذا المعامل)
count_per_page (optional)كم عدد الكيانات التي تُعرض في كل صفحة
page_index (optional)كيانات أي صفحة تريد عرضها؟
sort (optional)يرجى تحديد أحد الخيارات التالية كقيمة لمعامل الفرز:
* إذا لم تختره، فسنستخدم الترتيب الافتراضي.
1) عدّ تصاعدي (افتراضي)
2) عدد تنازلي
3) الاسم تصاعدي
4) الاسم والوصف
وسم XML للنتيجة
شرح
<ListDomainInfoResponse></ListDomainInfoResponse>العقدة الجذرية لمستند XML للاستجابة
<ListDomainInfoHeader></ListDomainInfoHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ListDomainInfoContent></ListDomainInfoContent>محتوى الاستجابة
<DomainInfoList></DomainInfoList>قائمة معلومات النطاق
<DomainInfo></DomainInfo>معلومات النطاق
<Domain></Domain>نطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء صلاحية النطاق بتوقيت Unix (عدد المللي ثانية منذ منتصف ليل 1 يناير 1970 بتوقيت UTC)
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع إعداد خادم الأسماء
<WithAds></WithAds>مع إعلانات أم لا
<Whois></Whois>معلومات Whois
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرّف جهة الاتصال
<Admin></Admin>معلومات المسؤول
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>حالة التمكين
<Hold></Hold>حالة إيقاف العميل/المسجل
<Privacy></Privacy>حالة الخصوصية
<isForSale></isForSale>حالة البيع
<RenewOption></RenewOption>خيار التجديد
<Note></Note>ملاحظة
<Folder></Folder>معلومات المجلد
<FolderId></FolderId>معرّف المجلد
<FolderName></FolderName>اسم المجلد

مثال سرد النطاقات

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=list_domain
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=list_domain
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<ListDomainInfoResponse>
  <ListDomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ListDomainInfoHeader>
  <ListDomainInfoContent>
    <DomainInfoList>
      <DomainInfo>
        <Domain>
          <Name>domain-exp140.com</Name>
          <Expiration>1361430589062</Expiration>
          <Registration>1234567890123</Registration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>Yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>0</ContactId>
            </Registrant>
            <Admin>
              <ContactId>0</ContactId>
            </Admin>
            <Technical>
              <ContactId>0</ContactId>
            </Technical>
            <Billing>
              <ContactId>0</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <UdrpLocked>no</UdrpLocked>
          <RegistrantUnverified>no</RegistrantUnverified>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note/>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
          <Status>active</Status>
        </Domain>
        <Domain>
          <Name>domain-exp141.com</Name>
          <Expiration>1361430589062</Expiration>
          <Registration>1234567890123</Registration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>Yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>1</ContactId>
            </Registrant>
            <Admin>
              <ContactId>2</ContactId>
            </Admin>
            <Technical>
              <ContactId>3</ContactId>
            </Technical>
            <Billing>
              <ContactId>4</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <UdrpLocked>no</UdrpLocked>
          <RegistrantUnverified>no</RegistrantUnverified>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note/>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
          <Status>moved</Status>
        </Domain>
      </DomainInfo>
    </DomainInfoList>
  </ListDomainInfoContent>
</ListDomainInfoResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=list_domain
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=list_domain
الاستجابة (تنسيق JSON)
{
  "ListDomainInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "MainDomains": [
      {
        "Name": "domain-exp140.com",
        "Expiration": "1361430589062",
        "Registration": "1234567890123",
        "NameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "Yes"
        },
        "Whois": {
          "Registrant": {
            "ContactId": "0"
          },
          "Admin": {
            "ContactId": "0"
          },
          "Technical": {
            "ContactId": "0"
          },
          "Billing": {
            "ContactId": "0"
          }
        },
        "Locked": "yes",
        "Disabled": "no",
        "UdrpLocked": "no",
        "RegistrantUnverified": "no",
        "Hold": "no",
        "Privacy": "none",
        "isForSale": "no",
        "RenewOption": "no renew option",
        "Note": "",
        "Folder": {
          "FolderId": "-1",
          "FolderName": "(no folder)"
        },
        "Status": "active"
      },
      {
        "Name": "domain-exp141.com",
        "Expiration": "1361430589062",
        "Registration": "1234567890123",
        "NameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "Yes"
        },
        "Whois": {
          "Registrant": {
            "ContactId": "1"
          },
          "Admin": {
            "ContactId": "2"
          },
          "Technical": {
            "ContactId": "3"
          },
          "Billing": {
            "ContactId": "4"
          }
        },
        "Locked": "yes",
        "Disabled": "no",
        "UdrpLocked": "no",
        "RegistrantUnverified": "no",
        "Hold": "no",
        "Privacy": "none",
        "isForSale": "no",
        "RenewOption": "no renew option",
        "Note": "",
        "Folder": {
          "FolderId": "-1",
          "FolderName": "(no folder)"
        },
        "Status": "moved"
      }
    ]
  }
}
 

أمر قفل النطاق

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء الأمر lock domain، فيجب تضمين المعاملات التالية:

معامل طلب قفل النطاق
شرح
domainاسم النطاق الذي تريد قفله، يمكن إدخال نطاق واحد فقط لكل طلب
وسم XML للنتيجة
شرح
<LockDomainResponse></LockDomainResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<LockDomainHeader></LockDomainHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال قفل النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=lock_domain&domain=domain4.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=lock_domain&domain=domain4.com
الاستجابة (تنسيق XML)
<LockDomainResponse>
   <LockDomainHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </LockDomainHeader>
</LockDomainResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=lock_domain&domain=domain4.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=lock_domain&domain=domain4.com
الاستجابة (تنسيق JSON)
{
   "LockDomainResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر البحث عن الاقتراحات

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء أمر البحث عن الاقتراحات إلى شراء اسم النطاق المحدد. هذا الأمر متاح فقط بصيغة XML وJSON. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب البحث عن الاقتراحات
شرح
domainالنطاق الذي تريد البحث عنه، يمكن إدخال نطاق واحد فقط لكل طلب
tlds (optional)النطاقات العلوية التي تقتصر عليها نتيجة البحث
وسم XML للنتيجة
شرح
<SuggestionSearchResponse></SuggestionSearchResponse>وسم استجابة البحث عن الاقتراحات، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة
<SuggestionSearchHeader></SuggestionSearchHeader>ترويسة البحث عن الاقتراحات
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على البحث بالاقتراحات

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SuggestionSearchResponse>
  <SuggestionSearchHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SuggestionSearchHeader>
  <SuggestionSearchContent>
    <SuggestionSearch>
      <Domain>test1.com</Domain>
      <Domain>test2.com</Domain>
      <Domain>test3.net</Domain>
      <Domain>test4.net</Domain>
    </SuggestionSearch>
  </SuggestionSearchContent>
</SuggestionSearchResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
الاستجابة (تنسيق JSON)
{
  "SuggestionSearchResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Domains": [
      "test1.com",
      "test2.com",
      "test3.net",
      "test4.net"
    ]
  }
}
 

أمر إلغاء النقل

دعم تعدد الخيوط
دعم بيئة اختبار API

يسمح لك الأمر بإلغاء عنصر نقل في الطلب. عند استدعاء أمر إلغاء النقل، يجب تضمين المعلمات التالية:

معامل طلب إلغاء النقل
شرح
domainاسم النطاق الذي تريد إلغاء نقل ملكيته, يمكن إدخال نطاق واحد فقط لكل طلب
order_idمعرّف أمر النقل, يمكنك الحصول عليه من واجهة برمجة تطبيقات أخرى get_transfer_status.
وسم XML للنتيجة
شرح
<CancelTransferResponse></CancelTransferResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<CancelTransferHeader></CancelTransferHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال إلغاء النقل

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=cancel_transfer&domain=domain4.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=cancel_transfer&domain=domain4.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<CancelTransferResponse>
  <CancelTransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CancelTransferHeader>
</CancelTransferResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=cancel_transfer&domain=domain4.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=cancel_transfer&domain=domain4.com
الاستجابة (تنسيق JSON)
{
  "CancelTransferResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر الحصول على حالة النقل

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر get transfer status، فيجب تضمين المعلمات التالية:

معلمة طلب الحصول على حالة النقل
شرح
domainاسم النطاق الذي تريد الحصول على حالة النقل له، يمكن إدخال نطاق واحد فقط في كل طلب
transfer_typeنوع النقل الذي تريد الحصول على حالة النقل له (نقل داخل أو نقل خارج)
وسم XML للنتيجة
شرح
<GetTransferStatusResponse></GetTransferStatusResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetTransferStatusHeader></GetTransferStatusHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetTransferStatusContent></GetTransferStatusContent>محتوى الاستجابة
<TransferList></TransferList>قائمة النقل
<Transfer></Transfer>معلومات النقل
<OrderId></OrderId>معرّف الطلب
<TransferStatus></TransferStatus>حالة نقل النطاق. إذا حصلت على 'none' أو 'approved'، يمكنك إلغاء النقل. إذا حصلت على 'waiting'، فهذا يعني أن النقل قد بدأ بالفعل. إذا حصلت على 'auth code needed'، فهذا يعني رمز تفويض غير صالح، يمكنك استخدام واجهة API أخرى SET_TRANSFER_AUTH لإعادة إرسال رمز التفويض. هناك أيضًا بعض الحالات الأخرى، سنرسل لك بريدًا إلكترونيًا أو تحتاج إلى فحصها من قبل مهندسينا.

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

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferStatusResponse>
  <GetTransferStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetTransferStatusHeader>
  <GetTransferStatusContent>
    <TransferList>
      <Transfer>
        <OrderId>testorderid</OrderId>
        <TransferStatus>teststatus</TransferStatus>
      </Transfer>
      <Transfer>
        <OrderId>testorderid2</OrderId>
        <TransferStatus>teststatus2</TransferStatus>
      </Transfer>
    </TransferList>
  </GetTransferStatusContent>
</GetTransferStatusResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
الاستجابة (تنسيق JSON)
{
  "GetTransferStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "TransferList": [
      {
        "OrderId": "testorderid",
        "TransferStatus": "teststatus"
      },
      {
        "OrderId": "testorderid2",
        "TransferStatus": "teststatus2"
      }
    ]
  }
}
 

أمر تعيين رمز تفويض النقل لأمر النقل

دعم تعدد الخيوط
دعم بيئة اختبار API

الأمر الذي يسمح لك بتحديث رمز المصادقة لمعالجة طلبات النقل. عند استدعاء أمر set transfer auth code، يجب تضمين المعلمات التالية:

تعيين معلمة طلب رمز تفويض النقل
شرح
domainاسم النطاق الذي تقوم بتحديث تفويض النقل له، يمكن إدخال نطاق واحد فقط لكل طلب.
auth_codeauth_code الذي تريد إعادة إرساله
order_idمعرّف أمر النقل, يمكنك الحصول عليه من واجهة برمجة تطبيقات أخرى get_transfer_status.
وسم XML للنتيجة
شرح
<GetTransferStatusResponse></GetTransferStatusResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetTransferStatusHeader></GetTransferStatusHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين رمز تفويض النقل

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
الاستجابة (تنسيق XML)
<SetTransferAuthCodeResponse>
   <SetTransferAuthCodeHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
الاستجابة (تنسيق JSON)
{
   "SetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تفويض النقل بعيدًا

دعم تعدد الخيوط
دعم بيئة اختبار API
معامل طلب تفويض النقل بعيدًا
شرح
domainاسم النطاق الذي تريد التصريح بنقله بعيدًا، يمكن إدخال نطاق واحد فقط لكل طلب
order_idorder_id الخاص بـ Dynadot للنطاق الذي تريد نقله بعيداً
authorizeللسماح بنقل النطاق خارجًا، اضبطه على "approve". ولرفض نقل النطاق خارجًا، اضبطه على "deny".
وسم XML للنتيجة
شرح
<AuthorizeTransferAwayResponse></AuthorizeTransferAwayResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<AuthorizeTransferAwayHeader></AuthorizeTransferAwayHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<Result></Result>نتيجة تفويض نقل النطاق إلى مسجل آخر

مثال على تفويض النقل إلى الخارج

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<AuthorizeTransferAwayResponse>
  <AuthorizeTransferAwayHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <Result>away_approved</Result>
  </AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
الاستجابة (تنسيق JSON)
{
  "AuthorizeTransferAwayResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Result": "away_approved"
  }
}
 

أمر الحصول على رمز تفويض النقل

دعم تعدد الخيوط
دعم بيئة اختبار API

يجب عليك إلغاء قفل نطاقك وحسابك قبل طلب رمز التفويض.

معامل طلب الحصول على رمز تفويض النقل
شرح
domainاسم النطاق الذي تريد الحصول على رمز تفويض النقل الخاص به، يمكن إدخال نطاق واحد فقط في كل طلب
new_code (optional)توليد رمز تفويض نقل جديد
unlock_domain_for_transfer (Optional. Requires api skip lock agreement to use)إذا كنت تريد إلغاء قفل النطاق للنقل، اضبطه على "1". إذا تمت معالجة الطلب بنجاح، فسيتم إلغاء قفل النطاق.
وسم XML للنتيجة
شرح
<GetTransferAuthCodeResponse></GetTransferAuthCodeResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetTransferAuthCodeHeader></GetTransferAuthCodeHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<AuthCode></AuthCode>يُستخدم رمز المصادقة لبدء نقل النطاق.

مثال الحصول على رمز تفويض النقل

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferAuthCodeResponse>
  <GetTransferAuthCodeHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <AuthCode>testauthcode</AuthCode>
  </GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
الاستجابة (تنسيق JSON)
{
  "GetTransferAuthCodeResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AuthCode": "testauthcode"
  }
}
 

أمر الحصول على طلب دفع النطاق

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء الأمر Get Domain Push Request سيحصل على طلب دفع النطاق. هذا الأمر متاح فقط بتنسيق XML و JSON.

معلمة طلب الحصول على طلب دفع النطاق
شرح
N/A لا حاجة إلى معامل إضافي
وسم XML للنتيجة
شرح
<GetDomainPushRequestResponse></GetDomainPushRequestResponse>العقدة الجذرية للاستجابة
<GetDomainPushRequestHeader></GetDomainPushRequestHeader>ترويسة طلب الحصول على Domain Push
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetDomainPushRequestContent></GetDomainPushRequestContent>محتوى الاستجابة
<PushDomain></PushDomain>دفع النطاق
<PushDomainName></PushDomainName>دفع اسم النطاق

مثال على طلب نقل النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_domain_push_request
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_domain_push_request
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetDomainPushRequestResponse>
  <GetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetDomainPushRequestHeader>
  <GetDomainPushRequestContent>
    <PushDomain>
      <PushDomainName>haha.com</PushDomainName>
    </PushDomain>
    <PushDomain>
      <PushDomainName>haha1.com</PushDomainName>
    </PushDomain>
  </GetDomainPushRequestContent>
</GetDomainPushRequestResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_domain_push_request
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_domain_push_request
الاستجابة (تنسيق JSON)
{
  "GetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "pushDomainName": "[haha.com,haha1.com]"
  }
}
 

أمر تعيين طلب دفع النطاق

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر تعيين طلب دفع النطاق سيؤدي إلى تعيين طلب دفع النطاق. هذا الأمر متاح فقط بتنسيق XML و JSON. إذا استدعيت هذا الأمر، يجب تضمين المعلمات التالية:

معامل طلب تعيين دفع النطاق
شرح
domainsاسم النطاق الخاص بالطلب المراد معالجته
actionإجراء الطلب المراد معالجته، يمكنك اختيار "accept" أو "decline"
وسم XML للنتيجة
شرح
<SetDomainPushRequestResponse></SetDomainPushRequestResponse>العقدة الجذرية للاستجابة
<SetDomainPushRequestHeader></SetDomainPushRequestHeader>ترويسة طلب تعيين دفع النطاق
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال طلب نقل النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDomainPushRequestResponse>
  <SetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetDomainPushRequestHeader>
  <SetDomainPushRequestContent/>
</SetDomainPushRequestResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
الاستجابة (تنسيق JSON)
{
  "SetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر إنشاء تدقيق CN

دعم تعدد الخيوط
دعم بيئة اختبار API

يتيح لك الأمر إنشاء تدقيق CN لجهة اتصال. عند استدعاء الأمر create cn audit، يجب تضمين المعاملات التالية:

معامل طلب إنشاء تدقيق CN
شرح
contact_idمعرّف سجل جهة الاتصال الذي تريد بدء التدقيق له، يمكن إدخال معرّف جهة اتصال واحد فقط لكل طلب
contact_typeنوع جهة الاتصال, يمكن أن يكون "Individual" أو "Enterprise"
individual_id_typeنوع هوية الشخص الطبيعي، القيم المتوقعة (وصف القيمة) هي:
JGZ (بطاقة هوية ضابط في جمهورية الصين الشعبية)
SFZ (بطاقة الهوية لجمهورية الصين الشعبية)
HZ (جواز السفر)
GAJMTX (تصريح الخروج والدخول للسفر من وإلى هونغ كونغ وماكاو)
TWJMTX (تصاريح سفر لمقيمي تايوان لدخول البر الرئيسي أو مغادرته)
WJLSFZ (بطاقة الهوية الدائمة للأجانب من جمهورية الصين الشعبية)
GAJZZ (تصريح إقامة لهونغ كونغ وماكاو)
TWJZZ (تصريح إقامة لمقيمي تايوان)
QT (أخرى)
individual_license_idرقم رخصة هوية الشخص الطبيعي
individual_urlمستند رخصة الهوية لشخص طبيعي. رابط الملف على الخادم. يُسمح فقط بـ jpg, gif, png, jpeg
enterprise_id_type (Mandatory when contact type is "Enterprise")نوع معرّف المؤسسة, القيم المتوقعة (وصف القيمة) هي:
ORG (شهادة رمز المنظمة)
YYZZ (رخصة تجارية)
TYDM (شهادة رمز الائتمان الاجتماعي الموحد)
BDDM (تسمية الرمز العسكري)
JDDWFW (رخصة الخدمات الخارجية العسكرية المدفوعة)
SYDWFR (شهادة الشخص الاعتباري لمؤسسة عامة)
WGCZJG (نموذج تسجيل المكاتب التمثيلية المقيمة للشركات الأجنبية)
SHTTFR (شهادة تسجيل الشخص الاعتباري لمنظمة اجتماعية)
ZJCS (شهادة تسجيل موقع الأنشطة الدينية)
MBFQY (شهادة تسجيل كيان خاص غير مؤسسي)
JJHFR (شهادة تسجيل الشخص الاعتباري للصندوق)
LSZY (رخصة ممارسة شركة محاماة)
WGZHWH (شهادة تسجيل مركز ثقافي أجنبي في الصين)
WLCZJG (شهادة تسجيل الموافقة للمكتب التمثيلي المقيم لإدارات السياحة الحكومية الأجنبية)
SFJD (رخصة الخبرة القضائية)
JWJG (شهادة مؤسسة خارجية)
SHFWJG (شهادة تسجيل وكالة الخدمات الاجتماعية)
MBXXBX (تصريح مدرسة خاصة)
YLJGZY (ترخيص مزاولة المؤسسة الطبية)
GZJGZY (رخصة مزاولة منظمة التوثيق)
BJWSXX (تصريح مدرسة بكين لأطفال موظفي السفارات الأجنبية في الصين)
QTTYDM (أخرى-شهادة رمز الائتمان الاجتماعي الموحد)
QT (أخرى)
enterprise_license_id (Mandatory when contact type is "Enterprise")رقم ترخيص وثيقة المؤسسة
enterprise_url (Mandatory when contact type is "Enterprise")مستند ترخيص المؤسسة. رابط الملف على الخادم. يُسمح فقط بـ jpg، gif، png، jpeg
وسم XML للنتيجة
شرح
<CreateCnAuditResponse></CreateCnAuditResponse>العقدة الجذرية لمستند XML للاستجابة
<CreateCnAuditHeader></CreateCnAuditHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على إنشاء تدقيق Cn

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<CreateCnAuditResponse>
  <CreateCnAuditHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateCnAuditHeader>
</CreateCnAuditResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
الاستجابة (تنسيق JSON)
{
  "CreateCnAuditResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر جلب حالة تدقيق Cn

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء الأمر get cn audit status، يجب تضمين المعاملات التالية:

معامل طلب الحصول على حالة تدقيق Cn
شرح
contact_idمعرّف سجل جهة الاتصال الذي تريد الحصول على حالة التدقيق له، يمكن إدخال contactId واحد فقط لكل طلب
gtldإذا كنت تستعلم عن نتيجة التدقيق لـ cnnic-gtld، عيّن هذه المعلمة إلى 1
وسم XML للنتيجة
شرح
<GetCnAuditStatusResponse></GetCnAuditStatusResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetCnAuditStatusHeader></GetCnAuditStatusHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<CnAuditStatus></CnAuditStatus>حالة تدقيق سجل تدقيق cnnic. قد تحصل على 'قيد المعالجة' أو 'في انتظار cnnic' أو 'فشل'. إذا فشل، سنرسل لك بريدًا إلكترونيًا.
<FailedReason></FailedReason>إذا تعذّر اجتياز التدقيق, فسيتم عرض سبب الفشل

مثال على جلب حالة تدقيق Cn

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_cn_audit_status&contact_id=testcontactid
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
  <GetCnAuditStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <CnAuditStatus>pass</CnAuditStatus>
  </GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_cn_audit_status&contact_id=testcontactid
الاستجابة (تنسيق JSON)
{
  "GetCnAuditStatusResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "CnAuditStatus": "pass"
  }
}
 

أمر إنشاء جهة اتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر إنشاء جهة اتصال، يجب تضمين المعلمات التالية:

معامل طلب إنشاء جهة اتصال
شرح
organization (optional)معلومات المنظمة
nameالمصطلح
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز الدولة لرقم الهاتف
faxnum (optional)رقم الفاكس
faxcc (optional)رمز الدولة للفاكس
address1العنوان1
address2 (optional)العنوان 2
cityالمدينة
state (optional)الحالة
zipالرمز البريدي
countryالبلد
وسم XML للنتيجة
شرح
<CreateContactResponse></CreateContactResponse>العقدة الجذرية لمستند XML للاستجابة
<CreateContactHeader></CreateContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<CreateContactContent></CreateContactContent>معرّف جهة الاتصال الجديد, يُستخدم فقط عندما تكون الحالة "success"

مثال لإنشاء جهة اتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
الاستجابة (تنسيق XML)
<CreateContactResponse>
  <CreateContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateContactHeader>
  <CreateContactContent>
    <ContactId>1234</ContactId>
  </CreateContactContent>
</CreateContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
الاستجابة (تنسيق JSON)
{
   "CreateContactResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "CreateContactContent":{
         "ContactId":"0"
      }
   }
}
 

أمر تحرير جهة الاتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعديل جهة الاتصال، يجب تضمين المعاملات التالية:

معلمة طلب تعديل جهة الاتصال
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
organization (optional)معلومات المنظمة
nameالمصطلح
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز الدولة لرقم الهاتف
faxnum (optional)رقم الفاكس
faxcc (optional)رمز الدولة للفاكس
address1العنوان 1
address2 (optional)العنوان 2
cityالمدينة
stateالحالة
zipالرمز البريدي
countryالبلد
وسم XML للنتيجة
شرح
<EditContactResponse></EditContactResponse>العقدة الجذرية لمستند XML للاستجابة
<EditContactHeader></EditContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<EditContactContent></EditContactContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال

مثال تعديل جهة الاتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<EditContactResponse>
  <EditContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </EditContactHeader>
  <EditContactContent>
    <ContactId>0</ContactId>
  </EditContactContent>
</EditContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
الاستجابة (تنسيق JSON)
{
  "EditContactResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "EditContactContent": {
      "ContactId": "0"
    }
  }
}
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
الاستجابة (تنسيق CSV)
ok,

success,
,
 

أمر حذف جهة الاتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر حذف جهة الاتصال، فيجب تضمين المعلمات التالية:

معامل طلب حذف جهة الاتصال
شرح
contact_idمعرف جهة الاتصال التي تريد حذفها, تأكد من فصلها بفواصل
وسم XML للنتيجة
شرح
<DeleteContactResponse></DeleteContactResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteContactHeader></DeleteContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال حذف جهة الاتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_contact&contact_id=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_contact&contact_id=0
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteContactResponse>
  <DeleteContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteContactHeader>
</DeleteContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_contact&contact_id=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_contact&contact_id=0
الاستجابة (تنسيق JSON)
{
  "DeleteContactResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر قائمة جهات الاتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

معامل طلب قائمة جهات الاتصال
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجة
شرح
<ContactListResponse></ContactListResponse>العقدة الجذرية لمستند XML للاستجابة
<ContactListHeader></ContactListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ContactListContent></ContactListContent>محتوى الاستجابة
<ContactList></ContactList>قائمة جهات الاتصال
<Contact></Contact>معلومات الاتصال
<ContactId></ContactId>معرف جهة الاتصال
<Organization></Organization>منظمة جهة الاتصال
<Name></Name>المصطلح
<Email></Email>البريد الإلكتروني
<PhoneCc></PhoneCc>رمز الدولة لرقم الهاتف
<PhoneNum></PhoneNum>رقم الهاتف
<FaxCc></FaxCc>رمز الدولة للفاكس
<FaxNum></FaxNum>رقم الفاكس
<Address1></Address1>العنوان 1
<Address2></Address2>العنوان 2
<City></City>المدينة
<State></State>الحالة
<ZipCode></ZipCode>الرمز البريدي
<Country></Country>البلد
<GtldVerified></GtldVerified>حالة التحقق من gTLD

مثال قائمة جهات الاتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=contact_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=contact_list
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
  <ContactListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ContactListHeader>
  <ContactListContent>
    <ContactList>
      <Contact>
        <ContactId>0</ContactId>
        <Organization/>
        <Name>Jack tester</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>test street</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
      <Contact>
        <ContactId>1</ContactId>
        <Organization/>
        <Name>John tester</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>123.456.7890</PhoneNum>
        <FaxCc>1</FaxCc>
        <FaxNum>123.456.7890</FaxNum>
        <Address1>high Way first</Address1>
        <Address2/>
        <City>San Francisco</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>yes</GtldVerified>
      </Contact>
    </ContactList>
  </ContactListContent>
</ContactListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=contact_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=contact_list
الاستجابة (تنسيق JSON)
{
  "ContactListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ContactList": [
      {
        "ContactId": "0",
        "Organization": "",
        "Name": "Jack tester",
        "Email": "",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "test street",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "no"
      },
      {
        "ContactId": "1",
        "Organization": "",
        "Name": "John tester",
        "Email": "",
        "PhoneCc": "1",
        "PhoneNum": "123.456.7890",
        "FaxCc": "1",
        "FaxNum": "123.456.7890",
        "Address1": "high Way first",
        "Address2": "",
        "City": "San Francisco",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "yes"
      }
    ]
  }
}
 

أمر جلب جهة الاتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

الحصول على معلمة طلب جهة الاتصال
شرح
contact_idمعرّف جهة الاتصال
وسم XML للنتيجة
شرح
<GetContactResponse></GetContactResponse>العقدة الجذرية لمستند XML للاستجابة
<GetContactHeader></GetContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetContactContent></GetContactContent>محتوى الاستجابة
<Contact></Contact>معلومات الاتصال
<ContactId></ContactId>معرف جهة الاتصال
<Organization></Organization>منظمة جهة الاتصال
<Name></Name>المصطلح
<Email></Email>البريد الإلكتروني
<PhoneCc></PhoneCc>رمز الدولة لرقم الهاتف
<PhoneNum></PhoneNum>رقم الهاتف
<FaxCc></FaxCc>رمز الدولة للفاكس
<FaxNum></FaxNum>رقم الفاكس
<Address1></Address1>العنوان 1
<Address2></Address2>العنوان 2
<City></City>المدينة
<State></State>الحالة
<ZipCode></ZipCode>الرمز البريدي
<Country></Country>البلد
<GtldVerified></GtldVerified>حالة التحقق من gTLD

مثال الحصول على جهة الاتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_contact&contact_id=10000
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_contact&contact_id=10000
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetContactResponse>
  <GetContactHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetContactHeader>
  <GetContactContent>
    <GetContact>
      <Contact>
        <ContactId>12345</ContactId>
        <Organization>org</Organization>
        <Name>name</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>address1</Address1>
        <Address2>address2</Address2>
        <City>city</City>
        <State>state</State>
        <ZipCode>zipcode</ZipCode>
        <Country>country</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
    </GetContact>
  </GetContactContent>
</GetContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_contact&contact_id=10000
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_contact&contact_id=10000
الاستجابة (تنسيق JSON)
{
  "GetContactResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetContact": {
      "ContactId": "12345",
      "Organization": "org",
      "Name": "name",
      "Email": "",
      "PhoneCc": "1",
      "PhoneNum": "555.555.5233",
      "FaxCc": "",
      "FaxNum": "",
      "Address1": "address1",
      "Address2": "address2",
      "City": "city",
      "State": "state",
      "ZipCode": "zipcode",
      "Country": "country",
      "GtldVerified": "no"
    }
  }
}
 

أمر تعيين إعداد الاتصال بالاتحاد الأوروبي

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين إعداد جهة الاتصال في الاتحاد الأوروبي, يجب تضمين المعلمات التالية:

معامل طلب إعداد جهة الاتصال للاتحاد الأوروبي
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
country_of_citizenshipيجب أن تكون دولة عضو في الاتحاد الأوروبي. تتضمن رموز الدول الأعضاء ما يلي:
AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE
وسم XML للنتيجة
شرح
<SetContactEUSettingResponse></SetContactEUSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetContactEUSettingHeader></SetContactEUSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetContactEUSettingContent></SetContactEUSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال

مثال على إعداد جهة اتصال الاتحاد الأوروبي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
  <SetContactEUSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactEUSettingHeader>
  <SetContactEUSettingContent>
    <ContactId>0</ContactId>
  </SetContactEUSettingContent>
</SetContactEUSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
الاستجابة (تنسيق JSON)
{
  "SetContactEUSettingResponse": {
    "ResponseCode: ": "0",
    "Status": "Success",
    "SetContactEUSettingContent": {
      "ContactId: ": "0"
    }
  }
}
 

أمر تعيين إعداد LV لجهة الاتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر تعيين إعداد contact lv، فيجب تضمين المعلمات التالية:

تعيين معامل طلب إعداد LV لجهة الاتصال
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
registration_number- بالنسبة للأفراد، يرجى إدخال رقم الهوية اللاتفي.
- بالنسبة للشركات والكيانات القانونية الأخرى، يرجى إدخال رقم التسجيل الصادر من سجل المؤسسات اللاتفي.
vat_number (optional)رقم ضريبة القيمة المضافة للكيانات القانونية الأجنبية المسجلة في دول الاتحاد الأوروبي (يشمل ذلك أيضًا الشركات اللاتفية)
وسم XML للنتيجة
شرح
<SetContactLvSettingResponse></SetContactLvSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetContactLvSettingHeader></SetContactLvSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetContactLvSettingContent></SetContactLvSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال

مثال على إعداد تعيين مستوى جهة الاتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
  <SetContactLvSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactLvSettingHeader>
  <SetContactLvSettingContent>
    <ContactId>0</ContactId>
  </SetContactLvSettingContent>
</SetContactLvSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
الاستجابة (تنسيق JSON)
{
  "SetContactLvSettingResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetContactLvSettingContent": {
      "ContactId: ": "0"
    }
  }
}

مثال على إعداد إعدادات جهة الاتصال LV

طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
الاستجابة (تنسيق CSV)
ok,success,0
 

أمر تعيين إعداد LT لجهة الاتصال

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين إعداد LT لجهة الاتصال، فيجب تضمين المعاملات التالية:

معامل طلب تعيين إعداد LT لجهة الاتصال
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
organization_codeلا يمكنك تعيين رمز مؤسسة جهة الاتصال إلا بعد تعيين مؤسسة جهة الاتصال.
وسم XML للنتيجة
شرح
<SetContactLtSettingResponse></SetContactLtSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetContactLtSettingHeader></SetContactLtSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetContactLtSettingContent></SetContactLtSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال

مثال على تعيين إعداد LT لجهة الاتصال

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLtSettingResponse>
  <SetContactLtSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactLtSettingHeader>
  <SetContactLtSettingContent>
    <ContactId>0</ContactId>
  </SetContactLtSettingContent>
</SetContactLtSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
الاستجابة (تنسيق JSON)
{
  "SetContactLtSettingResponse": {
    "ResponseCode:": "0",
    "Status": "Success",
    "SetContactLtSettingContent": {
      "ContactId": "0"
    }
  }
}
 

أمر الحصول على خادم الأسماء

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا استدعيت أمر get name server، فيجب تضمين المعاملات التالية:

معلمة طلب الحصول على خادم الأسماء
شرح
domainالنطاق الذي تريد الحصول على معلومات خادم الأسماء الخاص به, يمكن جلب معلومات خادم الأسماء لنطاق واحد فقط في كل طلب.
وسم XML للنتيجة
شرح
<GetNsResponse></GetNsResponse>العقدة الجذرية لمستند XML للاستجابة
<GetNsHeader></GetNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<NsContent></NsContent>محتوى الاستجابة
<Host></Host>اسم مضيف الخادم
<NsName></NsName>اسم الخادم

مثال الحصول على خوادم الأسماء

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_ns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_ns&domain=mydomain.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetNsResponse>
  <GetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetNsHeader>
  <NsContent>
    <Host>ns1.mydomain.com</Host>
    <Host>ns2.mydomain.com</Host>
  </NsContent>
</GetNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_ns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_ns&domain=mydomain.com
الاستجابة (تنسيق JSON)
{
  "GetNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "NsContent": {
      "Host0": "ns1.mydomain.com",
      "Host1": "ns2.mydomain.com"
    }
  }
}
 

أمر إضافة خادم أسماء

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر إضافة خادم الأسماء, يجب تضمين المعلمات التالية:

معامل طلب إضافة خادم الأسماء
شرح
hostاسم المضيف لخادم الأسماء الذي تريد إضافته
وسم XML للنتيجة
شرح
<AddNsResponse></AddNsResponse>العقدة الجذرية لمستند XML للاستجابة
<AddNsHeader></AddNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<AddNsContent></AddNsContent>محتوى الاستجابة
<Server></Server>الخادم الذي قمت بتعيينه
<Host></Host>اسم مضيف الخادم الجديد
<ServerId></ServerId>معرّف الخادم الجديد

مثال على إضافة Ns

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_ns&host=ns1.mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_ns&host=ns1.mydomain.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<AddNsResponse>
  <AddNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddNsHeader>
  <AddNsContent>
    <Server>
      <Host>ns1.mydomain.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </AddNsContent>
</AddNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_ns&host=ns1.mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_ns&host=ns1.mydomain.com
الاستجابة (تنسيق JSON)
{
  "AddNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AddNsContent": {
      "Server": {
        "Host": "ns1.mydomain.com",
        "ServerId": 0
      }
    }
  }
}
 

أمر تسجيل خادم الأسماء

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تسجيل خادم الأسماء، فيجب تضمين المعلمات التالية:

معامل طلب تسجيل خادم الأسماء
شرح
hostاسم المضيف لخادم الأسماء الخاص بك
ipعنوان IP لخادم الأسماء الخاص بك
وسم XML للنتيجة
شرح
<RegisterNsResponse></RegisterNsResponse>العقدة الجذرية لمستند XML للاستجابة
<RegisterNsHeader></RegisterNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<RegisterNsContent></RegisterNsContent>محتوى الاستجابة
<Server></Server>وسم الخادم
<Host></Host>اسم المضيف
<ServerId></ServerId>معرف الخادم

مثال تسجيل خادم الأسماء

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
الاستجابة (تنسيق XML)
<RegisterNsResponse>
  <RegisterNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterNsHeader>
  <RegisterNsContent>
    <Server>
      <Host>domain1.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </RegisterNsContent>
</RegisterNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
الاستجابة (تنسيق JSON)
{
   "RegisterNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "RegisterNsContent":{
         "Server":{
            "Host":"ndomain1.com",
            "ServerId":"0"
         }
      }
   }
}
 

أمر تعيين IP خادم الأسماء

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء الأمر set name server IP، يجب تضمين المعاملات التالية:

معامل طلب تعيين IP خادم الأسماء
شرح
server_idمعرّف خادم الأسماء الذي تريد تعيينه
ip0 - ip9عنوان IP الذي تريد تعيينه لخادم الأسماء, يمكن تعيين 9 عناوين IP لكل طلب ويجب فصلها بفواصل
وسم XML للنتيجة
شرح
<SetNsIpResponse></SetNsIpResponse>العقدة الجذرية لمستند XML للاستجابة
<SetNsIpHeader></SetNsIpHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين IP خادم الأسماء

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
الاستجابة (تنسيق XML)
<SetNsIpResponse>
  <SetNsIpHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsIpHeader>
</SetNsIpResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
الاستجابة (تنسيق JSON)
{
   "SetNsIpResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر حذف خادم الأسماء

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر حذف خادم الأسماء, فيجب تضمين المعلمات التالية:

معامل طلب حذف خادم الأسماء
شرح
server_idمعرّف خوادم الأسماء التي تريد حذفها، تأكد من فصلها بفواصل
وسم XML للنتيجة
شرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteNsHeader></DeleteNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال حذف Ns

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns&server_id=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_ns&server_id=0
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns&server_id=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_ns&server_id=0
الاستجابة (تنسيق JSON)
{
  "DeleteNsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر حذف خادم الأسماء حسب النطاق

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا استدعيت أمر حذف خادم الأسماء حسب النطاق, يجب تضمين المعلمات التالية:

حذف خادم الأسماء بواسطة معامل طلب النطاق
شرح
server_domainاسم خادم الأسماء. مثال: ns1.testnameserver.com
وسم XML للنتيجة
شرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteNsHeader></DeleteNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال حذف خادم الأسماء حسب النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
الاستجابة (تنسيق XML)
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
الاستجابة (تنسيق JSON)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر قائمة الخوادم

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

معامل طلب قائمة الخوادم
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجة
شرح
<ServerListResponse></ServerListResponse>العقدة الجذرية لمستند XML للاستجابة
<ServerListHeader></ServerListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ServerListContent></ServerListContent>محتوى الاستجابة
<NameServerList></NameServerList>قائمة خوادم الأسماء
<List></List>
<Server></Server>
<ServerId></ServerId>معرف الخادم
<ServerName></ServerName>اسم الخادم
<ServerIp></ServerIp>IP الخادم

مثال قائمة الخوادم

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=server_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=server_list
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<ServerListResponse>
  <ServerListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ServerListHeader>
  <ServerListContent>
    <NameServerList>
      <List>
        <Server>
          <ServerId>0</ServerId>
          <ServerName>ns1.com</ServerName>
        </Server>
        <Server>
          <ServerId>1</ServerId>
          <ServerName>domain1.com</ServerName>
          <ServerIp>192.168.1.1</ServerIp>
          <ServerIp>1.1.1.1</ServerIp>
        </Server>
      </List>
    </NameServerList>
  </ServerListContent>
</ServerListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=server_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=server_list
الاستجابة (تنسيق JSON)
{
  "ServerListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ServerList": [
      {
        "ServerId": "0",
        "ServerName": "ns1.com"
      },
      {
        "ServerId": "1",
        "ServerName": "domain1.com",
        "ServerIps": [
          {
            "Ip": "192.168.1.1"
          },
          {
            "Ip": "1.1.1.1"
          }
        ]
      }
    ]
  }
}
 

أمر الحصول على إعدادات خادم أسماء النطاق

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر الحصول على إعدادات خوادم أسماء النطاق، يجب تضمين المعلمات التالية:

معامل طلب جلب إعدادات خادم أسماء النطاق
شرح
domainالنطاق الذي تريد الحصول على إعداد خادم الأسماء الخاص به, يمكن سحب إعداد خادم الأسماء لنطاق واحد فقط لكل طلب.
وسم XML للنتيجة
شرح
<GetDnsResponse></GetDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<GetDnsHeader></GetDnsHeader>ترويسة الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetDnsContent></GetDnsContent>محتوى الاستجابة
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء للنطاق
<Type></Type>نوع خادم الأسماء للنطاق

مثال على جلب إعدادات خادم أسماء النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_dns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_dns&domain=mydomain.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetDnsResponse>
  <GetDnsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetDnsHeader>
  <GetDnsContent>
    <NameServerSettings>
      <Type>Dynadot Parking</Type>
      <WithAds>Yes</WithAds>
    </NameServerSettings>
  </GetDnsContent>
</GetDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_dns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_dns&domain=mydomain.com
الاستجابة (تنسيق JSON)
{
  "GetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetDns": {
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      }
    }
  }
}
 

أمر معلومات الحساب

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

معامل طلب معلومات الحساب
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجة
شرح
<AccountInfoResponse></AccountInfoResponse>العقدة الجذرية لمستند XML للاستجابة
<AccountInfoHeader></AccountInfoHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<AccountInfoContent></AccountInfoContent>محتوى الاستجابة
<AccountInfo></AccountInfo>معلومات الحساب
<Username></Username>اسم المستخدم
<ForumName></ForumName>اسم المنتدى
<Contact></Contact>معلومات الاتصال
<Organization></Organization>المنظمة
<Organization></Organization>ترويسة الاستجابة
<Name></Name>اسمك
<Email></Email>البريد الإلكتروني
<PhoneCc></PhoneCc>رمز الدولة لرقم الهاتف
<PhoneNum></PhoneNum>رقم الهاتف
<Address1></Address1>العنوان 1
<Address2></Address2>العنوان 2
<City></City>المدينة
<State></State>الحالة
<ZipCode></ZipCode>الرمز البريدي
<Country></Country>البلد
<CustomerSince></CustomerSince>عميل منذ
<AccountLock></AccountLock>قفل الحساب
<TotalSpending></TotalSpending>إجمالي الإنفاق
<PriceLevel></PriceLevel>مستوى السعر
<AccountBalance></AccountBalance>رصيد الحساب
<CustomTimeZone></CustomTimeZone>منطقة زمنية مخصصة
<DefaultSettings></DefaultSettings>الإعدادات الافتراضية
<DefaultWhois></DefaultWhois>Whois الافتراضي
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرف جهة الاتصال
<DefaultAdmin></DefaultAdmin>مسؤول افتراضي
<DefaultTechnical></DefaultTechnical>تقني افتراضي
<DefaultBilling></DefaultBilling>الفوترة الافتراضية
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع إعلانات أم لا

مثال على معلومات الحساب

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=account_info
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=account_info
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
  <AccountInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AccountInfoHeader>
  <AccountInfoContent>
    <AccountInfo>
      <Username>testname</Username>
      <ForumName>test forum name</ForumName>
      <AvatarUrl>test avatar url</AvatarUrl>
      <Contact>
        <Organization/>
        <Name>testname test</Name>
        <Email></Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>1 test road</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90000</ZipCode>
        <Country>US</Country>
      </Contact>
      <CustomerSince>1364888735253</CustomerSince>
      <AccountLock>on</AccountLock>
      <TotalSpending>$0.00</TotalSpending>
      <PriceLevel>Regular Pricing</PriceLevel>
      <AccountBalance>$70.02</AccountBalance>
      <CustomTimeZone>PST</CustomTimeZone>
      <DefaultSettings>
        <DefaultWhois>
          <DefaultRegistrant>
            <ContactId>0</ContactId>
          </DefaultRegistrant>
          <DefaultAdmin>
            <ContactId>0</ContactId>
          </DefaultAdmin>
          <DefaultTechnical>
            <ContactId>0</ContactId>
          </DefaultTechnical>
          <DefaultBilling>
            <ContactId>0</ContactId>
          </DefaultBilling>
        </DefaultWhois>
        <DefaultNameServerSettings>
          <Type>Dynadot Parking</Type>
          <WithAds>yes</WithAds>
        </DefaultNameServerSettings>
      </DefaultSettings>
    </AccountInfo>
  </AccountInfoContent>
</AccountInfoResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=account_info
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=account_info
الاستجابة (تنسيق JSON)
{
  "AccountInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AccountInfo": {
      "Username": "testname",
      "ForumName": "test forum name",
      "AvatarUrl": "test avatar url",
      "Contact": {
        "Organization": "",
        "Name": "testname test",
        "Email": "",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "1 test road",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90000",
        "Country": "US"
      },
      "CustomerSince": "1364888735253",
      "AccountLock": "on",
      "TotalSpending": "$0.00",
      "PriceLevel": "Regular Pricing",
      "AccountBalance": "$70.02",
      "CustomTimeZone": "PST",
      "DefaultSettings": {
        "DefaultWhois": {
          "DefaultRegistrant": {
            "ContactId": "0"
          },
          "DefaultAdmin": {
            "ContactId": "0"
          },
          "DefaultTechnical": {
            "ContactId": "0"
          },
          "DefaultBilling": {
            "ContactId": "0"
          }
        },
        "DefaultNameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "yes"
        }
      }
    }
  }
}
 

أمر الحصول على رصيد الحساب

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

معامل طلب الحصول على رصيد الحساب
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجة
شرح
<GetAccountBalanceResponse></GetAccountBalanceResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetAccountBalanceHeader></GetAccountBalanceHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAccountBalanceContent></GetAccountBalanceContent>محتوى الاستجابة
<Balance></Balance>رصيد الحساب

مثال الحصول على رصيد الحساب

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_account_balance
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_account_balance
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetAccountBalanceResponse>
  <GetAccountBalanceHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAccountBalanceHeader>
  <GetAccountBalanceContent>
    <BalanceList>
      <Balance>
        <Currency>USD</Currency>
        <Amount>300.00</Amount>
      </Balance>
    </BalanceList>
  </GetAccountBalanceContent>
</GetAccountBalanceResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_account_balance
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_account_balance
الاستجابة (تنسيق JSON)
{
  "GetAccountBalanceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BalanceList": [
      {
        "Currency": "USD",
        "Amount": "300.00"
      }
    ]
  }
}
 

تعيين Whois الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا تم استدعاء أمر تعيين Whois الافتراضي، فيجب تضمين المعلمات التالية:

تعيين معامل طلب Whois الافتراضي
شرح
registrant_contactمعلومات المُسجِّل الخاصة بالنطاق
admin_contactمعلومات المسؤول عن النطاق
technical_contactالمعلومات التقنية للنطاق
billing_contactمعلومات الفوترة الخاصة بالنطاق
وسم XML للنتيجة
شرح
<SetDefaultWhoisResponse></SetDefaultWhoisResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultWhoisHeader></SetDefaultWhoisHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين Whois الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق XML)
<SetDefaultWhoisResponse>
   <SetDefaultWhoisHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultWhoisHeader>
</SetDefaultWhoisResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق JSON)
{
   "SetDefaultWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين خوادم الأسماء الافتراضية

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين خوادم الأسماء الافتراضية، يجب تضمين المعاملات التالية:

معامل طلب تعيين خوادم الأسماء الافتراضية
شرح
ns0 - ns12خوادم الأسماء التي تريد تعيينها
وسم XML للنتيجة
شرح
<SetDefaultNsResponse></SetDefaultNsResponse>وسم استجابة تعيين خوادم الأسماء الافتراضية, إنه العقدة الجذرية لمستند XML للاستجابة
<SetDefaultNsHeader></SetDefaultNsHeader>وسم ترويسة تعيين خوادم الأسماء الافتراضية
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetDefaultNsContent></SetDefaultNsContent>وسم محتوى تعيين خوادم الأسماء الافتراضية, يُستخدم فقط عندما تكون الحالة "success"
<Servers></Servers>معلومات الخوادم التي قمت بتعيينها
<Server></Server>كل خادم
<ServerName></ServerName>اسم الخادم
<ServerId></ServerId>معرف الخادم

مثال تعيين Ns الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultNsResponse>
  <SetDefaultNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultNsHeader>
  <SetDefaultNsContent>
    <Servers>
      <Server>
        <ServerName>ns1.hosts.com</ServerName>
        <ServerId>0</ServerId>
      </Server>
      <Server>
        <ServerName>ns2.hosts.com</ServerName>
        <ServerId>1</ServerId>
      </Server>
    </Servers>
  </SetDefaultNsContent>
</SetDefaultNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
الاستجابة (تنسيق JSON)
{
  "SetDefaultNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetDefaultNsContent": {
      "Servers": [
        {
          "ServerName": "ns1.hosts.com",
          "ServerId": "0"
        },
        {
          "ServerName": "ns2.hosts.com",
          "ServerId": "1"
        }
      ]
    }
  }
}
 

أمر تعيين الباركينغ الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين الباركينغ الافتراضي، فيجب تضمين المعاملات التالية:

تعيين معلمة طلب الركن الافتراضي
شرح
with_ads (optional)إذا كنت لا تريد إعلانات طرف ثالث، يمكنك استخدام هذه المعلمة مع "no"، والقيمة الافتراضية هي "yes"
وسم XML للنتيجة
شرح
<SetDefaultParkingResponse></SetDefaultParkingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultParkingHeader></SetDefaultParkingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين الإيقاف الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق XML)
<SetDefaultParkingResponse>
   <SetDefaultParkingHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultParkingHeader>
</SetDefaultParkingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق JSON)
{
   "SetDefaultParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين إعادة التوجيه الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين إعادة التوجيه الافتراضي، فيجب تضمين المعاملات التالية:

معامل طلب تعيين إعادة التوجيه الافتراضي
شرح
forward_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (optional)حالة إعادة التوجيه للنطاق الذي تريده، القيمة الافتراضية هي "temporary"، وإذا كنت تريد إعادة التوجيه بشكل دائم، استخدم هذه المعلمة مع "no"
وسم XML للنتيجة
شرح
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إعادة التوجيه الافتراضية

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
الاستجابة (تنسيق XML)
<SetDefaultForwardingResponse>
  <SetDefaultForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultForwardingHeader>
</SetDefaultForwardingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
الاستجابة (تنسيق JSON)
{
   "SetDefaultForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين التخفي الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين التخفي الافتراضي، يجب تضمين المعاملات التالية:

تعيين معامل طلب التخفي الافتراضي
شرح
stealth_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (optional)عنوان الصفحة
وسم XML للنتيجة
شرح
<SetDefaultStealthResponse></SetDefaultStealthResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultStealthHeader></SetDefaultStealthHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال لتعيين Stealth الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق XML)
<SetDefaultStealthResponse>
  <SetDefaultStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultStealthHeader>
</SetDefaultStealthResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق JSON)
{
   "SetDefaultStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين الاستضافة الافتراضية

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين الاستضافة الافتراضية، يجب تضمين المعلمات التالية:

تعيين معلمة طلب الاستضافة الافتراضية
شرح
hosting_typeنوع الاستضافة الافتراضية التي تريدها، يمكنك الاختيار ضمن "advanced" و"basic"
وسم XML للنتيجة
شرح
<SetDefaultHostingResponse></SetDefaultHostingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultHostingHeader></SetDefaultHostingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين الاستضافة الافتراضية

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_hosting&hosting_type=advanced
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_hosting&hosting_type=advanced
الاستجابة (تنسيق XML)
<SetDefaultHostingResponse>
  <SetDefaultHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultHostingHeader>
</SetDefaultHostingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_hosting&hosting_type=advanced
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_hosting&hosting_type=advanced
الاستجابة (تنسيق JSON)
{
   "SetDefaultHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين DNS الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين DNS الافتراضي، فيجب تضمين المعلمات التالية:

( هذا الأمر قديم وغير موصى به، يُرجى استخدام أمر تعيين DNS2 الافتراضي بدلاً منه )

تعيين معامل طلب DNS الافتراضي
شرح
main_record_typeنوع السجل الرئيسي
main_recordحدد سجل DNS لنطاقك
main_txt (optional)حدد سجل TXT لنطاقك. إذا كان main_record_type الخاص بك هو aaaa وحددت main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2, يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (optional)عنوان IP أو المضيف الهدف
mx_host0 - mx_host2 (optional)حدد مضيف البريد لنطاقك, distance0 هي الأولوية الأعلى.
mx_distance0 - mx_distance2 (optional)Distance0 له الأولوية القصوى
ttl (optional)مدة البقاء
وسم XML للنتيجة
شرح
<SetDefaultDnsResponse></SetDefaultDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultDnsHeader></SetDefaultDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين DNS الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين DNS2 الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين DNS الافتراضي، فيجب تضمين المعلمات التالية:

معامل طلب تعيين DNS2 الافتراضي
شرح
main_record_type0 - main_record_type19نوع السجل الرئيسي
main_record0 - main_record19حدد سجل DNS لنطاقك
main_recordx0 - main_recordx19مسافة Mx، ونوع التوجيه، وعنوان التوجيه المخفي أو اسم بريد إلكتروني مستعار، مطلوبة عندما تكون main_record هي "a", "aaaa", "cname", "forward", "txt", "mx", "stealth", "email"
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (optional)عنوان IP للنطاق الفرعي أو المضيف الهدف
sub_recordx0 - subdo_recordx99مسافة Mx، نوع إعادة التوجيه، عنوان إعادة التوجيه الخفي أو اسم بريد إلكتروني مستعار، ضروري عندما يكون sub_record_type هو "a"، "aaaa"، "cname"، "forward"، "txt"، "srv"، "mx"، "stealth"، "email"
ttl (optional)مدة البقاء
وسم XML للنتيجة
شرح
<SetDefaultDnsResponse></SetDefaultDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultDnsHeader></SetDefaultDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين DNS2 الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين إعادة توجيه البريد الإلكتروني الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء الأمر set default email forward، يجب تضمين المعاملات التالية:

معامل طلب تعيين إعادة توجيه البريد الإلكتروني الافتراضي
شرح
forward_typeنوع التحويل, يمكن أن يكون "donot": عدم تحويل البريد الإلكتروني, "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX), "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم, يُستخدم فقط عندما تكون "forward_type" هي "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الموجود، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هو أعلى أولوية، يُستخدم فقط عندما يكون "forward_type" هو "mx"
وسم XML للنتيجة
شرح
<SetDefaultEmailForwardingResponse></SetDefaultEmailForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين إعادة توجيه البريد الإلكتروني الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
الاستجابة (تنسيق XML)
<SetDefaultEmailForwardingResponse>
  <SetDefaultEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
الاستجابة (تنسيق JSON)
{
   "SetDefaultEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر Set Clear Default Setting

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء الأمر set clear default setting، فيجب تضمين المعلمات التالية:

تعيين معلمة طلب مسح الإعداد الافتراضي
شرح
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، و "nameservers"
وسم XML للنتيجة
شرح
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين مسح الإعداد الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_default_setting&service=nameservers
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_default_setting&service=nameservers
الاستجابة (تنسيق XML)
<SetClearDefaultSettingResponse>
  <SetClearDefaultSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_default_setting&service=nameservers
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_default_setting&service=nameservers
الاستجابة (تنسيق JSON)
{
   "SetClearDefaultSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين خيار التجديد الافتراضي

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين خيار التجديد الافتراضي، يجب تضمين المعلمات التالية:

معامل طلب تعيين خيار التجديد الافتراضي
شرح
renew_optionيمكن أن يكون "donot"، "auto"، "reset"
وسم XML للنتيجة
شرح
<SetDefaultRenewOptionResponse></SetDefaultRenewOptionResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultRenewOptionHeader></SetDefaultRenewOptionHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين خيار التجديد الافتراضي

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_renew_option&renew_option=auto
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_renew_option&renew_option=auto
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultRenewOptionResponse>
  <SetDefaultRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_renew_option&renew_option=auto
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_renew_option&renew_option=auto
الاستجابة (تنسيق JSON)
{
  "SetDefaultRenewOptionResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر إنشاء مجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر إنشاء مجلد، يجب تضمين المعلمات التالية:

معلمة طلب إنشاء مجلد
شرح
folder_nameاسم المجلد الذي تريد إنشاؤه
وسم XML للنتيجة
شرح
<FolderCreateResponse></FolderCreateResponse>العقدة الجذرية لمستند XML للاستجابة
<FolderCreateHeader></FolderCreateHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<FolderCreateContent></FolderCreateContent>محتوى الاستجابة
<FolderName></FolderName>اسم المجلد
<FolderId></FolderId>معرّف المجلد الجديد

مثال على إنشاء مجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_folder&folder_name=new
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_folder&folder_name=new
الاستجابة (تنسيق XML)
<FolderCreateResponse>
  <FolderCreateHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </FolderCreateHeader>
  <FolderCreateContent>
    <FolderName>new</FolderName>
    <FolderId>1</FolderId>
  </FolderCreateContent>
</FolderCreateResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_folder&folder_name=new
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_folder&folder_name=new
الاستجابة (تنسيق JSON)
{
   "FolderCreateResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "FolderCreateContent":{
         "FolderName":"new",
         "FolderId":"1"
      }
   }
}
 

أمر حذف المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر set Whois، فيجب تضمين المعاملات التالية:

معامل طلب حذف المجلد
شرح
folder_idمعرف المجلدات التي تريد حذفها، تأكد من أنها مفصولة بفواصل
وسم XML للنتيجة
شرح
<DeleteFolderResponse></DeleteFolderResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteFolderHeader></DeleteFolderHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال حذف مجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_folder&folder_id=0,1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_folder&folder_id=0,1
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteFolderResponse>
  <DeleteFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteFolderHeader>
</DeleteFolderResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_folder&folder_id=0,1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_folder&folder_id=0,1
الاستجابة (تنسيق JSON)
{
  "DeleteFolderResponse": {
    "SuccessCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين Whois للمجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين مجلد Whois، يجب تضمين المعاملات التالية:

معلمة طلب Whois لتعيين المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
registrant_contactمعلومات المُسجِّل الخاصة بالنطاق
admin_contactمعلومات المسؤول عن النطاق
technical_contactالمعلومات التقنية للنطاق
billing_contactمعلومات الفوترة الخاصة بالنطاق
enable (optional)إذا كنت تريد تطبيق إعداد Whois هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد Whois هذا لجميع النطاقات في هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
وسم XML للنتيجة
شرح
<SetFolderWhoisResponse></SetFolderWhoisResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderWhoisHeader></SetFolderWhoisHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين Whois للمجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق XML)
<SetFolderWhoisResponse>
  <SetFolderWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderWhoisHeader>
</SetFolderWhoisResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق JSON)
{
   "SetFolderWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين خوادم أسماء المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر set folder name servers, يجب تضمين المعلمات التالية:

معامل طلب تعيين خوادم أسماء المجلد
شرح
fold_idمعرف المجلد الذي تريد تعيينه، يمكن تعيين مجلد واحد فقط لكل طلب
ns0 - ns12خوادم الأسماء التي تريد تعيين نطاقك لاستخدامها، يمكنك تحديد حتى 13 خادم أسماء، ولكن يجب أن تكون موجودة بالفعل في حسابك
enable (optional)إذا كنت تريد تطبيق إعداد خوادم الأسماء هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد خادم الأسماء لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<SetFolderNsResponse></SetFolderNsResponse>وسم استجابة خادم تعيين اسم المجلد، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة.
<SetFolderNsHeader></SetFolderNsHeader>علامة تعيين رأس استجابة خادم أسماء المجلد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetFolderNsContent></SetFolderNsContent>وسم محتوى استجابة خادم الأسماء للمجلد المحدد، يُستخدم فقط عندما تكون الحالة "success"
<Servers></Servers>معلومات الخوادم التي قمت بتعيينها
<Server></Server>كل خادم
<ServerName></ServerName>اسم الخادم
<ServerId></ServerId>معرف الخادم

مثال تعيين Ns للمجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderNsResponse>
  <SetFolderNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNsHeader>
  <SetFolderNsContent>
    <Servers>
      <Server>
        <ServerName>ns1.hosts.com</ServerName>
        <ServerId>0</ServerId>
      </Server>
      <Server>
        <ServerName>ns2.hosts.com</ServerName>
        <ServerId>1</ServerId>
      </Server>
    </Servers>
  </SetFolderNsContent>
</SetFolderNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
الاستجابة (تنسيق JSON)
{
  "SetFolderNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetFolderNsContent": {
      "Servers": [
        {
          "ServerName": "ns1.hosts.com",
          "ServerId": "0"
        },
        {
          "ServerName": "ns2.hosts.com",
          "ServerId": "1"
        }
      ]
    }
  }
}
 

أمر تعيين إيقاف المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين مجلد الإيقاف, فيجب تضمين المعاملات التالية:

تعيين معامل طلب باركينغ المجلد
شرح
folder_idمعرف المجلد الذي تريد تعيينه، يمكن تعيين مجلد واحد فقط لكل طلب
with_ads (optional)إذا كنت لا تريد إعلانات طرف ثالث، يمكنك استخدام هذه المعلمة مع "no"، والقيمة الافتراضية هي "yes"
enable (optional)إذا كنت تريد تطبيق إعداد الـ parking هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد الباركينغ لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<SetFolderParkingResponse></SetFolderParkingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderParkingHeader></SetFolderParkingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على إعداد باركينغ المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق XML)
<SetFolderParkingResponse>
  <SetFolderParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderParkingHeader>
</SetFolderParkingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق JSON)
{
   "SetFolderParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين إعادة توجيه المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين إعادة توجيه المجلد، يجب تضمين المعلمات التالية:

معامل طلب تعيين إعادة توجيه المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
forward_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (optional)حالة إعادة التوجيه للنطاق الذي تريده، القيمة الافتراضية هي "temporary"، وإذا كنت تريد إعادة التوجيه بشكل دائم، استخدم هذه المعلمة مع "no"
enable (optional)إذا كنت تريد تطبيق إعداد إعادة التوجيه هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد, يمكنك استخدام هذا المعامل مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد إعادة التوجيه لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<SetFolderForwardingResponse></SetFolderForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderForwardingHeader></SetFolderForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين إعادة توجيه المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
الاستجابة (تنسيق XML)
<SetFolderForwardingResponse>
  <SetFolderForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderForwardingHeader>
</SetFolderForwardingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
الاستجابة (تنسيق JSON)
{
   "SetFolderForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين تخفي المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء أمر set folder stealth, فيجب تضمين المعلمات التالية:

تعيين معلمة طلب إخفاء المجلد
شرح
folder_idمعرف المجلد الذي تريد تعيينه
stealth_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (optional)عنوان الصفحة
enable (optional)إذا كنت تريد تطبيق إعداد التخفي هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل بالقيمة "yes"
sync (optional)إذا كنت تريد مزامنة إعداد التخفي لجميع النطاقات في هذا المجلد, يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<SetFolderStealthResponse></SetFolderStealthResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderStealthHeader></SetFolderStealthHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين التخفي للمجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
الاستجابة (تنسيق XML)
<SetFolderStealthResponse>
  <SetFolderStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderStealthHeader>
</SetFolderStealthResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
الاستجابة (تنسيق JSON)
{
   "SetFolderStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين استضافة المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين مجلد الاستضافة، فيجب تضمين المعاملات التالية:

تعيين معلمة طلب استضافة المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
hosting_typeنوع الاستضافة التي تريدها، يمكنك الاختيار بين "advanced" و"basic"
enable (optional)إذا كنت تريد تطبيق إعداد الاستضافة هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
even (optional)إذا كنت تريد مزامنة إعداد الاستضافة لجميع النطاقات في هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
وسم XML للنتيجة
شرح
<SetFolderHostingResponse></SetFolderHostingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderHostingHeader></SetFolderHostingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين استضافة المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
الاستجابة (تنسيق XML)
<SetFolderHostingResponse>
  <SetFolderHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHostingHeader>
</SetFolderHostingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
الاستجابة (تنسيق JSON)
{
   "SetFolderHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين DNS للمجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين DNS للمجلد، يجب تضمين المعلمات التالية:

( هذا الأمر قديم وغير موصى به, يُرجى استخدام الأمر Set Folder DNS2 بدلاً من ذلك )

معامل طلب تعيين DNS للمجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
main_record_typeنوع السجل الرئيسي
main_recordحدد سجل DNS لنطاقك
main_recordحدد سجل DNS لنطاقك
with_ads (optional)حدد سجل TXT لنطاقك. إذا كان main_record_type الخاص بك هو aaaa وحددت main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2, يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي (اختياري)
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (optional)عنوان IP أو المضيف الهدف
mx_host0 - mx_host2 (optional)حدد مضيف البريد لنطاقك, distance0 هي الأولوية الأعلى.
mx_distance0 - mx_distance2 (optional)Distance0 هي أعلى أولوية
ttl (optional)مدة البقاء
enable (optional)إذا كنت تريد تطبيق إعداد DNS هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد, يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد خادم DNS هذا لكل النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderDnsHeader></SetFolderDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين DNS للمجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON)
{
   "SetFolderDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين مجلد DNS2

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي الأمر set folder DNS2, فيجب تضمين المعاملات التالية:

تعيين معلمة طلب DNS2 للمجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
main_record_type0 - main_record_type19نوع السجل الرئيسي، يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email"
main_record0 - main_record19حدد سجل DNS لنطاقك
main_recordx0 - main_recordx19مسافة Mx, نوع التحويل, عنوان التحويل المتخفي أو الاسم المستعار للبريد الإلكتروني, مطلوب عندما يكون main_record_type هو "forward","mx","stealth","email"
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي (اختياري)
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي, يجب أن يكون "a", "aaaa", "cname", "forward", "txt", "srv", "mx", "stealth", "email"
sub_record0 - sub_record99 (optional)عنوان IP أو المضيف الهدف
sub_recordx0 - sub_recordx99 (optional)مسافة Mx، ونوع التوجيه، وعنوان التوجيه المخفي أو اسم بريد إلكتروني مستعار، مطلوبة عندما تكون sub_record_type هي "forward","mx","stealth","email"
ttl (optional)مدة البقاء
enable (optional)إذا كنت تريد تطبيق إعداد DNS هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد, يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد خادم DNS هذا لكل النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderDnsHeader></SetFolderDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين مجلد Dns2

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON)
{
  "SetFolderDnsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين إعادة توجيه البريد الإلكتروني للمجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر set folder email forward, يجب تضمين المعلمات التالية:

معامل طلب تعيين إعادة توجيه البريد الإلكتروني للمجلد
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
folder_idمعرّف المجلد الذي تريد تعيينه
forward_typeنوع التحويل, يمكن أن يكون "donot": عدم تحويل البريد الإلكتروني, "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX), "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم, يُستخدم فقط عندما تكون "forward_type" هي "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الموجود، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هو أعلى أولوية، يُستخدم فقط عندما يكون "forward_type" هو "mx"
enable (optional)إذا كنت تريد تطبيق هذا الإعداد على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل بالقيمة "yes"
sync (optional)إذا كنت تريد مزامنة هذا الإعداد لجميع النطاقات في هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
وسم XML للنتيجة
شرح
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إعادة توجيه البريد الإلكتروني للمجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
الاستجابة (تنسيق XML)
<SetFolderEmailForwardingResponse>
  <SetFolderEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
الاستجابة (تنسيق JSON)
{
   "SetFolderEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين إعداد مسح المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا قمت باستدعاء الأمر set clear folder setting، فيجب تضمين المعلمات التالية:

تعيين معلمة طلب إعداد مسح المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، و "nameservers"
وسم XML للنتيجة
شرح
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetClearFolderSettingHeader></SetClearFolderSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إعداد تفريغ المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
الاستجابة (تنسيق XML)
<SetClearFolderSettingResponse>
  <SetClearFolderSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearFolderSettingHeader>
</SetClearFolderSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
الاستجابة (تنسيق JSON)
{
   "SetClearFolderSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين اسم المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

إذا كنت تستدعي أمر تعيين اسم المجلد، يجب تضمين المعلمات التالية:

تعيين معامل طلب اسم المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
folder_nameاسم المجلد الجديد
وسم XML للنتيجة
شرح
<SetFolderNameResponse></SetFolderNameResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderNameHeader></SetFolderNameHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال تعيين اسم المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_name&folder_id=0&folder_name=new
الاستجابة (تنسيق XML)
<SetFolderNameResponse>
  <SetFolderNameHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNameHeader>
</SetFolderNameResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_name&folder_id=0&folder_name=new
الاستجابة (تنسيق JSON)
{
   "SetFolderNameResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين خيار تجديد المجلد

دعم تعدد الخيوط
دعم بيئة اختبار API

عند استدعاء أمر تعيين خيار تجديد المجلد، يجب تضمين المعاملات التالية:

معامل طلب تعيين خيار تجديد المجلد
شرح
folder_idمعرف المجلد الذي تريد تعيينه، يمكن تعيين مجلد واحد فقط لكل طلب
renew_optionخيار التجديد الذي تريد تعيينه للمجلد؛ يمكن أن يكون "donot" أو "auto" أو "reset"
enable (optional)إذا كنت تريد تطبيق إعداد التجديد هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل بالقيمة "yes"
sync (optional)إذا كنت تريد مزامنة إعداد التجديد لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجة
شرح
<Response></Response>العقدة الجذرية لمستند XML للاستجابة
<ResponseHeader></ResponseHeader>ResponseHeader
<ResponseCode></ResponseCode>رمز الاستجابة, "0" للنجاح, "-1" للفشل
<Error></Error>معلومات الخطأ، تُستخدم فقط عندما يكون رمز الاستجابة هو "-1"

مثال تعيين خيار تجديد المجلد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
الاستجابة (تنسيق XML)
<SetFolderRenewOptionResponse>
  <SetFolderRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
الاستجابة (تنسيق JSON)
{
   "SetFolderRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر عرض قائمة المجلدات

دعم تعدد الخيوط
دعم بيئة اختبار API

هذا الأمر متاح فقط بصيغة XML و JSON:

معامل طلب قائمة المجلدات
شرح
N/Aلا حاجة إلى معامل إضافي
<FolderListResponse></FolderListResponse>العقدة الجذرية لمستند XML للاستجابة
<FolderListHeader></FolderListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<FolderListContent></FolderListContent>محتوى الاستجابة
<FolderList></FolderList>قائمة المجلدات
<List></List>
<Folder></Folder>
<FolderId></FolderId>معرّف المجلد
<FolderName></FolderName>اسم المجلد
<DefaultWhois></DefaultWhois>Whois الافتراضي
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>حالة تمكين Whois الافتراضية
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرّف جهة الاتصال
<DefaultAdmin></DefaultAdmin>مسؤول افتراضي
<DefaultTechnical></DefaultTechnical>معلومات تقنية افتراضية
<DefaultBilling></DefaultBilling>معلومات الفوترة الافتراضية
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>حالة تفعيل خادم الأسماء الافتراضي
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع إعلانات أم لا
<DefaultRenewOption></DefaultRenewOption>خيار التجديد الافتراضي
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>حالة تفعيل خيار التجديد الافتراضي
<RenewOption></RenewOption>خيار التجديد
<DefaultTransferLock></DefaultTransferLock>قفل النقل الافتراضي
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>حالة تمكين قفل النقل الافتراضي
<LockStatus></LockStatus>حالة القفل

مثال على قائمة المجلدات

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=folder_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=folder_list
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<FolderListResponse>
  <FolderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </FolderListHeader>
  <FolderListContent>
    <FolderList>
      <List>
        <Folder>
          <FolderId>0</FolderId>
          <FolderName>new</FolderName>
          <DefaultWhois>
            <DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
            <DefaultRegistrant>
              <ContactId>0</ContactId>
            </DefaultRegistrant>
            <DefaultAdmin>
              <ContactId>0</ContactId>
            </DefaultAdmin>
            <DefaultTechnical>
              <ContactId>0</ContactId>
            </DefaultTechnical>
            <DefaultBilling>
              <ContactId>0</ContactId>
            </DefaultBilling>
          </DefaultWhois>
          <DefaultNameServers>
            <DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
            <NameServerSettings>
              <Type>Dynadot Parking</Type>
              <WithAds>Yes</WithAds>
            </NameServerSettings>
          </DefaultNameServers>
          <DefaultRenewOption>
            <DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
            <RenewOption>no renew option</RenewOption>
          </DefaultRenewOption>
          <DefaultTransferLock>
            <DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
            <LockStatus>locked</LockStatus>
          </DefaultTransferLock>
        </Folder>
      </List>
    </FolderList>
  </FolderListContent>
</FolderListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=folder_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=folder_list
الاستجابة (تنسيق JSON)
{
  "FolderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "FolderList": [
      {
        "FolderId": "0",
        "FolderName": "new",
        "DefaultWhois": {
          "DefaultWhoisEnableStatus": "disable",
          "DefaultRegistrant": {
            "ContactId": "0"
          },
          "DefaultAdmin": {
            "ContactId": "0"
          },
          "DefaultTechnical": {
            "ContactId": "0"
          },
          "DefaultBilling": {
            "ContactId": "0"
          }
        },
        "DefaultNameServers": {
          "DefaultTransferLockEnableStatus": "disable",
          "NameServerSettings": {
            "Type": "Dynadot Parking",
            "WithAds": "Yes"
          }
        },
        "DefaultRenewOption": {
          "DefaultRenewOptionEnableStatus": "disable",
          "RenewOption": "no renew option"
        },
        "DefaultTransferLock": {
          "DefaultTransferLockEnableStatus": "disable",
          "LockStatus": "locked"
        }
      }
    ]
  }
}
 

أمر إضافة طلب الحجز المسبق

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

إذا قمت باستدعاء أمر طلب إضافة backorder، فيجب تضمين المعلمات التالية:

معامل طلب إضافة طلب الحجز المسبق
شرح
domainالنطاق (النطاقات) التي تريد إضافتها وتوافق على الدفع مقابلها إذا التقطها Dynadot، يمكن إضافة 100 نطاق لكل طلب، ويجب فصلها بفواصل.
وسم XML للنتيجة
شرح
<AddBackorderRequestResponse></AddBackorderRequestResponse>العقدة الجذرية لمستند XML للاستجابة
<AddBackorderRequestHeader></AddBackorderRequestHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال طلب إضافة حجز مسبق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
الاستجابة (تنسيق XML)
<AddBackorderRequestResponse>
  <AddBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddBackorderRequestHeader>
</AddBackorderRequestResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
الاستجابة (تنسيق JSON)
{
   "AddBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر حذف طلب الحجز المسبق

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

عند استدعاء أمر حذف طلب الحجز المسبق, يجب تضمين المعلمات التالية:

معامل طلب حذف طلب الحجز المسبق
شرح
domainالنطاق (النطاقات) التي تريد إزالتها من قائمة طلبات الحجز المسبق الخاصة بك، يمكن إزالة 100 نطاق لكل طلب، ويجب فصلها بفواصل
وسم XML للنتيجة
شرح
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على طلب حذف الحجز المسبق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_backorder_request&domain=domaindropp.com
الاستجابة (تنسيق XML)
<DeleteBackorderRequestResponse>
  <DeleteBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_backorder_request&domain=domaindropp.com
الاستجابة (تنسيق JSON)
{
   "DeleteBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر قائمة طلبات الحجز المسبق

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر قائمة طلبات الحجز المسبق سيرجع قائمة طلبات الحجز المسبق للحساب المحدد. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب قائمة طلبات الحجز المسبق
شرح
start_dateتاريخ بدء الإسقاط للمزاد الذي تريد طلبه, yyyy-mm-dd, مثل 2015-05-05
end_dateتاريخ انتهاء الإسقاط للمزاد الذي تريد طلبه, yyyy-mm-dd, مثل 2015-05-05
وسم XML للنتيجة
شرح
<BackorderRequestListResponse></BackorderRequestListResponse>العقدة الجذرية لمستند XML للاستجابة
<BackorderRequestListHeader></BackorderRequestListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<BackorderRequestListContent></BackorderRequestListContent>محتوى الاستجابة
<BackorderRequestList></BackorderRequestList>قائمة طلبات الحجز المسبق
<BackorderRequest></BackorderRequest>طلب حجز مسبق
<Domain></Domain>النطاق الموجود في قائمتك
<CutoffTime></CutoffTime>تاريخ القطع لحذف طلب بتوقيت Unix (مللي ثانية منذ منتصف الليل UTC في 1 يناير 1970)
<BackorderRequestStatus></BackorderRequestStatus>الحالة في عملية التقاط النطاقات الساقطة

مثال على قائمة طلبات الحجز المسبق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<BackorderRequestListResponse>
  <BackorderRequestListHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </BackorderRequestListHeader>
  <BackorderRequestListContent>
    <BackorderRequestList>
      <BackorderRequest>
        <DomainName>testdrop.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop3.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop4.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop5.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
    </BackorderRequestList>
  </BackorderRequestListContent>
</BackorderRequestListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
الاستجابة (تنسيق JSON)
{
  "BackorderRequestListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BackorderRequestList": [
      {
        "DomainName": "testdrop.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop3.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop4.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop5.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      }
    ]
  }
}
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
الاستجابة (تنسيق CSV)
ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
 

أمر جلب المزادات المفتوحة

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر جلب المزادات المفتوحة سيعيد قائمة بالمزادات الجارية. إذا استدعيت هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب جلب المزادات المفتوحة
شرح
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
type (optional)نوع المزاد الذي تريد رؤيته, يجب أن يكون "expired", "user", "backorder", أو "registry_expired", "registrar", إذا كنت تريد الحصول على أكثر من نوع مزاد, يمكنك استخدام "," لفصل كل نوع مزاد
count_per_pageكم عدد الكيانات المعروضة في الصفحة (بحد أقصى 1000)
page_index كيانات أي صفحة تريد عرضها؟
has_bids (optional)عندما تكون هذه المعلمة صحيحة، فسيتم إرجاع المزادات التي تم تقديم عروض عليها فقط. إذا كانت خاطئة، فسيتم إرجاع المزادات التي ليس بها عروض. إذا لم يتم تمريرها، فسيتم إرجاع جميع المزادات.
وسم XML للنتيجة
شرح
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>وسم استجابة الحصول على المزادات المفتوحة، إنه العقدة الجذرية لمستند XML الخاص بالاستجابة
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>الحصول على عنوان المزادات المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetOpenAuctionsContent></GetOpenAuctionsContent>Tag of get open auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار النطاق
<Links></Links>الروابط الواردة للنطاق
<Age></Age>عمر النطاق

مثال على جلب المزادات المفتوحة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
الاستجابة (تنسيق XML)
<GetOpenAuctionsResponse>
  <GetOpenAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenAuctionsHeader>
  <GetOpenAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    .
    .
    .
  </GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
طلب(تنسيق csv)

https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1

الاستجابة

ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.

طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_open_auctions&currency=usd&type=expired&count_per_page=20&page_index=1
الاستجابة (تنسيق JSON)
{
    "status": "success",
    "auction_list": [
        {
            "auction_id": 11,
            "domain": "domain.com",
            "utf_name": "domain.com",
            "is_idn": false,
            "auction_type": "expired",
            "currency": "USD",
            "current_bid_price": "124.00",
            "bids": 4,
            "bidders": 2,
            "time_left": "1 day, 23 hours",
            "start_time": "2022/03/28 02:20 PST",
            "start_time_stamp": 1648459234033,
            "end_time": "2022/04/04 02:20 PST",
            "end_time_stamp": 1649064034033,
            "visitors": 223,
            "links": "-",
            "age": 0,
            "dyna_appraisal": "-"
        },
        {
            "auction_id": 12,
            "domain": "domain0.com",
            "utf_name": "domain0.com",
            "is_idn": false,
            "auction_type": "expired",
            "currency": "USD",
            "current_bid_price": "44.99",
            "bids": 1,
            "bidders": 1,
            "time_left": "2 days, 23 hours",
            "start_time": "2022/03/29 02:20 PST",
            "start_time_stamp": 1648545634049,
            "end_time": "2022/04/05 02:20 PST",
            "end_time_stamp": 1649150434049,
            "visitors": 245,
            "links": "-",
            "age": 0,
            "dyna_appraisal": "-"
        }
        ...
    ]
}
 

أمر الحصول على تفاصيل المزاد

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء الأمر get auction details سيعيد تفاصيل المزاد المحدد. هذا الأمر متاح فقط بصيغة XML و JSON. إذا قمت باستدعاء هذا الأمر، يجب تضمين المعلمات التالية:

معلمة طلب الحصول على تفاصيل المزاد
شرح
domainاسم النطاق للمزاد، يجب أن يستخدم IDN (اسم النطاق الدولي) punycode، مثل "xn--wkccg.com". يمكنك الحصول على أكثر من مزاد واحد، ويجب فصل كل نطاق بواسطة ","
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>وسم استجابة الحصول على تفاصيل المزاد، إنه العقدة الجذرية لمستند XML للاستجابة
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>ترويسة تفاصيل مزاد الطلب المسبق
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Tag of get auction details content, it's only used when status is "success"
<AuctionStatusId></AuctionStatusId>معرف حالة المزاد : '0' قيد التقدم، '1' ملغي بواسطة المستخدم، '2' ملغي بواسطة المشرف، '3' ملغي بواسطة التجديد، '4' مكتمل، '5' ملغي بواسطة النقل بعيداً
<AuctionStatus></AuctionStatus>حالة المزاد
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو صاحب أعلى مزايدة
<YourCurrentBid></YourCurrentBid>سعر مزايدتك الحالي للمزاد المحدد. إذا لم تقدم مزايدة، فسيكون '-1'
<YourProxyBid></YourProxyBid>لك مزايدة بالوكالة للمزاد المحدد. إذا لم تكن قد قدمت عرضًا, فستكون '-1'
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<IsPremium></IsPremium>ما إذا كان نطاقًا مميزًا
<RenewalPrice></RenewalPrice>سعر التجديد

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

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetAuctionDetailsResponse>
  <GetAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAuctionDetailsHeader>
  <GetAuctionDetailsContent>
    <Auction>
      <AuctionStatusId>0</AuctionStatusId>
      <AuctionStatus>1</AuctionStatus>
      <AuctionId>0</AuctionId>
      <Domain>test.biz</Domain>
      <BidPrice>46.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>1970/01/01 00:00 UTC</EndTime>
      <EndTimestamp>0</EndTimestamp>
      <Revenue>1</Revenue>
      <RevenueCurrency>USD</RevenueCurrency>
      <Visitors>-1</Visitors>
      <Links>1</Links>
      <Age>10</Age>
      <isPremium>false</isPremium>
      <RenewalPrice>-0.1</RenewalPrice>
      <UserIsHighBid>false</UserIsHighBid>
      <YourCurrentBid>-1</YourCurrentBid>
      <YourProxyBid>-1</YourProxyBid>
    </Auction>
  </GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
الاستجابة (تنسيق JSON)
{
  "status": "success",
  "size": 1,
  "auction_details": [
    {
      "auction_json": {
        "auction_id": 0,
        "domain": "test.biz",
        "utf_name": "test.biz",
        "is_idn": false,
        "auction_type": "expired",
        "current_bid_price": "46.99",
        "accepted_bid_price": "46.99",
        "currency": "USD",
        "is_high_bidder": false,
        "bids": 0,
        "bidders": 0,
        "auction_status_id": 0,
        "time_left": "1",
        "start_time": "1",
        "start_time_stamp": 0,
        "end_time": "",
        "end_time_stamp": 0,
        "revenue": "1",
        "visitors": -1,
        "links": "1",
        "age": 10,
        "estibot_appraisal": "",
        "dyna_appraisal": "",
        "bidder_name": "",
        "bid_price": "",
        "timestamp": 0,
        "bid_status": "",
        "is_proxy_auto_bid": false,
        "auction_ended": false,
        "customer_bided": false,
        "customer_bid": "1",
        "customer_proxy_bid": "1",
        "is_premium": false,
        "renewal_price": "-0.1"
      },
      "bid_history": []
    }
  ]
}
 

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

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر get auction bids سيجلب قائمة مزايداتك التي شاركت فيها. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:

معامل طلب جلب مزايدات المزاد
شرح
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
count_per_pageكم عدد الكيانات المعروضة في كل صفحة (بحد أقصى 50)
page_index كيانات أي صفحة تريد عرضها؟
وسم XML للنتيجة
شرح
<GetAuctionBidsResponse></GetAuctionBidsResponse>علامة استجابة الحصول على مزايدات المزاد، إنها العقدة الجذرية لمستند XML للاستجابة
<GetAuctionBidsHeader></GetAuctionBidsHeader>ترويسة Get auction bids
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAuctionBidsContent></GetAuctionBidsContent>Tag of get auction bids content, it's only used when status is "success"
<BidList></BidList> قائمة المزايدات
<Bid></Bid> عنصر المزايدة
<BidId></BidId> معرّف المزايدة
<AuctionId></AuctionId> معرّف المزاد
<AccountId></AccountId>معرّف الحساب
<Domain></Domain>اسم نطاق المزاد
<DomainUtf></DomainUtf>اسم utf للنطاق الخاص بالمزاد
<AuctionType></AuctionType>نوع المزاد
<IsIdn></IsIdn>إذا كان هذا النطاق اسم نطاق دولي
<CurrentBid></CurrentBid>سعر العرض الحالي للمزاد
<YourStatus></YourStatus>حالة مزايدتك في المزاد
<ProxyBid></ProxyBid>سعر مزايدتك الوكيلية للمزاد
<ActiveBidders></ActiveBidders>عدد المزايدين المشاركين في هذا المزاد
<TimeLeft></TimeLeft>الوقت المتبقي للمزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>الطابع الزمني لانتهاء المزاد

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

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
الاستجابة (تنسيق XML)
<GetAuctionBidsResponse>
    <GetAuctionBidsHeader>
        <SuccessCode>0</SuccessCode>
        <Status>success</Status>
    </GetAuctionBidsHeader>
    <GetAuctionBidsContent>
        <BidList>
            <Bid>
                <BidId>0</BidId>
                <AuctionId>11</AuctionId>
                <AccountId>1</AccountId>
                <Domain>domain.com</Domain>
                <DomainUtf>domain.com</DomainUtf>
                <AuctionType>expired</AuctionType>
                <IsIdn>false</IsIdn>
                <CurrentBid>$124.00</CurrentBid>
                <YourStatus>Out Bid</YourStatus>
                <ProxyBid>$119.00</ProxyBid>
                <ActiveBidders>2</ActiveBidders>
                <TimeLeft>1 day, 6 hours</TimeLeft>
                <EndTime>2022/04/04 02:20:34 PST</EndTime>
                <EndTimestamp>1649064034033</EndTimestamp>
            </Bid>
            <Bid>
                <BidId>9</BidId>
                <AuctionId>12</AuctionId>
                <AccountId>1</AccountId>
                <Domain>domain0.com</Domain>
                <DomainUtf>domain0.com</DomainUtf>
                <AuctionType>expired</AuctionType>
                <IsIdn>false</IsIdn>
                <CurrentBid>$44.99</CurrentBid>
                <YourStatus>High Bidder</YourStatus>
                <ProxyBid>$121.00</ProxyBid>
                <ActiveBidders>1</ActiveBidders>
                <TimeLeft>2 days, 6 hours</TimeLeft>
                <EndTime>2022/04/05 02:20:34 PST</EndTime>
                <EndTimestamp>1649150434049</EndTimestamp>
            </Bid>
        </BidList>
    </GetAuctionBidsContent>
</GetAuctionBidsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_auction_bids&currency=usd&count_per_page=20&page_index=1
الاستجابة (تنسيق JSON)
{
    "status": "success",
    "auction_bids": [
        {
            "bid_id": 0,
            "auction_id": 11,
            "account_id": "1",
            "domain": "domain.com",
            "domain_utf": "domain.com",
            "auction_type": "expired",
            "is_idn": false,
            "current_bid": "$44.99",
            "your_status": "High Bidder",
            "proxy_bid": "$119.00",
            "active_bidders": 1,
            "time_left": "1 day, 23 hours",
            "end_time": "2022/04/04 02:20:34 PST",
            "end_time_stamp": 1649064034033
        },
        {
            "bid_id": 2,
            "auction_id": 12,
            "account_id": "1",
            "domain": "domain0.com",
            "domain_utf": "domain0.com",
            "auction_type": "expired",
            "is_idn": false,
            "current_bid": "$44.99",
            "your_status": "High Bidder",
            "proxy_bid": "$119.00",
            "active_bidders": 1,
            "time_left": "2 days, 23 hours",
            "end_time": "2022/04/05 02:20:34 PST",
            "end_time_stamp": 1649150434049
        }
        ...
    ]
}
 

أمر تقديم مزايدة في المزاد

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

سيؤدي استدعاء أمر تقديم مزايدة المزاد إلى تقديم مزايدة للمزاد المحدد. عند استدعاء هذا الأمر, يجب تضمين المعاملات التالية:

معامل طلب تقديم مزايدة في المزاد
شرح
domainاسم النطاق للمزاد، يجب أن يستخدم اسم النطاق الدولي (IDN) ترميز punycode، مثل "xn--wkccg.com"
bid_amountمبلغ عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها بواسطة معلمة العملة أدناه
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<PlaceAuctionBidResponse></PlaceAuctionBidResponse>وسم استجابة عرض مزاد المكان، إنها العقدة الجذرية لمستند XML للاستجابة
<PlaceAuctionBidHeader></PlaceAuctionBidHeader>عنوان تقديم عرض المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال النطاق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
الاستجابة (تنسيق XML)
<PlaceAuctionBidResponse>
  <PlaceAuctionBidHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
طلب(تنسيق csv)

https://api.dynadot.com/api3.html?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd

الاستجابة

ok,success

طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
الاستجابة (تنسيق JSON)
{
    "status": "success",
    "auction_details": {
        "auction_json": {
            "auction_id": 12,
            "domain": "example.com",
            "utf_name": "example.com",
            "is_idn": false,
            "auction_type": "expired",
            "current_bid_price": "44.99",
            "accepted_bid_price": "45.99",
            "currency": "USD",
            "is_high_bidder": true,
            "bids": 3,
            "bidders": 2,
            "time_left": "2 days, 22 hours",
            "start_time": "2022/03/29 02:20 PST",
            "start_time_stamp": 1648545634049,
            "end_time": "2022/04/05 02:20 PST",
            "end_time_stamp": 1649150434049,
            "revenue": "$26.50",
            "visitors": 245,
            "links": "-",
            "age": 0,
            "dyna_appraisal": "-",
            "auction_ended": false,
            "customer_bided": true,
            "customer_bid": "44.99",
            "customer_proxy_bid": "$121.00"
        },
        "bid_history": [
            {
                "bidder_name": "You",
                "bid_price": "44.99",
                "currency": "USD",
                "timestamp": 1648892255084,
                "bid_status": "High Bidder",
                "is_proxy_auto_bid": false
            }
            ...        ]
    }
}
 

أمر جلب المزادات المغلقة

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء الأمر get closed auctions سيُرجع قائمة بالمزادات المغلقة لحساب محدّد. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب الحصول على المزادات المغلقة
شرح
start_dateالطابع الزمني الذي يشير إلى بداية وقت انتهاء المزاد, yyyy-mm-dd, مثل 2015-05-05
end_dateالطابع الزمني الذي يشير إلى نهاية وقت انتهاء المزاد, yyyy-mm-dd, مثل 2015-05-05
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>وسم استجابة الحصول على المزادات المغلقة، إنه العقدة الجذرية لمستند XML للاستجابة
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>الحصول على ترويسة المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>Tag of get closed auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<AuctionStatusId></AuctionStatusId>معرّف حالة المزاد, '0' قيد التقدم و'1' مغلق بواسطة المستخدم, '2' مغلق بواسطة المسؤول, '3' مغلق بواسطة التجديد, '4' مغلق بسبب انتهاء المهلة, '5' مغلق بواسطة النقل بعيداً
<AuctionStatus></AuctionStatus>حالة المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<AuctionWonStatus></AuctionWonStatus>إذا فاز المستخدم بهذا المزاد
<YourHighBid></YourHighBid>أعلى مزايدة لك في هذا المزاد
<YourProxyBid></YourProxyBid>مزايدتك بالوكالة في هذا المزاد

مثال الحصول على المزادات المغلقة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedAuctionsResponse>
  <GetClosedAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedAuctionsContent>
    <Auction>
      <AuctionId>2</AuctionId>
      <Domain>testdomain1.test</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
    <Auction>
      <AuctionId>3</AuctionId>
      <Domain>testdomain2.test</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
  </GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق JSON)
{
  "GetClosedAuctionsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Auctions": [
      {
        "AuctionId": "2",
        "Domain": "testdomain1.test",
        "AuctionStatusId": "4",
        "AuctionStatus": "Closed by Timeout",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "AuctionWonStatus": "won",
        "YourHighBid": "89.99",
        "YourProxyBid": "1000.0"
      },
      {
        "AuctionId": "3",
        "Domain": "testdomain2.test",
        "AuctionStatusId": "4",
        "AuctionStatus": "Closed by Timeout",
        "BidPrice": "28.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "AuctionWonStatus": "won",
        "YourHighBid": "28.99",
        "YourProxyBid": "1000.0"
      }
    ]
  }
}
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق CSV)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
 

أمر الحصول على مزادات الحجز المسبق المفتوحة

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

سيؤدي استدعاء الأمر get open backorder auctions إلى إرجاع قائمة بمزادات الحجز المسبق الجارية. إذا قمت باستدعاء هذا الأمر، فيجب تضمين المعاملات التالية:

معامل طلب الحصول على مزادات الطلبات المسبقة المفتوحة
شرح
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>وسم استجابة get open backorder auctions, إنه العقدة الجذرية لمستند XML الخاص بالاستجابة
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>الحصول على عنوان مزادات الحجز المسبق المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>Tag of get open backorder auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)

مثال على جلب مزادات الحجز المسبق المفتوحة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_backorder_auctions&currency=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_open_backorder_auctions&currency=usd
الاستجابة (تنسيق XML)
<GetOpenBackorderAuctionsResponse>
  <GetOpenBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenBackorderAuctionsHeader>
  <GetOpenBackorderAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    .
    .
    .
  </GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
طلب(تنسيق csv)

https://api.dynadot.com/api3.html?key=mykey&command=get_open_backorder_auctions¤cy=usd

الاستجابة

ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp
10000,backorder0.com,6.35,USD,0,2017/08/29 17:53 UTC,1504029194453
10001,backorder1.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
10002,backorder2.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
.
.
.

 

أمر الحصول على تفاصيل مزاد الحجز المسبق

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء الأمر get backorder auction details سيُعيد تفاصيل المزاد المحدد. هذا الأمر متاح فقط في تنسيق XML و JSON. إذا استدعيت هذا الأمر، يجب تضمين المعاملات التالية:

معلمة طلب الحصول على تفاصيل المزاد
شرح
domainاسم النطاق للمزاد المطلوب مسبقًا، يجب أن يستخدم IDN (اسم النطاق الدولي) punycode، مثل "xn--wkccg.com"
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>وسم استجابة الحصول على تفاصيل المزاد، إنه العقدة الجذرية لمستند XML للاستجابة
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>ترويسة الحصول على تفاصيل المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Tag of get auction details content, it's only used when status is "success"
<AuctionStatusId></AuctionStatusId>معرّف حالة المزاد, '0' قيد التقدم و'1' مغلق بواسطة المستخدم, '2' مغلق بواسطة المسؤول, '3' مغلق بواسطة التجديد, '4' مغلق بسبب انتهاء المهلة, '5' مغلق بواسطة النقل بعيداً
<AuctionStatus></AuctionStatus>حالة المزاد
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار النطاق
<Links></Links>الروابط الواردة للنطاق
<Age></Age>عمر النطاق
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو صاحب أعلى مزايدة
<YourCurrentBid></YourCurrentBid>سعر مزايدتك الحالي للمزاد المحدد. إذا لم تقدم مزايدة، فسيكون '-1'
<YourProxyBid></YourProxyBid>لك مزايدة بالوكالة للمزاد المحدد. إذا لم تكن قد قدمت عرضًا, فستكون '-1'

مثال على Get Backorder Auction Details

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetBackorderAuctionDetailsResponse>
  <GetBackorderAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetBackorderAuctionDetailsHeader>
  <GetBackorderAuctionDetailsContent>
    <AuctionStatusId>0</AuctionStatusId>
    <AuctionStatus>In Progress</AuctionStatus>
    <UserIsHighBid>no</UserIsHighBid>
    <YourCurrentBid>-1</YourCurrentBid>
    <YourProxyBid>-1</YourProxyBid>
    <Auction>
      <AuctionId>10001</AuctionId>
      <Domain>example.com</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>2015/04/28 18:16 UTC</EndTime>
      <EndTimestamp>1430244969779</EndTimestamp>
    </Auction>
  </GetBackorderAuctionDetailsContent>
</GetBackorderAuctionDetailsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
الاستجابة (تنسيق JSON)
{
  "GetBackorderAuctionDetailsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetBackorderAuctionDetails": {
      "AuctionStatusId": "0",
      "AuctionStatus": "In Progress",
      "UserIsHighBid": "no",
      "YourCurrentBid": "-1",
      "YourProxyBid": "-1",
      "Auction": {
        "AuctionId": "10001",
        "Domain": "example.com",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "0",
        "EndTime": "2015/04/28 18:16 UTC",
        "EndTimestamp": "1430244969779"
      }
    }
  }
}
 

أمر تقديم مزايدة في مزاد الطلب المسبق

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

سيؤدي استدعاء أمر تقديم عرض مزاد backorder إلى تقديم عرض للمزاد المحدد. إذا قمت باستدعاء هذا الأمر، فيجب تضمين المعلمات التالية:

معلمة طلب تقديم مزايدة في مزاد الحجز المسبق
شرح
domainاسم النطاق للمزاد، يجب أن يستخدم اسم النطاق الدولي (IDN) ترميز punycode، مثل "xn--wkccg.com"
bid_amountمبلغ عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها بواسطة معلمة العملة أدناه
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<PlaceBakcorderAuctionBidResponse></PlaceBakcorderAuctionBidResponse>وسم استجابة عرض مزاد المكان، إنها العقدة الجذرية لمستند XML للاستجابة
<PlaceBackorderAuctionBidHeader></PlaceBackorderAuctionBidHeader>عنوان تقديم عرض المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تقديم عرض في مزاد الحجز المسبق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
الاستجابة (تنسيق XML)
<PlaceBakcorderAuctionBidResponse>
 <PlaceBackorderAuctionBidHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
الاستجابة (تنسيق JSON)
{
   "PlaceBakcorderAuctionBidResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
الاستجابة (تنسيق CSV)
ok,success
 

أمر جلب مزادات الحجز المسبق المغلقة

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء الأمر get closed backorder auctions سيعيد قائمة بالمزادات المغلقة للطلبات المسبقة للحساب المحدد. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:

معامل طلب جلب مزادات الطلبات المسبقة المغلقة
شرح
start_dateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
end_dateتاريخ انتهاء المزاد, yyyy-mm-dd, مثل 2015-05-05
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>وسم استجابة الحصول على المزادات المغلقة، إنه العقدة الجذرية لمستند XML للاستجابة
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>الحصول على ترويسة المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>Tag of get closed auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<YourHighBid></YourHighBid>أعلى مزايدة لك في هذا المزاد
<YourProxyBid></YourProxyBid>مزايدتك بالوكالة في هذا المزاد
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<AuctionStatusId></AuctionStatusId>معرّف حالة المزاد, '0' قيد التقدم و'1' مغلق بواسطة المستخدم, '2' مغلق بواسطة المسؤول, '3' مغلق بواسطة التجديد, '4' مغلق بسبب انتهاء المهلة, '5' مغلق بواسطة النقل بعيداً
<AuctionStatus></AuctionStatus>حالة المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد

مثال على جلب مزادات الطلب المسبق المغلقة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedBackorderAuctionsResponse>
  <GetClosedBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedBackorderAuctionsHeader>
  <GetClosedBackorderAuctionsContent>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>2</AuctionId>
      <Domain>testdomain1.test</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <EndTime>2022/04/04 02:20:34 PST</EndTime>
      <EndTimestamp>1649064034033</EndTimestamp>
    </Auction>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>3</AuctionId>
      <Domain>testdomain2.test</Domain>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <EndTime>2022/04/05 02:20:34 PST</EndTime>
      <EndTimestamp>1649150434049</EndTimestamp>
    </Auction>
  </GetClosedBackorderAuctionsContent>
</GetClosedBackorderAuctionsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق JSON)
{
  "GetClosedBackorderAuctionsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Auctions": [
      {
        "AuctionWonStatus": "won",
        "YourHighBid": "89.99",
        "YourProxyBid": "1000.0",
        "AuctionId": "2",
        "Domain": "testdomain1.test",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "EndTime": "2022/04/04 02:20:34 PST",
        "EndTimestamp": "1649064034033"
      },
      {
        "AuctionWonStatus": "won",
        "YourHighBid": "28.99",
        "YourProxyBid": "1000.0",
        "AuctionId": "3",
        "Domain": "testdomain2.test",
        "BidPrice": "28.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "EndTime": "2022/04/05 02:20:34 PST",
        "EndTimestamp": "1649150434049"
      }
    ]
  }
}
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق CSV)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
 

أمر الحصول على النطاقات المنتهية الصلاحية والمغلقة

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر جلب النطاقات المنتهية للإغلاق سيجلب النطاقات المنتهية للإغلاق. هذا الأمر متاح فقط بصيغة XML وJSON. إذا تم استدعاء هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب الحصول على النطاقات المنتهية والمغلقة
شرح
currency(optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
domain(optional)أضف هذه المعلمة إذا كنت تريد الاستعلام عن نطاق إغلاق
count_per_page (optional)كم عدد الكيانات التي تُعرض في كل صفحة
page_index (optional)كيانات أي صفحة تريد عرضها؟
وسم XML للنتيجة
شرح
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>وسم استجابة Get Expired Closeout Domains، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>الحصول على ترويسة النطاقات المنتهية الصلاحية للتصفية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>Tag of content, it's only used when status is "success"
<CloseoutItem></CloseoutItem>عنصر الإغلاق
<DomainName></DomainName>اسم النطاق
<DomainNameUtf></DomainNameUtf>اسم النطاق بتنسيق utf
<CurrentPrice></CurrentPrice>السعر الحالي
<isIdn></isIdn>ما إذا كان اسم النطاق IDN
<EndTimeStamp></EndTimeStamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<RenewalPrice></RenewalPrice>سعر التجديد
<ExpiredRevenue></ExpiredRevenue>إيرادات الإغلاق
<DynaAppraisal></DynaAppraisal>DynaAppraisal
<InboundLinks></InboundLinks>الروابط الواردة للنطاق
<MonthlyVisitors></MonthlyVisitors>زوار النطاق
<Currency></Currency>العملة

مثال الحصول على النطاقات المنتهية الصلاحية للتصفية

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
  <GetExpiredCloseoutDomainsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetExpiredCloseoutDomainsHeader>
  <GetExpiredCloseoutDomainsContent>
    <CloseoutItem>
      <DomainName>test.biz</DomainName>
      <DomainNameUtf>test.biz</DomainNameUtf>
      <CurrentPrice>9.91</CurrentPrice>
      <IsIDN>false</IsIDN>
      <EndTimeStamp>0</EndTimeStamp>
      <RenewalPrice>9.99</RenewalPrice>
      <ExpiredRevenue>9.90</ExpiredRevenue>
      <EstibotAppraisal>1223</EstibotAppraisal>
      <InboundLinks>-1</InboundLinks>
      <MonthlyVisitors>-1</MonthlyVisitors>
      <Currency>usd</Currency>
    </CloseoutItem>
  </GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
الاستجابة (تنسيق JSON)
{
  "GetExpiredCloseoutDomainsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Size": 1,
    "CloseoutDomains": [
      {
        "closeoutItem": {
          "domainName": "test.biz",
          "domainNameUtf": "test.biz",
          "currentPrice": "9.91",
          "isIdn": false,
          "endTimeStamp": 0,
          "renewalPrice": "9.99",
          "expiredRevenue": "9.90",
          "estibotAppraisal": "1223",
          "inboundLinks": -1,
          "monthlyVisitors": -1,
          "currency": "usd"
        }
      }
    ]
  }
}
 

أمر شراء نطاق منتهي الصلاحية من نوع Closeout

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر شراء النطاق المنتهي للتصفية سيؤدي إلى شراء اسم النطاق المحدد. هذا الأمر متاح فقط بصيغة XML و JSON. إذا قمت باستدعاء هذا الأمر، فيجب تضمين المعاملات التالية:

معامل طلب شراء نطاق منتهي الصلاحية للإغلاق
شرح
domainالنطاق الذي تريد شراءه، يمكن إدخال نطاق واحد فقط لكل طلب
currency(optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>وسم استجابة شراء نطاق Closeout منتهي الصلاحية, إنه العقدة الجذرية لمستند XML للاستجابة
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>عنوان شراء نطاق منتهي الصلاحية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال شراء نطاق منتهي الصلاحية ومغلق

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
  <BuyExpiredCloseoutDomainHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
الاستجابة (تنسيق JSON)
{
  "BuyExpiredCloseoutDomainResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

أمر جلب الإدراجات

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

إذا كنت تستدعي الأمر get listings, فيجب تضمين المعاملات التالية:

معلمة طلب جلب القوائم
شرح
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
exclude_pending_sale (optional)If you don't want to get pending sale lock listings, it should be "yes", default is "no"
show_other_registrar (optional)إذا كنت تريد الحصول على قوائم المسجلين الآخرين، يجب أن تكون "yes"، الافتراضي هو "no"
count_per_pageكم عدد الكيانات المعروضة في كل صفحة. (الحد الأقصى 20000)
page_indexأي كيانات الصفحة تريد عرضها.
وسم XML للنتيجة
شرح
<GetListingsResponse></GetListingsResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetListingsHeader></GetListingsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetListingsContent></GetListingsContent>محتوى الإدراج
<Listing></Listing>محتوى عنصر الإدراج
<ListingId></ListingId>معرّف القائمة
<Domain></Domain>اسم النطاق
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر

مثال على الحصول على القوائم

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsResponse>
  <GetListingsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetListingsHeader>
  <GetListingsContent>
    <Listing>
      <ListingId>id1</ListingId>
      <Domain>domain_name1</Domain>
      <Price>1</Price>
      <InboundLinks>1</InboundLinks>
      <Age>1</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
      <Type>BIN</Type>
      <RegistrationDate>1791875010217</RegistrationDate>
      <ExpirationDate>1791875010217</ExpirationDate>
    </Listing>
    <Listing>
      <ListingId>id2</ListingId>
      <Domain>domain_name2</Domain>
      <Price>2</Price>
      <InboundLinks>2</InboundLinks>
      <Age>2</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
      <Type>MAKE_OFFER</Type>
      <RegistrationDate>1791875010217</RegistrationDate>
      <ExpirationDate>1791875010217</ExpirationDate>
    </Listing>
  </GetListingsContent>
</GetListingsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&currency=usd&command=get_listings&count_per_page=20&page_index=1
الاستجابة (تنسيق JSON)
{
  "GetListingsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Total": 2,
    "Listing": [
      {
        "ListingId": "id1",
        "Domain": "domain_name1",
        "Price": "1",
        "InboundLinks": "1",
        "Age": "1",
        "PendingSaleLocked": "No",
        "RegistrationDate": 1791875010217,
        "ExpirationDate": 1791875010217,
        "Type": "BIN"
      },
      {
        "ListingId": "id2",
        "Domain": "domain_name2",
        "Price": "2",
        "InboundLinks": "2",
        "Age": "2",
        "PendingSaleLocked": "No",
        "RegistrationDate": 1791875010217,
        "ExpirationDate": 1791875010217,
        "Type": "MAKE_OFFER"
      }
    ]
  }
}
 

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

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

عند استدعاء الأمر get listing item، يجب تضمين المعلمات التالية:

معامل طلب جلب عنصر القائمة
شرح
domainاسم النطاق الذي تريد الحصول على تفاصيله, يمكن إدخال نطاق واحد فقط لكل طلب
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجة
شرح
<GetListingItemResponse></GetListingItemResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetListingItemHeader></GetListingItemHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetListingsItemContent></GetListingsItemContent>محتوى الإدراج
<Listing></Listing>محتوى عنصر الإدراج
<ListingId></ListingId>معرّف القائمة
<Domain></Domain>اسم النطاق
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر

مثال الحصول على عنصر الإدراج

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_listing_item&currency=usd&domain=domain_name
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_listing_item&currency=usd&domain=domain_name
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsItemResponse>
  <GetListingsItemHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetListingsItemHeader>
  <GetListingsItemContent>
    <Listing>
      <ListingId>id</ListingId>
      <Domain>domain_name</Domain>
      <Price>0</Price>
      <InboundLinks>0</InboundLinks>
      <Age>0</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
      <Type>BIN</Type>
      <RegistrationDate>1791875010218</RegistrationDate>
      <ExpirationDate>1791875010218</ExpirationDate>
    </Listing>
  </GetListingsItemContent>
</GetListingsItemResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_listing_item&currency=usd&domain=domain_name
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_listing_item&currency=usd&domain=domain_name
الاستجابة (تنسيق JSON)
{
  "GetListingsItemResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Listing": {
      "ListingId": "id",
      "Domain": "domain_name",
      "Price": "0",
      "InboundLinks": "0",
      "Age": "0",
      "PendingSaleLocked": "No",
      "RegistrationDate": 1791875010218,
      "ExpirationDate": 1791875010218,
      "Type": "BIN"
    }
  }
}
 

أمر اشترِ الآن

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

إذا كنت تستدعي أمر الشراء الآن، يجب تضمين المعاملات التالية:

معامل طلب الشراء الفوري
شرح
domainالنطاق الذي تريد شراءه، يمكن إدخال نطاق واحد فقط لكل طلب
currency (optional)عملة نتيجة الإرجاع، يجب أن تكون "usd" أو "eur" أو "cny"، إذا لم يتم إدخال عملة، سيتم تطبيق العملة الافتراضية للحساب.
price_to_verify (optional)سعر buy_it_now المتوقع الذي يجب التحقق منه قبل الشراء. إذا لم يتطابق سعر الإدراج الفعلي مع هذه القيمة، سيفشل الطلب.
وسم XML للنتيجة
شرح
<BuyItNowResponse></BuyItNowResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<BuyItNowHeader></BuyItNowHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<Message></Message>يجب أن يكون "domain order created"، ويُستخدم فقط عندما تكون الحالة "success".

مثال على الشراء الآن

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<BuyItNowResponse>
  <BuyItNowHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </BuyItNowHeader>
  <BuyItNowContent>
    <OrderId>1</OrderId>
  </BuyItNowContent>
</BuyItNowResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=buy_it_now&domain=domain&currency=usd&price_to_verify=1234
الاستجابة (تنسيق JSON)
{
  "BuyItNowResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderId": 1
  }
}
 

أمر إضافة عميل محتمل جديد

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

سيؤدي استدعاء أمر إضافة عميل محتمل جديد إلى استيراد العملاء المحتملين الخاصين بك إلى نظام Dynadot بعمولة قدرها 5%.

ملاحظة: سيتم إلغاء قفل النطاق لتمكين المشتري من إتمام الشراء فورًا عند القبول.

هذا الأمر متاح فقط بتنسيق XML وJSON. إذا كنت تستدعي هذا الأمر، فيجب تضمين المعاملات التالية:

معامل طلب إضافة عميل محتمل جديد
شرح
domain_nameاسم النطاق الذي تريد إضافة عميل محتمل له, يمكن إدخال نطاق واحد فقط لكل طلب
lead_typeنوع العميل المحتمل الذي تريد تعيين هذا العميل المحتمل له. القيم المقبولة هي "buy_now"، "make_offer"
priceالسعر الذي تريد تعيينه للعميل المحتمل
buyer_nameاسم المشترين
buyer_emailالبريد الإلكتروني للمشترين
وسم XML للنتيجة
شرح
<AddNewLeadResponse></AddNewLeadResponse>العقدة الجذرية للاستجابة
<AddNewLeadHeader></AddNewLeadHeader>عنوان إضافة عميل محتمل جديد
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال إضافة عميل محتمل جديد

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<AddNewLeadResponse>
  <AddNewLeadHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AddNewLeadHeader>
</AddNewLeadResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&[email protected]
الاستجابة (تنسيق JSON)
{
  "AddNewLeadResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر التعيين للبيع

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

يدعم هذا الأمر تعدد الخيوط.

سيؤدي استدعاء الأمر Set For Sale إلى عرض نطاقك للبيع في سوق النطاقات. هذا الأمر متاح فقط بصيغة XML وJSON. إذا استدعيت هذا الأمر، فيجب تضمين المعلمات التالية:

تعيين معامل طلب العرض للبيع
شرح
domainsالنطاق الذي تريد إدراج نطاقك للبيع به في سوق النطاقات, يمكن إدخال نطاق واحد فقط لكل طلب
for_sale_typeيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك:
> السوق:
أدرج نطاقك للبيع في سوق النطاقات. سيتم تعيين إدراجات النطاقات الجديدة إلى الفئة, والفئة الفرعية, والسعر المُدخل أدناه. إذا تم تعيين سعر فعلي, فسيصبح النطاق متاحاً للشراء الفوري وسيُدفع إلى المشتري. مزيد من المعلومات حول عملية بيع النطاق >

> ليس للبيع:
إلغاء الإدراج
listing_type (optional)يمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك عبر السوق: (إلزامي إذا كان for_sale_type هو marketplace)
> buy_now
سيؤدي تحديد سعر ثابت إلى جعل النطاق متاحًا للشراء الفوري ودفعه إلى المشتري.
ملاحظة: بالنسبة للنطاق في فترة السماح للإضافة, إذا كان هناك بيع, فقد لا يعود من الممكن حذفه خلال فترة السماح. مزيد من المعلومات حول الحذف خلال فترة السماح

> make_offer
يمكنك اختيار تعيين سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ عرض.
ملاحظة: بالنسبة للنطاق في فترة السماح للإضافة, إذا كان هناك بيع, فقد لا يعود من الممكن حذفه خلال فترة السماح. مزيد من المعلومات حول الحذف خلال فترة السماح

> buy_now_and_make_offer سيؤدي تعيين سعر ثابت إلى جعل النطاق متاحًا للشراء الفوري ودفعه إلى المشتري.
يمكنك اختيار تعيين سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ عرض.
ملاحظة: بالنسبة للنطاق في فترة السماح للإضافة, إذا كان هناك بيع, فقد لا يعود من الممكن حذفه خلال فترة السماح. مزيد من المعلومات حول الحذف خلال فترة السماح
price (optional)السعر الذي تريد بيع نطاقك به. (إلزامي إذا كان for_sale_type هو marketplace)
minimum_offer (optional)الحد الأدنى للعرض الذي ستقبله لنطاقك. (إلزامي إذا كان for_sale_type هو marketplace)
installment (optional)هل يُسمح بالدفع بالتقسيط. إذا كنت تريد تمكين الدفع بالتقسيط, قم بتعيينه إلى "Yes"
maximum_installments (optional)الحد الأقصى لعدد الأقساط المسموح به يُستخدم فقط عندما تكون قيمة installment هي "true"
يمكنك اختيار قيمة من 2 إلى 12 لتمثيل الحد الأقصى للأشهر للدفع بالتقسيط
category (optional)اختر فئة لنطاقك، يمكنك الرجوع إلى جدول مقارنة الفئات والفئات الفرعية أدناه للتعبئة الاختيارية.
Sub-category (optional)اختر فئة فرعية لنطاقك، يمكنك الرجوع إلى جدول مقارنة الفئات والفئات الفرعية أدناه للاختيار.
ملاحظة: يجب أن تكون قيمة المعامل هي الرقم المقابل للفئة الفرعية.
الفئةفئة فرعية
advertisingmarketing
retail
sales
automotivecars_trucks
enthusiasts
motorsports
businessinvestment
law
money
professions
services
careers_educationNo subCategory
consumer_goods_servicesapparel
electronics
entertainmentgames
pop_culture
fashionNo subCategory
financeNo subCategory
gamblingcasino
sports
healthfitness
medicine
internetblogs
ecommerce
domains
web_design
web_hosting
otherNo subCategory
placesafrica
asia
europe
north_america
south_america
real_estateNo subCategory
scienceNo subCategory
societyculture
news
politics
religion
sportsleisure_activities
professional
technologycomputers
uncategorizedNo subCategory
adultNo subCategory
homeNo subCategory
aiNo subCategory
aerospaceNo subCategory
agencyNo subCategory
agriculture_companyNo subCategory
analyticsNo subCategory
alcoholNo subCategory
babies_kidsNo subCategory
biotechNo subCategory
clean_energyNo subCategory
cleaningNo subCategory
communityNo subCategory
construction_organizationNo subCategory
cryptocurrency_blockchainNo subCategory
dating_relationshipNo subCategory
daycareNo subCategory
dentalNo subCategory
droneNo subCategory
e_commerceNo subCategory
food_drinkNo subCategory
furnitureNo subCategory
gamesNo subCategory
insuranceNo subCategory
interior_designNo subCategory
legal_lawNo subCategory
motivationalNo subCategory
manufacturingNo subCategory
marketingNo subCategory
medicalNo subCategory
metaverseNo subCategory
movies_tvNo subCategory
music_audioNo subCategory
news_mediaNo subCategory
nftNo subCategory
outdoorNo subCategory
paymentNo subCategory
petsNo subCategory
politicsNo subCategory
property_managementNo subCategory
recruitment_staffingNo subCategory
servicesNo subCategory
securityNo subCategory
socialNo subCategory
transportationNo subCategory
travelNo subCategory
video_books_magazinesNo subCategory
virtual_realityNo subCategory
website_designNo subCategory
Description (optional)وصف نطاقك
وسم XML للنتيجة
شرح
<SetForSaleResponse></SetForSaleResponse>العقدة الجذرية للاستجابة
<SetForSaleHeader></SetForSaleHeader>تعيين ترويسة For Sale
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على الإعداد للبيع

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetForSaleResponse>
  <SetForSaleHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetForSaleHeader>
</SetForSaleResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
الاستجابة (تنسيق JSON)
{
  "SetForSaleResponse": {
    "ResponseCode: ": "0",
    "Status": "Success"
  }
}
 

أمر قائمة النطاقات المنقولة للخارج

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر قائمة النطاقات المحوّلة للخارج سيعطيك قائمة النطاقات قيد المعالجة للتحويل للخارج. هذا الأمر متاح فقط بصيغة XML و JSON.إذا قمت باستدعاء هذا الأمر

معامل طلب قائمة النطاقات المنقولة للخارج
شرح
وسم XML للنتيجة
شرح
<TransferOutDomainListResponse></TransferOutDomainListResponse>العقدة الجذرية للاستجابة
<TransferOutDomainListHeader></TransferOutDomainListHeader>رأس قائمة نقل النطاقات الخارجية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<TransferOutDomainListContent></TransferOutDomainListContent>رأس قائمة نقل النطاقات الخارجية
<TransferOutDomainList></TransferOutDomainList>قائمة النطاقات المنقولة للخارج
<Domain></Domain>اسم النطاق
<OrderId></OrderId>معرّف الطلب الخاص بنقل النطاق إلى الخارج
<ItemStatus></ItemStatus>حالة نقل النطاق للخارج

مثال قائمة النطاقات المحوّلة للخارج

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer_domain_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=transfer_domain_list
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<TransferOutDomainListResponse>
  <TransferOutDomainListHeader>
    <ResponseCode>200</ResponseCode>
    <Status>success</Status>
  </TransferOutDomainListHeader>
  <TransferOutDomainListContent>
    <TransferOutDomainList>
      <TransferOutDomain>
        <OrderId>1</OrderId>
        <Domain>domain1.com</Domain>
        <ItemStatus>Pending</ItemStatus>
      </TransferOutDomain>
    </TransferOutDomainList>
  </TransferOutDomainListContent>
</TransferOutDomainListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer_domain_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=transfer_domain_list
الاستجابة (تنسيق JSON)
{
  "TransferOutDomainListResponse": {
    "ResponseCode": 200,
    "Status": "success",
    "TransferOutDomainList": [
      {
        "orderId": 1,
        "domain": "domain1.com",
        "itemStatus": "Pending"
      }
    ]
  }
}
 

تعيين أمر تأكيد إجراء Afternic

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر تعيين إجراء تأكيد Afternic سيضبط النطاق للموافقة أو عدم الموافقة على النقل السريع على Afternic. هذا الأمر متاح فقط بصيغة XML و JSON. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب تعيين إجراء تأكيد Afternic
شرح
domainالنطاق الذي تريد تعيين إجراء تأكيد النقل السريع Afternic له، يمكن إدخال نطاق واحد فقط في كل طلب
actionالإجراء الذي تريد ضبط تأكيد Afternic عليه، يجب أن يكون "confirm_afternic"، أو "delete_from_afternic"
وسم XML للنتيجة
شرح
<SetAfternicConfirmActionResponse></SetAfternicConfirmActionResponse>وسم استجابة Set Afternic Confirm Action, إنها العقدة الجذرية لمستند XML للاستجابة
<SetAfternicConfirmActionHeader></SetAfternicConfirmActionHeader>تعيين ترويسة إجراء تأكيد Afternic
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إجراء تأكيد Afternic

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetAfternicConfirmActionResponse>
  <SetAfternicConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetAfternicConfirmActionHeader>
</SetAfternicConfirmActionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
الاستجابة (تنسيق JSON)
{
  "SetAfternicConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

تعيين أمر إجراء تأكيد Sedo

دعم تعدد الخيوط
لا يدعم بيئة اختبار API

استدعاء أمر تعيين إجراء تأكيد Sedo سيقوم بتعيين النطاق للموافقة أو عدم الموافقة على النقل السريع على Sedo. هذا الأمر متاح فقط بصيغة XML و JSON. إذا تم استدعاء هذا الأمر, يجب تضمين المعاملات التالية:

تعيين معلمة طلب إجراء تأكيد Sedo
شرح
domainالنطاق الذي تريد تعيين إجراء النقل السريع لتأكيد Sedo له، يمكن إدخال نطاق واحد فقط لكل طلب
actionالإجراء الذي تريد تعيين تأكيد sedo إليه, يجب أن يكون "confirm_sedo", أو "delete_from_sedo"
وسم XML للنتيجة
شرح
<SetSedoConfirmActionResponse></SetSedoConfirmActionResponse>وسم استجابة Set Sedo Confirm Action, إنه العقدة الجذرية لمستند XML الخاص بالاستجابة
<SetSedoConfirmActionHeader></SetSedoConfirmActionHeader>تعيين ترويسة إجراء تأكيد Sedo
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"

مثال على تعيين إجراء تأكيد Sedo

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetSedoConfirmActionResponse>
  <SetSedoConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetSedoConfirmActionHeader>
</SetSedoConfirmActionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
الاستجابة (تنسيق JSON)
{
  "SetSedoConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

أمر الحصول على إحصائيات Whois

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء أمر الحصول على إحصائيات Whois إلى الحصول على إحصائيات Whois. هذا الأمر متاح فقط بتنسيق XML وJSON. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:

معامل طلب الحصول على إحصاءات Whois
شرح
domain_nameاسم النطاق الذي تحتاج إلى إعداد DNSSEC له
date_typeيمكنك اختيار حقل من القائمة التالية لتمثيل نوع التاريخ الخاص بك:
last_7_days, last_30_days, current_year, last_year
وسم XML للنتيجة
شرح
<GetWhoisStatsResponse></GetWhoisStatsResponse>العقدة الجذرية للاستجابة
<GetWhoisStatsHeader></GetWhoisStatsHeader>ترويسة الحصول على إحصاءات Whois
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetWhoisStatsContent></GetWhoisStatsContent>محتوى الاستجابة
<WhoisStats></WhoisStats>يحتوي على مجموعات متعددة من بيانات إحصاءات whois
<WhoisStat></WhoisStat>بيانات إحصاء Whois محددة
<Date></Date>الحد الأدنى للفاصل الزمني
<Count></Count>عدد Whois خلال الفترة الزمنية الحالية

مثال على الحصول على إحصاءات Whois

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetWhoisStatsResponse>
  <GetWhoisStatsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetWhoisStatsHeader>
  <GetWhoisStatsContent>
    <WhoisStats>
      <WhoisStat>
        <Date>2023-11-04</Date>
        <Count>200</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-05</Date>
        <Count>300</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-06</Date>
        <Count>100</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-07</Date>
        <Count>200</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-08</Date>
        <Count>300</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-09</Date>
        <Count>100</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-10</Date>
        <Count>200</Count>
      </WhoisStat>
    </WhoisStats>
  </GetWhoisStatsContent>
</GetWhoisStatsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
الاستجابة (تنسيق JSON)
{
  "GetWhoisStatsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "WhoisStats": [
      {
        "Date": "2023-11-04",
        "Count": 200
      },
      {
        "Date": "2023-11-05",
        "Count": 300
      },
      {
        "Date": "2023-11-06",
        "Count": 100
      },
      {
        "Date": "2023-11-07",
        "Count": 200
      },
      {
        "Date": "2023-11-08",
        "Count": 300
      },
      {
        "Date": "2023-11-09",
        "Count": 100
      },
      {
        "Date": "2023-11-10",
        "Count": 200
      }
    ]
  }
}
 

أمر قائمة الطلبات

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر قائمة الطلبات سيجلب قائمة الطلبات. هذا الأمر متاح فقط بصيغة XML و JSON.عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:

معامل طلب قائمة الطلبات
شرح
search_byيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع البحث الخاص بك: date_range, domain, order_id
start_dateتاريخ بدء استعلامك بتنسيق yyyy/MM/dd
end_dateتاريخ انتهاء استعلامك بتنسيق yyyy/MM/dd
payment_methodيمكنك اختيار عدة قيم من القائمة التالية لتمثيل طريقة الدفع الخاصة بك:
لا يوجد رصيد
رصيد الحساب
بطاقة_ائتمان
money_order
Paypal
Moneybooker
تحويل بنكي
علي باي
payflow_credit_card2 (لم يعد مستخدمًا)
wechat_pay
إيكاش
تحويل بنكي
apple_pay
حساب_جاري
بيع
union_pay
حساب باي بال
mercado_pago
Payoneer
لكن يرجى استخدام الفاصلة لفصل القيم المتعددة, على سبيل المثال: account_balance,credit_card
وسم XML للنتيجة
شرح
<OrderListResponse></OrderListResponse>العقدة الجذرية للاستجابة
<OrderListHeader></OrderListHeader>ترويسة قائمة الطلبات
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<OrderListContent></OrderListContent>ترويسة قائمة الطلبات
<OrderList></OrderList>يحتوي على مجموعات متعددة من بيانات سجل الطلبات
<OrderItem></OrderItem>يحتوي على بيانات سجل طلب واحد
<OrderItemDomain></OrderItemDomain>اسم النطاق الذي يتضمن العناصر في هذا الطلب
<OrderId></OrderId>يحتوي على معرّف الطلب
<SubmittedDate></SubmittedDate>يحتوي على تاريخ تقديم الطلب
<Cost></Cost>يتضمن تكلفة الطلب
<Status></Status>يحتوي على حالة الطلب

مثال قائمة الطلبات

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<OrderListResponse>
  <OrderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </OrderListHeader>
  <OrderListContent>
    <OrderList>
      <Order>
        <OrderId>123456</OrderId>
        <SubmittedDate>1791875010219</SubmittedDate>
        <Currency>USD</Currency>
        <PaymentMethod>Account Balance</PaymentMethod>
        <TotalCost>$8.00</TotalCost>
        <TotalPaid>$8.00</TotalPaid>
        <Status>Problem</Status>
        <OrderItem>
          <ItemType>Domain Registration</ItemType>
          <Name>test.com</Name>
          <Duration>1</Duration>
          <Cost>2.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Renewal</ItemType>
          <Name>test1.ac</Name>
          <Duration>1</Duration>
          <Cost>3.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Transfer</ItemType>
          <Name>test2.de</Name>
          <Duration>1</Duration>
          <Cost>4.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Registration</ItemType>
          <Name>test3.gg</Name>
          <Duration>1</Duration>
          <Cost>5.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Renewal</ItemType>
          <Name>test4.uk</Name>
          <Duration>1</Duration>
          <Cost>6.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
        <OrderItem>
          <ItemType>Domain Transfer</ItemType>
          <Name>test5.net</Name>
          <Duration>1</Duration>
          <Cost>7.99</Cost>
          <Status>Completed</Status>
        </OrderItem>
      </Order>
      <Order>
        <OrderId>123457</OrderId>
        <SubmittedDate>1791875010219</SubmittedDate>
        <Currency>EUR</Currency>
        <PaymentMethod>Paypal</PaymentMethod>
        <TotalCost>$100.00</TotalCost>
        <TotalPaid>$100.00</TotalPaid>
        <Status>Submitted</Status>
      </Order>
    </OrderList>
  </OrderListContent>
</OrderListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
الاستجابة (تنسيق JSON)
{
  "OrderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderList": [
      {
        "OrderId": "123456",
        "SubmittedDate": "2026/10/13",
        "Currency": "USD",
        "PaymentMethod": "Account Balance",
        "TotalCost": "$8.00",
        "TotalPaid": "$8.00",
        "Status": "Problem",
        "ItemList": [
          {
            "ItemType": "Domain Registration",
            "Name": "test.com",
            "Duration": 1,
            "Cost": "2.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Renewal",
            "Name": "test1.ac",
            "Duration": 1,
            "Cost": "3.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Transfer",
            "Name": "test2.de",
            "Duration": 1,
            "Cost": "4.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Registration",
            "Name": "test3.gg",
            "Duration": 1,
            "Cost": "5.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Renewal",
            "Name": "test4.uk",
            "Duration": 1,
            "Cost": "6.99",
            "Status": "Completed"
          },
          {
            "ItemType": "Domain Transfer",
            "Name": "test5.net",
            "Duration": 1,
            "Cost": "7.99",
            "Status": "Completed"
          }
        ]
      },
      {
        "OrderId": "123457",
        "SubmittedDate": "2026/10/13",
        "Currency": "EUR",
        "PaymentMethod": "Paypal",
        "TotalCost": "$100.00",
        "TotalPaid": "$100.00",
        "Status": "Submitted",
        "ItemList": []
      }
    ]
  }
}
 

أمر الحصول على حالة الطلب

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء أمر الحصول على حالة الطلب سيجلب حالة الطلب. هذا الأمر متاح فقط بصيغة XML و JSON. إذا قمت باستدعاء هذا الأمر، يجب تضمين المعلمات التالية:

معلمة طلب الحصول على حالة الطلب
شرح
order_idمعرّف الطلب المراد الاستعلام عنه
وسم XML للنتيجة
شرح
<GetOrderStatusResponse></GetOrderStatusResponse>العقدة الجذرية للاستجابة
<GetOrderStatusHeader></GetOrderStatusHeader>الحصول على ترويسة حالة الطلب
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetOrderStatusContent></GetOrderStatusContent>محتوى الاستجابة
<OrderId></OrderId>معرف الطلب
<OrderStatus></OrderStatus>حالة الطلب( Shopping, Submitted, Waitpay, Processing, Completed, Problem, Deleted, Cancelled )
<ItemTypeName></ItemTypeName>نوع العنصر
<ItemName></ItemName>اسم العنصر
<ItemStatus></ItemStatus>حالة العنصر(مكتمل, ملغي, مشكلة)

مثال Get Order Status

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetOrderStatusResponse>
  <GetOrderStatusHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetOrderStatusHeader>
  <GetOrderStatusContent>
    <OrderId>0</OrderId>
    <OrderStatus>Completed</OrderStatus>
    <Item>
      <ItemTypeName>domain transfer away</ItemTypeName>
      <ItemName>&amp;</ItemName>
      <ItemStatus>transfer.com</ItemStatus>
    </Item>
    <Item>
      <ItemTypeName>domain</ItemTypeName>
      <ItemName>&amp;</ItemName>
      <ItemStatus>register.com</ItemStatus>
    </Item>
  </GetOrderStatusContent>
</GetOrderStatusResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
الاستجابة (تنسيق JSON)
{
  "GetOrderStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderStatus": {
      "OrderId": 0,
      "OrderStatus": "Completed",
      "ItemList": [
        {
          "ItemTypeName": "domain transfer away",
          "ItemName": "transfer.com",
          "ItemStatus": "Completed"
        },
        {
          "ItemTypeName": "domain",
          "ItemName": "register.com",
          "ItemStatus": "Completed"
        }
      ]
    }
  }
}
 

أمر قيد المعالجة

دعم تعدد الخيوط
دعم بيئة اختبار API

استدعاء الأمر is_processing سيخبرك ما إذا كان من الآمن إرسال طلب جديد

Is-Processing معلمة الطلب
شرح
لا حاجة إلى معلمة إضافية
وسم XML للنتيجة
شرح
<Response></Response>وسم استجابة is_processing
<ResponseHeader></ResponseHeader>علامة ترويسة is_processing
<ResponseMsg></ResponseMsg>Tag of is_processing response message. It should be "yes"(There is a process in the system. You shouldn't sent another request.) or "no"(There is no any process for you account. It is safe to submit a new request.)

مثال على قيد المعالجة

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=is_processing
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=is_processing
الاستجابة (تنسيق XML)
<Response>
  <ResponseHeader>
    <ResponseCode>0</ResponseCode>
    <ResponseMsg>yes</ResponseMsg>
  </ResponseHeader>
</Response>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=is_processing
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=is_processing
الاستجابة (تنسيق JSON)
{
   "Response":{
      "ResponseCode":"0",
      "ResponseMsg":"no"
   }
}
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=is_processing
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=is_processing
الاستجابة (تنسيق CSV)
ok,yes
 

أمر سرد القسائم

دعم تعدد الخيوط
دعم بيئة اختبار API

سيؤدي استدعاء أمر قائمة الكوبونات إلى الحصول على جميع الكوبونات. هذا الأمر متاح فقط بصيغة XML و JSON. عند استدعاء هذا الأمر, يجب تضمين المعلمات التالية:

معلمة طلب قائمة الكوبونات
شرح
coupon_typeيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع البحث لديك: "registration" , "renewal" , أو "transfer"
وسم XML للنتيجة
شرح
<ListCouponsResponse></ListCouponsResponse>العقدة الجذرية للاستجابة
<ListCouponsHeader></ListCouponsHeader>ترويسة قائمة الكوبونات
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ListCouponsContent></ListCouponsContent>محتوى قائمة الكوبونات
<Coupons></Coupons>يحتوي على مجموعات متعددة من بيانات القسائم
<Coupon></Coupon>يحتوي على بيانات قسيمة واحدة
<Code></Code>رمز الكوبون
<Description></Description>وصف القسيمة
<CouponType></CouponType>نوع الكوبون
<DiscountType></DiscountType>نوع الخصم الذي تقدمه القسيمة
<DiscountInfo></DiscountInfo>معلومات الخصم الخاصة بالكوبون
<Percentage></Percentage>نسبة الخصم
<AUD></AUD>مبلغ الخصم بالدولار الأسترالي
<MXN></MXN>مبلغ الخصم بالبيزو المكسيكي
<EUR></EUR>مبلغ الخصم باليورو
<GBP></GBP>مبلغ الخصم بالجنيه الإسترليني
<IDR></IDR>مبلغ الخصم بالروبية الإندونيسية
<USD></USD>مبلغ الخصم بالدولار الأمريكي
<CAD></CAD>مبلغ الخصم بالدولار الكندي
<INR></INR>مبلغ الخصم بالروبية الهندية
<BRL></BRL>مبلغ الخصم بالريال البرازيلي
<CNY></CNY>مبلغ الخصم باليوان الصيني
<Restriction></Restriction>قيود الكوبون
<PriceLevels></PriceLevels>مجموعة من مستويات الأسعار التي تدعم استخدام الكوبونات
<UsesPerAccount></UsesPerAccount>عدد المرات التي يمكن فيها استخدام القسيمة لكل حساب
<UsesSystemWide></UsesSystemWide>عدد المرات التي يمكن استخدام القسيمة فيها على مستوى النظام
<UsesPerIp></UsesPerIp>عدد المرات التي يمكن فيها استخدام القسيمة لكل عنوان IP
<ItemsPerAccount></ItemsPerAccount>عدد العناصر التي يمكن استخدام الكوبون من أجلها لكل حساب
<ItemsSystemWide></ItemsSystemWide>عدد العناصر التي يمكن استخدام الكوبون لها على مستوى النظام
<ItemsPerOrder></ItemsPerOrder>عدد العناصر التي يمكن استخدام القسيمة من أجلها لكل طلب
<ItemsPerDay></ItemsPerDay>عدد العناصر التي يمكن استخدام القسيمة لها يومياً
<IdnRestriction></IdnRestriction>قيود IDN للكوبون
<DomainDurationMin></DomainDurationMin>الحد الأدنى لمدة النطاق
<DomainDurationMax></DomainDurationMax>الحد الأقصى لمدة النطاق
<Tlds></Tlds>مجموعة من نطاقات المستوى الأعلى التي تدعم استخدام الكوبونات
<Tld></Tld>نطاق من المستوى الأعلى واحد يدعم استخدام القسائم
<Currencies></Currencies>مجموعة من أنواع العملات التي تدعم استخدام القسائم
<Currency></Currency>نوع عملة واحد يدعم استخدام الكوبونات
<StartDate></StartDate>تاريخ بدء صلاحية القسيمة
<EndDate></EndDate>تاريخ انتهاء صلاحية القسيمة

مثال على قائمة الكوبونات

طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=list_coupons&coupon_type=renewal
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=list_coupons&coupon_type=renewal
الاستجابة (تنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<ListCouponsResponse>
  <ListCouponsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </ListCouponsHeader>
  <ListCouponsContent>
    <Coupons>
      <Coupon>
        <Code>DOMAINRENEW1</Code>
        <Description>Domain Renew Coupon</Description>
        <CouponType>Hosting/SSL Coupons</CouponType>
        <DiscountType>PERCENTAGE_OFF</DiscountType>
        <DiscountInfo>
          <Percentage>10%</Percentage>
        </DiscountInfo>
        <Restriction>
          <PriceLevels>Any</PriceLevels>
          <IdnRestriction>None</IdnRestriction>
          <DomainDurationMin>1</DomainDurationMin>
          <DomainDurationMax>1</DomainDurationMax>
          <Tlds>
            <Tld>.com</Tld>
            <Tld>.net</Tld>
            <Tld>.org</Tld>
          </Tlds>
          <Currencies>
            <Currency>US Dollar USD ($)</Currency>
          </Currencies>
        </Restriction>
        <StartDate>1476811260000</StartDate>
        <EndDate>1483257540000</EndDate>
      </Coupon>
    </Coupons>
  </ListCouponsContent>
</ListCouponsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=list_coupons&coupon_type=renewal
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=list_coupons&coupon_type=renewal
الاستجابة (تنسيق JSON)
{
  "ListCouponsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Coupons": [
      {
        "Code": "DOMAINRENEW1",
        "Description": "Domain Renew Coupon",
        "CouponType": "Hosting/SSL Coupons",
        "DiscountType": "PERCENTAGE_OFF",
        "DiscountInfo": {
          "Percentage": "10%"
        },
        "Restriction": {
          "PriceLevels": "Any",
          "IdnRestriction": "None",
          "DomainDurationMin": "1",
          "DomainDurationMax": "1",
          "Tlds": [
            ".com",
            ".net",
            ".org"
          ],
          "Currencies": [
            "US Dollar USD ($)"
          ]
        },
        "StartDate": "1476811260000",
        "EndDate": "1483257540000"
      }
    ]
  }
}