النطاقات

قائمة أوامر واجهة برمجة تطبيقات النطاق

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

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

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

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

يجب إرسال الطلبات عبر https (المقبس الآمن) للأمان. يمكن معالجة طلب واحد فقط في كل مرة، لذا يرجى الانتظار حتى ينتهي طلبك الحالي قبل إرسال طلب آخر. يجب أن يحتوي الطلب على المعلمتين التاليتين، 'Key' و 'Command'. يمكن النقر على الأوامر لرؤية المعاملات المرتبطة بها.


 
طلب المعلمة
الشرح
Keyمفتاحك للوصول إلى واجهة برمجة التطبيقات، متاح في لوحة تحكم حساب داينادوت الخاص بك تحت قائمة الأدوات الجانبية 'الأدوات' -> 'واجهة برمجة التطبيقات'.
Commandsearch, register, delete, renew, push, lock, transfer, bulk_register

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

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, cancel_transfer, get_transfer_status, set_transfer_auth_code, authorize_transfer_away, get_transfer_auth_code

get_ns, add_ns, register_ns, set_ns_ip, delete_ns, delete_ns_by_domain, server_list, get_dns

set_reseller_hold_status, get_reseller_hold_status, get_listings, get_listing_item, buy_it_now

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

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

is_processing

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_order_status

get_domain_push_request, set_domain_push_request, set_afternic_confirm_actionset_sedo_confirm_action, set_domain_dnssec, get_whois_stats, order_list,

سيقدم لك واجهة برمجة تطبيقات النطاق المتقدمة النتائج بتنسيق XML. يجب أن تحتوي الاستجابة التي تتلقاها على اثنين أو ثلاثة من الحقول التالية:

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

أمر البحث

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

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

بحث مثال

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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</Price>
    </SearchHeader>
  </SearchResponse>
</Results>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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"
         }
      ]
   }
}
 

أمر التسجيل

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

طلب تسجيل المعلمة
الشرح
domainاسم النطاق الذي ترغب في تسجيله، يمكن تسجيل نطاق 1 واحد فقط لكل طلب
language (اختياري)علامة اللغة للنطاق المطلوب، مطلوبة فقط إذا كان النطاق هو نطاق ذو أسماء دولية.
durationكم من الوقت يستغرق تسجيل النطاق؟
registrant_contact (اختياري)المسجل الذي تريد استخدامه للاتصال في النطاق
admin_contact (اختياري)الجهة الإدارية التي ترغب في استخدامها على النطاق
technical_contact (اختياري)الاتصال الفني الذي ترغب في استخدامه على النطاق
billing_contact (اختياري)جهة الاتصال الخاصة بالفوترة التي ترغب في استخدامها على النطاق
option0 (إذا لزم الأمر)
اسم المسجل .AT, .BE,
option1 (إذا لزم الأمر)منظمة المسجل .AT, .BE, (اختياري)
لـ .AT، يمكنك تحديد option0, option1, أو كلاهما
premium (اختياري)إذا كنت ترغب في تسجيل نطاق مميز، قم بتعيينه على "1" (اختياري)
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
نتيجة علامة 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=mykey&command=register&domain=domain1.net&duration=3&currency=USD

الاستجابة (بتنسيق XML)
<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=register&domain=domain1.net&duration=3&currency=USD

استجابة (بتنسيق JSON)
{
   "RegisterResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.net",
      "Expiration":"1458379145266"
   }
}
 

أمر الحذف

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

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

مثال حذف

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=delete&domain=domain1.com

الاستجابة (بتنسيق XML)
<DeleteResponse>
  <DeleteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteHeader>
</DeleteResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=delete&domain=domain1.com

استجابة (بتنسيق JSON)
{
   "DeleteResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.com",
   }
}
 

تجديد الأمر

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

طلب تجديد البارامتر
الشرح
domainاسم النطاق الذي تريد تجديده، يمكن تجديد نطاق 1 واحد فقط لكل طلب
durationكم عدد السنوات لتجديد النطاق ل؟
year (اختياري)السنة الحالية التي ينتهي فيها تسجيل النطاق
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
price_check (اختياري)يمكنك إضافة هذه الباراميتر إلى الأمر لفحص تفاصيل السعر لتجديد هذا النطاق. ملاحظة: عند إضافة هذه الباراميتر إلى الأمر، لن يقوم واجهة برمجة التطبيقات الخاصة بنا بتجديد النطاق، ولكن ستعرض فقط معلومات السعر.
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
no_renew_if_late_renew_fee_needed (اختياري)يمكنك إضافة هذا المعامل إلى الأمر لتجنب التجديد إذا كان النطاق يتطلب رسوم تجديد متأخرة. إذا كان النطاق يتطلب رسوم تجديد متأخرة للتجديد، وتم تمرير "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=mykey&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=mykey&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon

استجابة (بتنسيق JSON)
{
   "RenewResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domian1.com",
      "Expiration":"73984579834"
   }
}
 

أمر الدفع

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

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

مثال الدفع

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=push&domain=domian1.com&receiver_push_username=username&currency=USD

استجابة (بتنسيق JSON)
{
   "PushResponse":{
      "ResponseCode":"0",
      "Status":"order created"
   }
}
 

أمر النقل

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

طلب نقل المعاملة
الشرح
domainاسم النطاق الذي ترغب في نقله إلى Dynadot، يمكن نقل نطاق 1 واحد فقط لكل طلب
authرمز التفويض لطلب النقل.
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
registrant_contact (اختياري)جهة الاتصال المسجلة التي ترغب في استخدامها عند اكتمال النقل. (لا تدعم جميع نطاقات المستوى الأعلى هذه الميزة)
admin_contact (اختياري)جهة الاتصال الإدارية التي ترغب في استخدامها عند اكتمال النقل. (لا تدعم جميع أسماء النطاقات العليا هذه الميزة)
technical_contact (اختياري)الجهة الفنية التي ترغب باستخدامها عند اكتمال النقل. (لا تدعم جميع أسماء النطاقات العليا هذه الميزة)
billing_contact (اختياري)جهة الاتصال الخاصة بالفوترة التي ترغب في استخدامها عند اكتمال عملية النقل. (لا تدعم جميع نطاقات tld هذه الميزة)
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
نتيجة علامة XML
الشرح
<TransferResponse></TransferResponse>علامة استجابة النقل، إنها العقدة الجذرية لوثيقة الاستجابة XML
<TransferHeader></TransferHeader>نقل العنوان
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"

مثال على التحويل

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon

الاستجابة (بتنسيق XML)
<TransferResponse>
  <TransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
  </TransferHeader>
</TransferResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon

استجابة (بتنسيق JSON)
{
   "TransferResponse":{
      "ResponseCode":"0",
      "Status":"order created",
      "DomainName":"domian1.com"
   }
}
 

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

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

طلب تسجيل بالجملة
الشرح
domain0-domain99الأسماء النطاقية التي ترغب في تسجيلها، يمكن تسجيل 100 نطاقات كحد أقصى لكل طلب
premium (اختياري)إذا كنت ترغب في تسجيل نطاق مميز، قم بتعيينه على "1" (اختياري)
currency (اختياري)يمكنك تحديد نوع العملة والمعايير المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وغيرها. إذا لم تحدد هذه المعايير، سنستخدم العملة الافتراضية للحساب.
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
نتيجة علامة 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=mykey&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=mykey&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"
      }
    ]
  }
}
 

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

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

طلب معلومات النطاق
الشرح
domainفقط 1 نطاق مسموح به لكل طلب
نتيجة علامة XML
الشرح
<DomainInfoResponse></DomainInfoResponse>العقدة الجذرية لمستند الاستجابة XML
<DomainInfoResponseHeader></DomainInfoResponseHeader>رأس الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<DomainInfoContent></DomainInfoContent>محتوى الاستجابة
<Domain></Domain>نطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء النطاق بتوقيت Unix (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت يونيكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1، 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم اسم النطاق
<Type></Type>نوع خادم اسم النطاق
<WithAds></WithAds>إذا كنت تريد صفحة انتظار لنطاقك
<Whois></Whois>معلومات الاستعلام عن المالك
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرف الاتصال
<Admin></Admin>معلومات الإدارة
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>تمكين الحالة
<UdrpLocked></UdrpLocked>مقفل بموجب الإجراء الموحد لتسوية نزاعات النطاقات أم لا
<UdrpLocked></UdrpLocked>مقفل بموجب الإجراء الموحد لتسوية نزاعات النطاقات أم لا
<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=mykey&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>
    </Domain>
  </DomainInfoContent>
</DomainInfoResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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)"
      }
    }
  }
}
 

تعيين أمر الويز

إذا تم استدعاء أمر 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"

مثال على إعداد الويز

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

استجابة (بتنسيق JSON)
{
   "SetWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

الاستجابة (بتنسيق XML)
<SetNsResponse>
  <SetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsHeader>
</SetNsResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

استجابة (بتنسيق JSON)
{
   "SetNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال على إعداد موقف السيارات

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_parking&domain=domain1.com&with_ads=no

استجابة (بتنسيق JSON)
{
   "SetParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين معامل طلب التوجيه
الشرح
domainالنطاق الذي ترغب في تعيينه، يمكن تعيين 100 نطاقات لكل طلب، تأكد من أنها مفصولة بفواصل.
forward_urlالرابط الذي تريد توجيه نطاقك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه النطاق الخاص بك التي تريدها، القيمة الافتراضية هي "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=mykey&command=set_forwarding&forward_url=http%3A%2F%2Fwww.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=mykey&command=set_forwarding&forward_url=http%3A%2F%2Fwww.mydomain.com&domain=domain1.com,domain2.com

استجابة (بتنسيق JSON)
{
   "SetForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com

الاستجابة (بتنسيق XML)
<SetStealthResponse>
  <SetStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetStealthHeader>
</SetStealthResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com

استجابة (بتنسيق JSON)
{
   "SetStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين معلمة طلب الاستضافة
الشرح
domainالنطاق الذي ترغب في تعيينه، يمكن تعيين 100 نطاقات لكل طلب، تأكد من أنها مفصولة بفواصل.
hosting_typeنوع الاستضافة التي ترغب بها، يمكنك اختياره في "advanced" و "basic"
mobile_view_onفقط عندما يكون نوع الاستضافة "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=mykey&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=mykey&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes

استجابة (بتنسيق JSON)
{
   "SetHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين DNS2

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

يرجى العلم أن استخدام أمر تعيين DNS2 سيتجاوز إعدادات DNS الحالية.

تعيين معامل طلب DNS2
الشرح
domainالنطاق الذي ترغب في تعيينه، يمكن تعيين 100 نطاقات لكل طلب، تأكد من أنها مفصولة بفواصل.
main_record_type0 - main_record_type19 (optional)النوع الرئيسي للسجل يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email".
main_record0 - main_record19حدد سجل نظام أسماء النطاقات لنطاقك
main_recordx0 - main_recordx19مسافة خادم البريد، نوع التوجيه (301 كـ "1"، 302 كـ "2")، عنوان التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون main_record_type هو "forward"،"mx"،"stealth"،"email".
subdomain0 - subdomain99 (اختياري)Subdomain records (اختياري)
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 هو إعادة، mx، سرية، بريد.
ttl (اختياري)وقت العيش
add_dns_to_current_setting (اختياري)إذا كنت ترغب في إضافة إعدادات 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=mykey&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=mykey&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"
  }
}
 

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

إذا كنت تقوم بتعيين أمر تحويل البريد الإلكتروني، يجب أن يشتمل على البارامترات التالية:

تعيين معامل طلب توجيه البريد الإلكتروني
الشرح
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=mykey&command=set_email_forward&domain=domain1.com&forward_type=forward&username0=peter&[email protected]

الاستجابة (بتنسيق XML)
<SetEmailForwardingResponse>
  <SetEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetEmailForwardingHeader>
</SetEmailForwardingResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_email_forward&domain=domain1.com&forward_type=forward&username0=peter&[email protected]

استجابة (بتنسيق JSON)
{
   "SetEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

تعيين أمر إعدادات النطاق الواضحة

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

تعيين معلمة طلب إعداد النطاق بوضوح
الشرح
domainالنطاق الذي ترغب في تعيينه، يمكن تعيين 100 نطاقات لكل طلب، تأكد من أنها مفصولة بفواصل.
serviceالخدمة التي ترغب في مسحها، يمكن أن تكون التوجيه، التخفي، إعادة توجيه البريد الإلكتروني، نظام أسماء النطاقات، وخوادم الأسماء.
نتيجة علامة XML
الشرح
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearDomainSettingHeader></SetClearDomainSettingHeaderr>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"

تعيين مثال واضح لإعدادات النطاق

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_clear_domain_setting&domain=domain1.com&service=nameservers

استجابة (بتنسيق JSON)
{
   "SetClearDomainSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_folder&domain=domian1.com&folder=folder1

استجابة (بتنسيق JSON)
{
   "SetFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

خيار التجديد

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

خيار تجديد طلب المعلمة
الشرح
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=mykey&command=set_renew_option&domain=domain1.com&renew_option=auto

الاستجابة (بتنسيق XML)
<SetRenewOptionResponse>
  <SetRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetRenewOptionHeader>
</SetRenewOptionResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_renew_option&domain=domain1.com&renew_option=auto

استجابة (بتنسيق JSON)
{
   "SetRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال على ملاحظة الإعداد

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_note&domain=domain1.com&note=Do not modify any information

استجابة (بتنسيق JSON)
{
   "SetNoteResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين معرف العميل (للموزعين فقط)

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

تعيين معامل طلب معرف العميل
الشرح
domainالنطاق الذي ترغب في تعيينه, يتم فصل النطاقات المتعددة بفواصل (الحد الأقصى:100)
customer_idلا يمكن أن يكون معرف العميل الذي تريد تعيينه للنطاق فارغًا
نتيجة علامة XML
الشرح
<SetCustomerIdResponse></SetCustomerIdResponse>العقدة الجذرية لمستند الاستجابة XML
<SetCustomerIdHeader></SetCustomerIdHeader>رأس الاستجابة
<SetCustomerIdContent></SetCustomerIdContent>محتوى الاستجابة
<SetCustomerIdSuccess></SetCustomerIdSuccess>تعيين محتوى استجابة نجاح معرف العميل
<SetCustomerIdFailed></SetCustomerIdFailed>محتوى رد فشل تعيين معرف العميل
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل، "1" للمشكلة
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456

الاستجابة (بتنسيق XML)
<SetCustomerIdResponse>
    <SetCustomerIdHeader>
        <ResponseCode>0</ResponseCode>
        <Status>success</Status>
    </SetCustomerIdHeader>
    <SetCustomerIdContent>
        <SetCustomerIdSuccess>
            <content>
                <Domain>domain1.com</Domain>
                <CustomerId>123456</CustomerId>
            </content>
            <content>
                <Domain>domain2.com</Domain>
                <CustomerId>123456</CustomerId>
            </content>
        </SetCustomerIdSuccess>
    </SetCustomerIdContent>
</SetCustomerIdResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456

استجابة (بتنسيق JSON)
{
    "SetCustomerIdResponse": {
        "ResponseCode": 0,
        "Status": "success",
        "SetCustomerIdSuccess": [
            {
                "Domain": "domain1.com",
                "CustomerId": 123456
            },
            {
                "Domain": "domain2.com",
                "CustomerId": 123456
            }
        ]
    }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_privacy&domain=domain1.com&option=off

الاستجابة (بتنسيق XML)
<SetPrivacyResponse>
  <SetPrivacyHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetPrivacyHeader>
</SetPrivacyResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_privacy&domain=domain1.com&option=off

استجابة (بتنسيق JSON)
{
   "SetPrivacyResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أسعار نطاقات TLD

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

طلب معلمات أسعار نطاقات المستوى الأعلى
الشرح
currency (اختياري)عملة نتيجة الإرجاع، يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي العملة الافتراضية لإعدادات حساب Api.
نتيجة علامة XML
الشرح
<TldPriceResponse></TldPriceResponse>العقدة الجذرية لمستند الاستجابة XML
<TldPriceResponseHeader></TldPriceResponseHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<TldPriceContent></TldPriceContent>محتوى الاستجابة
<TldContent></TldContent>معلومات نطاق المستوى الأعلى
<Tld></Tld>النطاقات العليا
<Usage></Usage>استخدام نطاق المستوى الأعلى
<Price></Price>معلومات السعر لهذا النطاق العلوي المستوى. يحتوي على علامات فرعية: : وحدة السعر : سعر التسجيل : سعر التجديد : سعر النقل
<Privacy></Privacy>إذا كان هذا النطاق العلوي يدعم خصوصية الويز
<GracePeriod></GracePeriod>معلومات فترة السماح لهذا النطاق العلوي. يحتوي على العلامات الفرعية: : وحدة معلومات فترة السماح : فترة سماح التجديد : فترة سماح الحذف
<IDN></IDN>إذا كان نطاق tld يدعم أسماء النطاقات الدولية
<Restrictions></Restrictions>اسم النطاق

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=0&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>Usage</Usage>
      <Price>
        <Unit>(Price/1 year)</Unit>
        <Register>99.00</Register>
        <Renew>60.00</Renew>
        <Transfer>92.00</Transfer>
      </Price>
      <Privacy>Yes</Privacy>
      <GracePeriod>
        <Unit>(Grace Period/days)</Unit>
        <Renew>40</Renew>
        <Delete>5</Delete>
      </GracePeriod>
      <IDN>Yes</IDN>
      <Restrictions>--</Restrictions>
    </TldContent>
  </TldPriceContent>
</TldPriceResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=0&command=tld_price&currency=USD

استجابة (بتنسيق JSON)
{
  "TldPriceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "PriceLevel": "Regular Pricing",
    "Currency": "USD",
    "TldPrice": [
      {
        "Tld": ".com",
        "Usage": "Usage",
        "Price": {
          "Unit": "(Price/1 year)",
          "Register": "99.00",
          "Renew": "60.00",
          "Transfer": "92.00"
        },
        "Privacy": "Yes",
        "GracePeriod": {
          "Unit": "(Grace Period/days)",
          "Renew": "40",
          "Delete": "5"
        },
        "IDN": "Yes",
        "Restrictions": "--"
      }
    ]
  }
}
 

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

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

قائمة معاملات طلب النطاق
الشرح
customer_id (اختياري)تصفية البيانات حسب معرف العميل (يمكن لموزعين فقط استخدام هذه البارامتر)
نتيجة علامة 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 (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت يونيكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1، 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع إعداد خادم الأسماء
<WithAds></WithAds>مع الإعلانات أم لا
<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=mykey&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>
        </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>
        </Domain>
      </DomainInfo>
    </DomainInfoList>
  </ListDomainInfoContent>
</ListDomainInfoResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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)"
        }
      },
      {
        "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)"
        }
      }
    ]
  }
}
 

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

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

إنشاء معلمة طلب الاتصال
الشرح
organization (اختياري)معلومات المنظمة
nameالاسم
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز البلد الخاص بالهاتف
faxnum (اختياري)رقم الفاكس
faxcc (اختياري)رمز الدولة للفاكس
address1العنوان 1
address2 (اختياري)العنوان 2
cityمدينة
state (اختياري)ولاية
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=mykey&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=mykey&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"
      }
   }
}
 

تعديل أمر الاتصال

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

تحرير معلمة طلب الاتصال
الشرح
contact_idالمعرف الخاص بجهة الاتصال التي ترغب في تعديلها
organization (اختياري)معلومات المنظمة
nameالاسم
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز البلد الخاص بالهاتف
faxnum (اختياري)رقم الفاكس
faxcc (اختياري)رمز الدولة للفاكس
address1العنوان 1
address2 (اختياري)العنوان 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=mykey&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>
طلب (تنسيق CSV)

https://api.dynadot.com/api3.html?key=mykey&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,
,
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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"
    }
  }
}
 

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

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

تعيين طلب معامل إعداد الاتصال الأوروبي
الشرح
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=mykey&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=mykey&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT

استجابة (بتنسيق JSON)
{
  "SetContactEUSettingResponse": {
    "ResponseCode: ": "0",
    "Status": "Success",
    "SetContactEUSettingContent": {
      "ContactId: ": "0"
    }
  }
}
 

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

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

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

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

طلب (تنسيق CSV)

https://api.dynadot.com/api3.csv?key=mykey&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number

الاستجابة (تنسيق CSV)
ok,success,0
طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&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"
    }
  }
}
 

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

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

طلب حذف بيانات الاتصال
الشرح
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=mykey&command=delete_contact&contact_id=0

الاستجابة (بتنسيق XML)
<DeleteContactResponse>
  <DeleteContactHeader>
    <SuccessCode>-1</SuccessCode>
    <Status>error</Status>
    <Error>cannot delete these contacts (Jack Slater). Because they are in use.</Error>
  </DeleteContactHeader>
</DeleteContactResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=delete_contact&contact_id=0

استجابة (بتنسيق JSON)
{
   "DeleteContactResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

قائمة الاتصالات

هذا الأمر متاح فقط بصيغة 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=mykey&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 Slater</Name>
        <Email>[email protected]</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>1 Free Way</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 protected]</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=mykey&command=contact_list

استجابة (بتنسيق JSON)
{
  "ContactListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ContactList": [
      {
        "ContactId": "0",
        "Organization": "",
        "Name": "Jack Slater",
        "Email": "[email protected]",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "1 Free Way",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "no"
      },
      {
        "ContactId": "1",
        "Organization": "",
        "Name": "John tester",
        "Email": "[email protected]",
        "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"
      }
    ]
  }
}
 

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

هذا الأمر متاح فقط بصيغة 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=mykey&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 protected]</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=mykey&command=get_contact&contact_id=10000

استجابة (بتنسيق JSON)
{
  "GetContactResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetContact": {
      "ContactId": "12345",
      "Organization": "org",
      "Name": "name",
      "Email": "[email protected]",
      "PhoneCc": "1",
      "PhoneNum": "555.555.5233",
      "FaxCc": "",
      "FaxNum": "",
      "Address1": "address1",
      "Address2": "address2",
      "City": "city",
      "State": "state",
      "ZipCode": "zipcode",
      "Country": "country",
      "GtldVerified": "no"
    }
  }
}
 

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

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

الحصول على معلمات طلب خادم الأسماء
الشرح
domainالنطاق الذي تريد الحصول على معلومات خادم الأسماء الخاصة به، يمكن سحب معلومات خادم الأسماء لنطاق 1 فقط في كل طلب.
نتيجة علامة 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.html?key=mykey&command=get_ns&domain=mydomain.com

الاستجابة (بتنسيق XML)
<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=mykey&command=get_ns&domain=mydomain.com

استجابة (بتنسيق JSON)
{
   "GetNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "NsContent":{
         "Host":"ns1.mydomain.com",
         "Host":"ns2.mydomain.com"
      }
   }
}
 

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

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

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

أضف مثال خادم الاسم

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=add_ns&host=ns1.mydomain.com

الاستجابة (بتنسيق XML)
<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=mykey&command=add_ns&host=ns1.mydomain.com

استجابة (بتنسيق JSON)
{
   "AddNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "AddNsContent":{
         "Server":{
            "Host":"ns1.mydomain.com",
            "ServerId":"0"
         }
      }
   }
}
 

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

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

طلب تسجيل معاملات خادم الأسماء
الشرح
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=mykey&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=mykey&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 لخادم الأسماء

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_ns_ip&server_id=1&ip0=192.168.1.1

استجابة (بتنسيق JSON)
{
   "SetNsIpResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

حذف مثال خادم الاسم

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=delete_ns&server_id=0

الاستجابة (بتنسيق XML)
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=delete_ns&server_id=0

استجابة (بتنسيق JSON)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

إذا كنت تقوم بحذف اسم الخادم عبر أمر النطاق، فينبغي تضمين البارامترات التالية:

حذف خادم الأسماء بناءً على طلب النطاق
الشرح
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=mykey&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=mykey&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com

استجابة (بتنسيق JSON)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

هذا الأمر متاح فقط بصيغة 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>عنوان آي بي للخادم

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&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"
          }
        ]
      }
    ]
  }
}
 

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

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

احصل على إعدادات خادم أسماء النطاق لطلب البارامتر
الشرح
domainالنطاق الذي ترغب في الحصول على إعدادات خادم الأسماء الخاصة به، يمكن سحب إعدادات خادم الأسماء لنطاق 1 واحد فقط في كل طلب.
نتيجة علامة 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=mykey&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=mykey&command=get_dns&domain=mydomain.com

استجابة (بتنسيق JSON)
{
  "GetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetDns": {
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      }
    }
  }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1

الاستجابة (بتنسيق XML)
<GetTransferAuthCodeResponse>
   <GetTransferAuthCodeHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
      <AuthCode>testauthcode</AuthCode>
   </GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1

استجابة (بتنسيق JSON)
{
   "GetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "AuthCode":"testauthcode"
   }
}
 

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

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

طلب معلمة حالة النقل
الشرح
domainاسم النطاق الذي تريد الحصول على حالة نقله، يمكن إدخال نطاق 1 واحد فقط لكل طلب
transfer_typeنوع التحويل الذي ترغب في الحصول على حالة التحويل له (نقل داخلي أو نقل خارجي)
نتيجة علامة XML
الشرح
<GetTransferStatusResponse></GetTransferStatusResponse>جذر العقدة لمستند 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"، يعني أن رمز المصادقة غير صحيح، يمكنك استخدام واجهة برمجة تطبيقات أخرى SET_TRANSFER_AUTH لإعادة تقديم رمز المصادقة. هناك أيضا بعض الحالات الأخرى، سنرسل لك بريدًا إلكترونيًا أو قد يحتاج الأمر للتحقق من قبل مهندسينا.

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&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"
      }
    ]
  }
}
 

تعيين رمز المصادقة لأمر نقل النطاق

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

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

مثال على تعيين رمز المصادقة للنقل

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode

استجابة (بتنسيق JSON)
{
   "SetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال على إلغاء التحويل

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=cancel_transfer&domain=domain4.com

الاستجابة (بتنسيق XML)
<CancelTransferResponse>
   <CancelTransferHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </CancelTransferHeader>
</CancelTransferResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=cancel_transfer&domain=domain4.com

استجابة (بتنسيق JSON)
{
   "CancelTransferResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تفويض نقل الخروج (للموزعين فقط)

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

مثال على تفويض نقل النطاق

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=authorize_transfer_away&domain=domian.com&authorize=approve&order_id=123

الاستجابة (بتنسيق XML)
<AuthorizeTransferAwayResponse>
   <AuthorizeTransferAwayHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
      <Result>away_approved</Result>
   </AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=authorize_transfer_away&domain=domian.com&authorize=approve&order_id=123

استجابة (بتنسيق JSON)
{
   "AuthorizeTransferAwayResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "Result":"away_approved"
   }
}
 

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

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

إنشاء معامل طلب تدقيق CN
الشرح
contact_idالمعرف الخاص بسجل جهة الاتصال الذي ترغب في بدء التدقيق له، يمكن إدخال معرف جهة اتصال 1 فقط لكل طلب
contact_typeنوع الاتصال، يمكن أن يكون إما فرد أو مؤسسة
individual_id_typeنوع هوية الشخص الطبيعي، القيم المتوقعة (وصف القيمة) هي: JGZ (Officer's identity card of the People's Republic of China) SFZ (ID card of the People's Republic of China) HZ (Passport) GAJMTX (Exit-Entry Permit for Travelling to and from Hong Kong and Macao) TWJMTX (Travel passes for Taiwan Residents to Enter or Leave the Mainland) WJLSFZ (Foreign Permanent Resident ID Card of the People's Republic of China) GAJZZ (Residence permit for Hong Kong, Macao) TWJZZ (Residence permit for Taiwan residents) QT (Others)
individual_license_idرقم الترخيص الخاص ببطاقة التعريف الشخصية للفرد
individual_urlوثيقة هوية ترخيص الشخص الطبيعي. عنوان الملف على الخادم. يُسمح فقط بصيغ jpg، gif، png، jpeg.
enterprise_id_type (Mandatory when contact type is "Enterprise")نوع معرف المؤسسة، القيم المتوقعة (وصف القيمة) هي: ORG (Organization Code Certificate) YYZZ (Business License) TYDM (Certificate for Uniform Social Credit Code) BDDM (Military Code Designation) JDDWFW (Military Paid External Service License) SYDWFR (Public Institution Legal Person Certificate) WGCZJG (Resident Representative Offices of Foreign Enterprises Registration Form) SHTTFR (Social Organization Legal Person Registration Certificate) ZJCS (Religion Activity Site Registration Certificate) MBFQY (Private Non-Enterprise Entity Registration Certificate) JJHFR (Fund Legal Person Registration Certificate) LSZY (Practicing License of Law Firm) WGZHWH (Registration Certificate of Foreign Cultural Center in China) WLCZJG (Resident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate) SFJD (Judicial Expertise License) JWJG (Overseas Organization Certificate) SHFWJG (Social Service Agency Registration Certificate) MBXXBX (Private School Permit) YLJGZY (Medical Institution Practicing License) GZJGZY (Notary Organization Practicing License) BJWSXX (Beijing School for Children of Foreign Embassy Staff in China Permit) QTTYDM (Others-Certificate for Uniform Social Credit Code) QT (Others)
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=mykey&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)
<CreateCnAuditResponse>
  <CreateCnAuditHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateCnAuditHeader>
 </CreateCnAuditResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=create_cn_audit&contact_id=testcontactid&license_id=testlicenseid&url=url

استجابة (بتنسيق JSON)
{
   "CreateCnAuditResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

الحصول على أمر حالة تدقيق شركة الاتصالات

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

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

احصل على مثال حالة التدقيق لـ Cn

طلب (بتنسيق XML)

https://api.dynadot.xml/api3.xml?key=mykey&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.json/api3.xml?key=mykey&command=get_cn_audit_status&contact_id=testcontactid

استجابة (بتنسيق JSON)
{
  "GetCnAuditStatusResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "CnAuditStatus": "pass"
  }
}
 

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

هذا الأمر متاح فقط بتنسيق XML و JSON:

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=get_account_balance

استجابة (بتنسيق JSON)
{
  "GetAccountBalanceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BalanceList": [
      {
        "Currency": "USD",
        "Amount": "300.00"
      }
    ]
  }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=lock_domain&domain=domain4.com

الاستجابة (بتنسيق XML)
<LockDomainResponse>
   <LockDomainferHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </LockDomainHeader>
</LockDomainResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=lock_domain&domain=domain4.com

استجابة (بتنسيق JSON)
{
   "LockDomainResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

الحصول على معايير طلب القوائم
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
exclude_pending_sale (اختياري)إذا كنت لا تريد الحصول على قوائم الإقفال المعلقة للبيع، فيجب أن يكون "yes", الافتراضي هو "no"
show_other_registrar (اختياري)إذا كنت ترغب في الحصول على قوائم مسجلين آخرين، ينبغي أن يكون "yes", الافتراضي هو "no"
نتيجة علامة XML
الشرح
<GetListingsResponse></GetListingsResponse>جذر العقدة لمستند 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=mykey&currency=usd&command=get_listings

الاستجابة (بتنسيق 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>
    </Listing>
    <Listing>
      <ListingId>id2</ListingId>
      <Domain>domain_name2</Domain>
      <Price>2</Price>
      <InboundLinks>2</InboundLinks>
      <Age>2</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
    </Listing>
  </GetListingsContent>
</GetListingsResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&currency=usd&command=get_listings

استجابة (بتنسيق JSON)
{
  "GetListingsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Listing": [
      {
        "ListingId": "id1",
        "Domain": "domain_name1",
        "Price": "1",
        "InboundLinks": "1",
        "Age": "1",
        "PendingSaleLocked": "No"
      },
      {
        "ListingId": "id2",
        "Domain": "domain_name2",
        "Price": "2",
        "InboundLinks": "2",
        "Age": "2",
        "PendingSaleLocked": "No"
      }
    ]
  }
}
 

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

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

الحصول على بارامتر طلب عنصر القائمة
الشرح
domainاسم النطاق الذي ترغب في الحصول على تفاصيله، يمكن إدخال نطاق 1 فقط لكل طلب
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XML
الشرح
<GetListingItemResponse></GetListingItemResponse>جذر العقدة لمستند 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)

http://api.dynadot.com/api3.xml?key=my_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>
    </Listing>
  </GetListingsItemContent>
</GetListingsItemResponse>
طلب (بتنسيق JSON)

http://api.dynadot.com/api3.json?key=my_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"
    }
  }
}
 

أمر الشراء الفوري

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

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

اشترِه الآن كمثال

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=buy_it_now&domain=domain&currency=currency

الاستجابة (بتنسيق XML)
<BuyItNowResponse>
   <BuyItNowHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </BuyItNowHeader>
   <Message>domain order created</Message>
</BuyItNowResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=buy_it_now&domain=domain&currency=currency

استجابة (بتنسيق JSON)
{
   "BuyItNowResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "Message":"domain order created"
   }
}
 

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

هذا الأمر متاح فقط بصيغة 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>Please provide the text you would like to have translated to Arabic.
<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>المعلومات الافتراضية لنظام الويس
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرّف الاتصال
<DefaultAdmin></DefaultAdmin>المسؤول الافتراضي
<DefaultTechnical></DefaultTechnical>الافتراضية التقنية
<DefaultBilling></DefaultBilling>الفوترة الافتراضية
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع الإعلانات أم لا

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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>
      <Contact>
        <Organization/>
        <Name>testname test</Name>
        <Email>[email protected]</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=mykey&command=account_info

استجابة (بتنسيق JSON)
{
  "AccountInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AccountInfo": {
      "Username": "testname",
      "ForumName": "test forum name",
      "Contact": {
        "Organization": "",
        "Name": "testname test",
        "Email": "[email protected]",
        "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"
        }
      }
    }
  }
}
 

تعيين الواجهة الافتراضية لمعلومات النطاق

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

استجابة (بتنسيق JSON)
{
   "SetDefaultWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين معامل طلب خوادم الأسماء الافتراضية
الشرح
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>معرف الخادم

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com

الاستجابة (بتنسيق XML)
<SetDefaultNsResponse>
   <SetDefaultNsHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultNsHeader>
   <SetDefaultNsContent>
      <Servers>
         <Server>
            <ServerName>ns1.hosts.com</ServerName>
            <ServerId>0</ServerId>
         </Server>
         <Server>
            <ServerName>ns2.host.com</ServerName>
            <ServerId>1</ServerId>
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
         <Server>
            <ServerName />
            <ServerId />
         </Server>
      </Servers>
   </SetDefaultNsContent>
</SetDefaultNsResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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.host.com",
               "ServerId":"1"
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            }
         ]
      }
   }
}
 

تعيين أمر انتظار افتراضي

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_default_parking&folder_id=0&with_ads=no

استجابة (بتنسيق JSON)
{
   "SetDefaultParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين إعدادات طلب التوجيه الافتراضي
الشرح
forward_urlالرابط الذي تريد توجيه نطاقك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه النطاق الخاص بك التي تريدها، القيمة الافتراضية هي "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=mykey&command=set_default_forwarding&forward_url=http%3A%2F%2Fmydomain.com

الاستجابة (بتنسيق XML)
<SetDefaultForwardingResponse>
  <SetDefaultForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultForwardingHeader>
</SetDefaultForwardingResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_forwarding&forward_url=http%3A%2F%2Fmydomain.com

استجابة (بتنسيق JSON)
{
   "SetDefaultForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com

الاستجابة (بتنسيق XML)
<SetDefaultStealthResponse>
  <SetDefaultStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultStealthHeader>
</SetDefaultStealthResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com

استجابة (بتنسيق JSON)
{
   "SetDefaultStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين معامل طلب الاستضافة الافتراضي
الشرح
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=mykey&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=mykey&command=set_default_hosting&hosting_type=advanced

استجابة (بتنسيق JSON)
{
   "SetDefaultHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&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 الافتراضي

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

استجابة (بتنسيق JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين إعدادات طلب توجيه البريد الإلكتروني الافتراضي
الشرح
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=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&[email protected]

الاستجابة (بتنسيق XML)
<SetDefaultEmailForwardingResponse>
  <SetDefaultEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&[email protected]

استجابة (بتنسيق JSON)
{
   "SetDefaultEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

تعيين أمر الإعداد الافتراضي الواضح

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_clear_default_setting&service=nameservers

استجابة (بتنسيق JSON)
{
   "SetClearDefaultSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين معامل طلب خيار التجديد الافتراضي
الشرح
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=mykey&command=set_default_renew_option&renew_option=auto

الاستجابة (بتنسيق XML)
<SetDefaultRenewOptionResponse>
  <SetDefaultRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_renew_option&renew_option=auto

استجابة (بتنسيق JSON)
{
   "SetDefaultRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

إنشاء معلمة طلب مجلد
الشرح
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=mykey&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=mykey&command=create_folder&folder_name=new

استجابة (بتنسيق JSON)
{
   "FolderCreateResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "FolderCreateContent":{
         "FolderName":"new",
         "FolderId":"1"
      }
   }
}
 

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

إذا تم استدعاء أمر 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=mykey&command=delete_folder&folder_id=0,1

الاستجابة (بتنسيق XML)
<DeleteFolderResponse>
  <DeleteFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteFolderHeader>
</DeleteFolderResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=delete_folder&folder_id=0,1

استجابة (بتنسيق JSON)
{
   "DeleteFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&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"
   }
}
 

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

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

تعيين معلمة طلب خوادم اسم المجلد
الشرح
fold_idالمعرف الخاص بالمجلد الذي تريد تعيينه، يمكن تعيين مجلد 1 واحد فقط لكل طلب
ns0 - ns12لتعيين خوادم الأسماء الخاصة بنطاقك للاستخدام، يمكنك تحديد ما يصل إلى 13 من خوادم الأسماء، ولكن يجب أن تكون موجودة بالفعل في حسابك
enable (اختياري)إذا كنت ترغب في تطبيق إعدادات خوادم الأسماء هذه على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه العبارة مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات خادم الأسماء لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "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>معرف الخادم

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes

الاستجابة (بتنسيق XML)

0 success ns1.hosts.com 0 ns2.host.com 1

طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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.host.com",
               "ServerId":"1"
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            }
         ]
      }
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_folder_parking&folder_id=0&with_ads=no

استجابة (بتنسيق JSON)
{
   "SetFolderParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_forwarding&folder_id=0&forward_url=http%3A%2F%2Fmydomain.com&sync=yes

الاستجابة (بتنسيق XML)
<SetFolderForwardingResponse>
  <SetFolderForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderForwardingHeader>
</SetFolderForwardingResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_forwarding&folder_id=0&forward_url=http%3A%2F%2Fmydomain.com&sync=yes

استجابة (بتنسيق JSON)
{
   "SetFolderForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال إعداد مجلد الخفاء

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com&sync=yes

الاستجابة (بتنسيق XML)
<SetFolderStealthResponse>
  <SetFolderStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderStealthHeader>
</SetFolderStealthResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http%3A%2F%2Fwww.obamashop.com&sync=yes

استجابة (بتنسيق JSON)
{
   "SetFolderStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes

استجابة (بتنسيق JSON)
{
   "SetFolderHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

تعيين معلمة طلب DNS للمجلد
الشرح
folder_idمعرف المجلد الذي ترغب في ضبطه
main_record_typeالنوع الرئيسي للسجل
main_recordحدد سجل DNS لنطاقك
main_recordحدد سجل DNS لنطاقك
with_ads (اختياري)حدد سجل TXT لنطاقك. إذا كان نوع السجل الرئيسي الخاص بك هو aaaa وقمت بتحديد main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا، يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2، يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type99 (اختياري)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (اختياري)عنوان بروتوكول الإنترنت أو الجهاز المستهدف
mx_host0 - mx_host2 (اختياري)حدد مضيف البريد الإلكتروني لنطاقك، distance0 هي الأولوية القصوى.
mx_distance0 - mx_distance2 (اختياري)Distance0 هو ذو الأولوية القصوى
ttl (اختياري)وقت العيش
enable (اختياري)إذا كنت ترغب في تطبيق إعداد DNS هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات خادم 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=mykey&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=mykey&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 للمجلد

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

تعيين معامل طلب DNS2 للمجلد
الشرح
folder_idمعرف المجلد الذي ترغب في ضبطه
main_record_type0 - main_record_type19النوع الرئيسي للسجل يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email".
main_record0 - main_record19حدد سجل نظام أسماء النطاقات لنطاقك
main_recordx0 - main_recordx19مسافة Mx، نوع الإعادة، عنوان إعادة السرية أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون main_record_type هو إعادة، mx، سرية، بريد.
subdomain0 - subdomain99 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type99 (اختياري)نوع سجلات النطاق الفرعي يجب أن يكون A، AAAA، CNAME، توجيه، TXT، SRV، MX، خفي، البريد الإلكتروني.
sub_record0 - sub_record99 (اختياري)عنوان بروتوكول الإنترنت أو الجهاز المستهدف
sub_recordx0 - sub_recordx99 (اختياري)مسافة MX، نوع التوجيه، عنوان التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون نوع السجل الفرعي هو توجيه، MX، خفي، بريد إلكتروني.
ttl (اختياري)وقت العيش
enable (اختياري)إذا كنت ترغب في تطبيق إعداد DNS هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات خادم 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=mykey&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=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=mykey&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"
   }
}
 

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

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

تعيين معامل طلب توجيه البريد الإلكتروني للمجلد
الشرح
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 (اختياري)إذا كنت ترغب في تطبيق هذا الإعداد على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه الباراميتر مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة هذا الإعداد لجميع النطاقات الموجودة في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XML
الشرح
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=peter&[email protected]

الاستجابة (بتنسيق XML)
<SetFolderEmailForwardingResponse>
  <SetFolderEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=peter&[email protected]

استجابة (بتنسيق JSON)
{
   "SetFolderEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين طلب إعداد مجلد واضح
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه
serviceالخدمة التي ترغب في مسحها، يمكن أن تكون التوجيه، التخفي، إعادة توجيه البريد الإلكتروني، نظام أسماء النطاقات، وخوادم الأسماء.
نتيجة علامة XML
الشرح
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearFolderSettingHeader></SetClearFolderSettingHeaderr>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"

تعيين مثال إعدادات المجلد الواضح

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_clear_folder_setting&folder_id=0&service=nameservers

استجابة (بتنسيق JSON)
{
   "SetClearFolderSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

تعيين معامل طلب اسم المجلد
الشرح
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=mykey&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=mykey&command=set_folder_name&folder_id=0&folder_name=new

استجابة (بتنسيق JSON)
{
   "SetFolderNameResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=set_folder_renew_option&folder_id=0&renew_option=auto

استجابة (بتنسيق JSON)
{
   "SetFolderRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

هذا الأمر متاح فقط بصيغة 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>المعلومات الافتراضية لنظام الويس
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>الحالة الافتراضية لتفعيل الويز
<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=mykey&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=mykey&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"
        }
      }
    ]
  }
}
 

أضف أمر طلب الشراء المعلق

إذا كان الأمر يتعلق بإضافة طلب شراء مؤجل، فيجب تضمين البارامترات التالية:

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

مثال على طلب إضافة طلب شراء لاحق

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org

استجابة (بتنسيق JSON)
{
   "AddBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر حذف طلب الشراء المؤجل

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

طلب حذف طلب الشراء المعلق
الشرح
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=mykey&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=mykey&command=delete_backorder_request&domain=domaindropp.com

استجابة (بتنسيق JSON)
{
   "DeleteBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

قائمة أوامر طلب الشراء المسبق

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

قائمة طلب الطلبات المسبقة للنطاقات
الشرح
startDateتاريخ بدء المزاد الذي ترغب في طلبه، بتنسيق سنة-شهر-يوم، مثل 2015-05-05
endDateتاريخ انتهاء المزاد الذي ترغب في طلبه، 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)

http://api.dynadot.com/api3.xml?key=1&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>
طلب (تنسيق CSV)

http://api.dynadot.com/api3.html?key=1&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
طلب (بتنسيق JSON)

http://api.dynadot.com/api3.json?key=1&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"
      }
    ]
  }
}
 

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

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

طلب الحصول على معلمات المزادات المفتوحة
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
typeالنوع من المزاد الذي ترغب في رؤيته يجب أن يكون "expired", "user", "backorder", أو "registry_expired",، إذا كنت تريد الحصول على أكثر من نوع مزاد، يمكنك استخدام "," لفصل كل نوع من أنواع المزادات.
نتيجة علامة XML
الشرح
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>علامة استجابة الحصول على المزادات المفتوحة، إنها العقدة الجذرية لوثيقة الاستجابة XML
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>الحصول على عنوان المزادات المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetOpenAuctionsContent></GetOpenAuctionsContent>علامة الحصول على محتوى المزادات المفتوحة، تُستخدم فقط عندما يكون الوضع "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم النطاق المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار النطاق
<Links></Links>روابط الدومين الواردة
<Age></Age>عمر النطاق

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=get_open_auctions&currency=usd&type=expired

الاستجابة (بتنسيق 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&currency=usd&type=expired

الاستجابة

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=mykey&command=get_open_auctions&currency=usd&type=expired

استجابة (بتنسيق 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,
            "estibot_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,
            "estibot_appraisal": "-"
        }
        ...
    ]
}
 

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

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

الحصول على تفاصيل طلب المزاد
الشرح
domainيجب أن يستخدم اسم النطاق للمزاد العلني، والاسم المجالي الدولي، نظام البونيكود، مثل xn--wkccg.com. يمكنك الحصول على أكثر من مزاد واحد، ويجب فصل كل نطاق بواسطة،
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XML
الشرح
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>تسمية استجابة تفاصيل المزاد، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>تفاصيل رأس مزاد الطلبات المعلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>علامة الحصول على محتوى تفاصيل المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionStatusId></AuctionStatusId>حالة معرف المزاد: '0' للجاري، '1' للإلغاء بواسطة المستخدم، '2' للإلغاء بواسطة الإدارة، '3' للإلغاء بسبب التجديد، '4' للمكتمل، '5' للإلغاء بسبب النقل بعيدًا
<AuctionStatus></AuctionStatus>حالة المزاد
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو أعلى عرض
<YourCurrentBid></YourCurrentBid>سعر المزايدة الحالي الخاص بك للمزاد المحدد. إذا لم تقم بوضع مزايدة، سيكون '-1'
<YourProxyBid></YourProxyBid>عرضك الافتراضي للمزاد المحدد. إذا لم تكن قد قدمت عرضًا، سيكون {و}
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم النطاق المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت 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)
<?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)
{
  "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": "",
        "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": []
    }
  ]
}
 

أمر وضع عطاء المزاد

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

طلب معلمات المزايدة في المزاد
الشرح
domainاسم النطاق للمزاد، IDN (اسم النطاق المعرب) يجب أن يستخدم البونيكود، مثل xn--wkccg.com
bid_amountمقدار عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها من خلال معامل العملة أدناه
currency (اختياري)عملة عرضك السعري يجب أن تكون "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=mykey&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&currency=usd

الاستجابة

ok,success

طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&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,
            "estibot_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
            }
            ...        ]
    }
}
 

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

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

طلب الحصول على معلمات المزادات المغلقة
الشرح
startDateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
endDateتاريخ انتهاء المزاد، yyyy-mm-dd، مثل 2015-05-05
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XML
الشرح
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>علامة استجابة الدخول للمزادات المغلقة، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>احصل على عنوان المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>علامة محتوى المزادات المغلقة، تُستخدم فقط عندما يكون الحالة هي "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "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=1&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>
طلب (تنسيق CSV)

https://api.dynadot.com/api3.html?key=1&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
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=1&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"
      }
    ]
  }
}
 

الحصول على أوامر مزادات الطلبات المفتوحة المعلقة(مهجور، يُرجى استخدام أمر get_open_auctions)

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

طلب الحصول على معلمات مزادات الطلب المفتوح المعلقة
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XML
الشرح
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>علامة استجابة مزادات الطلب المسبق المفتوحة، إنها العقدة الجذرية لمستند الاستجابة XML
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>الحصول على رأس مزادات الطلبات المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>علامة محتوى مزادات الطلبات المسبقة المفتوحة، تُستخدم فقط عندما يكون الوضع "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم النطاق المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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&currency=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
.
.
.

 

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

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

الحصول على تفاصيل طلب المزاد
الشرح
domainاسم النطاق لمزاد الطلب المسبق، الاسم الدولي للنطاق (IDN) يجب أن يستخدم البيونيكود، مثل xn--wkccg.com
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XML
الشرح
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>تسمية استجابة تفاصيل المزاد، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>الحصول على تفاصيل مزاد العنوان
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>علامة الحصول على محتوى تفاصيل المزاد، تُستخدم فقط عندما يكون الحالة "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>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار النطاق
<Links></Links>روابط الدومين الواردة
<Age></Age>عمر النطاق
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو أعلى عرض
<YourCurrentBid></YourCurrentBid>سعر المزايدة الحالي الخاص بك للمزاد المحدد. إذا لم تقم بوضع مزايدة، سيكون '-1'
<YourProxyBid></YourProxyBid>عرضك الافتراضي للمزاد المحدد. إذا لم تكن قد قدمت عرضًا، سيكون {و}

الحصول على تفاصيل مزاد الطلبات المسبقة

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&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=mykey&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"
      }
    }
  }
}
 

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

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

طلب معلمة المزايدة في مزاد الطلبات المسبقة
الشرح
domainاسم النطاق للمزاد، IDN (اسم النطاق المعرب) يجب أن يستخدم البونيكود، مثل xn--wkccg.com
bid_amountمقدار عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها من خلال معامل العملة أدناه
currency (اختياري)عملة عرضك السعري يجب أن تكون "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=mykey&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>
طلب (تنسيق CSV)

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

الاستجابة (تنسيق CSV)
ok,success
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=mykey&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd

استجابة (بتنسيق JSON)
{
   "PlaceBakcorderAuctionBidResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر الحصول على مزادات الطلبات المعلقة المغلقة

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

الحصول على معلمة طلب المزادات المغلقة لأوامر الشراء المسبقة
الشرح
startDateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
endDateتاريخ انتهاء المزاد، yyyy-mm-dd، مثل 2015-05-05
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XML
الشرح
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>علامة استجابة الدخول للمزادات المغلقة، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>احصل على عنوان المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>علامة محتوى المزادات المغلقة، تُستخدم فقط عندما يكون الحالة هي "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "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=1&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>
طلب (تنسيق CSV)

https://api.dynadot.com/api3.html?key=1&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
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.json?key=1&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"
      }
    ]
  }
}
 

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

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

طلب الحصول على معلمات عروض المزاد
الشرح
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XML
الشرح
<GetAuctionBidsResponse></GetAuctionBidsResponse>علامة استجابة عروض المزاد، إنها العقدة الجذرية لمستند الاستجابة XML
<GetAuctionBidsHeader></GetAuctionBidsHeader>الحصول على عنوان مزايدات المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAuctionBidsContent></GetAuctionBidsContent>علامة محتوى عروض المزاد، تُستخدم فقط عندما يكون الحالة "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=mykey&command=get_auction_bids&currency=usd

الاستجابة (بتنسيق 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=mykey&command=get_auction_bids&currency=usd

استجابة (بتنسيق 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
        }
        ...
    ]
}
 

هل تعالج الأمر

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

معالجة معامل الطلب
الشرح
لا حاجة لأي معامل إضافي.
نتيجة علامة XML
الشرح
<Response></Response>علامة استجابة جاري المعالجة
<RespnseHeader></RespnseHeader>علامة رأس المعالجة الجارية
<ResponseMsg></ResponseMsg>علامة رسالة استجابة is_processing. يجب أن تكون "yes"(يوجد عملية معالجة في النظام. يجب ألا ترسل طلبًا آخر.) أو "no"(لا توجد أي عملية معالجة لحسابك. يمكنك تقديم طلب جديد بأمان.)

مثال على المعالجة

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=mykey&command=is_processing

الاستجابة (بتنسيق XML)
<Response>
  <ResponseHeader>
    <ResponseCode>0</ResponseCode>
    <ResponseMsg>yes</ResponseMsg>
  </ResponseHeader>
</Response>
طلب (تنسيق CSV)

http://api.dynadot.com/api3.html?key=mykey&command=is_processing

الاستجابة (تنسيق CSV)
ok,yes
طلب (بتنسيق JSON)

http://api.dynadot.com/api3.html?key=mykey&command=is_processing

استجابة (بتنسيق JSON)
{
   "Response":{
      "ResponseCode":"0",
      "ResponseMsg":"no"
   }
}
 

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

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

طلب معلمة النطاقات المنتهية الصلاحية المغلقة
الشرح
currency(optional)العملة الخاصة بنتيجة العائد يجب أن تكون دولار أمريكي أو يورو أو يوان صيني، والعملة الافتراضية هي الدولار الأمريكي.
domain(optional)إضافة هذه البارامتر إذا كنت ترغب في الاستعلام عن نطاق قريب من الإغلاق
نتيجة علامة XML
الشرح
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>علامة استجابة الحصول على نطاقات انتهاء صلاحية قريبة، إنها العقدة الجذرية لمستند الاستجابة XML
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>الحصول على نطاقات الإغلاق المنتهية الصلاحية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>وسم المحتوى، يُستخدم فقط عندما يكون الحال هو النجاح
<CloseoutItem></CloseoutItem>عنصر إغلاق
<DomainName></DomainName>اسم النطاق
<DomainNameUtf></DomainNameUtf>اسم النطاق بتنسيق utf
<CurrentPrice></CurrentPrice>السعر الحالي
<isIdn></isIdn>سواء كان الاسم المجال بنظام الاسم الدولي
<EndTimeStamp></EndTimeStamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)
<RenewalPrice></RenewalPrice>سعر التجديد
<ExpiredRevenue></ExpiredRevenue>إيرادات التصفية
<EstibotAppraisal></EstibotAppraisal>تقييم إستيبوت
<InboundLinks></InboundLinks>روابط الدومين الواردة
<MonthlyVisitors></MonthlyVisitors>زوار النطاق
<Currency></Currency>عملة

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=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¤cy=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"
        }
      }
    ]
  }
}
 

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

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

شراء طلب معاملة نطاق منتهي الصلاحية
الشرح
domainالنطاق الذي ترغب في شرائه، يمكن إدخال نطاق واحد فقط لكل طلب
currency(optional)العملة الخاصة بنتيجة العائد يجب أن تكون دولار أمريكي أو يورو أو يوان صيني، والعملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XML
الشرح
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>تصنيف استجابة شراء نطاق مغلق منتهي الصلاحية، إنه العقدة الجذرية لوثيقة الاستجابة 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¤cy=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¤cy=USD&domain=domain.com

استجابة (بتنسيق JSON)
{
  "BuyExpiredCloseoutDomainResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

تعيين أمر تأكيد Afternic

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

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

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

طلب (بتنسيق 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)
{
  "SetAfternicConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

تعيين أمر تأكيد سيدو

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

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

تعيين مثال تأكيد الإجراء في سيدو

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_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_afternic_confirm_action&domain=domain.com&action=confirm_sedo

استجابة (بتنسيق JSON)
{
  "SetSedoConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

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

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

طلب قائمة الطلبات
الشرح
search_byيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع بحثك: نطاق التاريخ النطاق معرف الطلب
start_dateتاريخ بدء استعلامك بالتنسيق yyyy/MM/dd
end_dateتاريخ انتهاء استعلامك بالصيغة yyyy/MM/dd
payment_methodيمكنك اختيار قيم متعددة من القائمة التالية لتمثيل طريقة الدفع الخاصة بك: لا يوجد رصيد رصيد الحساب بطاقة ائتمان حوالة مالية باي بال موني بوكرز تحويل بنكي علي باي بطاقة ائتمان باي فلو (لا يتم استخدامها بعد الآن) وي تشات باي نقود إلكترونية تحويل بنكي آبل باي حساب جاري بيع يونيون باي حساب باي بال ميركادو باجو بايونير ولكن يرجى استخدام الفاصلة لفصل القيم المتعددة، على سبيل المثال: رصيد الحساب، بطاقة ائتمان
نتيجة علامة 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=0&searchBy=date_range&startDate=2024/01/01&endDate=2024/01/31&paymentMethod=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>1714077058644</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>1714077058644</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=0&command=order_list&searchBy=date_range&startDate=2024/01/01&endDate=2024/01/31&paymentMethod=account_balance,credit_card

استجابة (بتنسيق JSON)
{
  "OrderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderList": [
      {
        "OrderId": "123456",
        "SubmittedDate": "2024/04/25",
        "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": "2024/04/25",
        "Currency": "EUR",
        "PaymentMethod": "Paypal",
        "TotalCost": "$100.00",
        "TotalPaid": "$100.00",
        "Status": "Submitted",
        "ItemList": []
      }
    ]
  }
}
 

تعيين أمر DNSSEC للنطاق

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

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

الخيار 1: اسم النطاق، علامة المفتاح، نوع الهضم، الهضم، الخوارزمية

الخيار 2: domainName ، flags ، publicKey ، Algorithm

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

تعيين معلمة طلب DNSSEC للنطاق
الشرح
domainNameاسم النطاق الذي تحتاج إلى إعداد dnssec له
keyTagعلامة رئيسية
digestTypeيمكنك اختيار رقم من القائمة التالية لتمثيل نوع توقيعك الرقمي: SHA-1(1) SHA-256(2) GOSTR 34.11-94 (3) SHA-384(4)
digestملخص.
Algorithmيمكنك اختيار رقم من القائمة التالية لتمثيل خوارزمية التوقيع الرقمي الخاصة بك: RSA/MD5(1) ديفي-هيلمان (2) DSA/SHA-1(3) المنحنى الإهليلجي (4) RSA/SHA-1(5) DSA-NSEC3-SHA1(6) RSASHA1-NSEC3-SHA1(7) RSA/SHA-256(8) RSA/SHA-512(10) جوست 34.10-2001(12) منحنى ECDSA P-256 مع SHA-256(13) منحنى ECDSA P-384 مع SHA-384(14) ED25519(15) ED448(16) غير مباشر (252) DNS خاص (253) OID خاص (254)
flagsيمكنك اختيار رقم من القائمة التالية ليمثل رمز توقيعك الرقمي: ZSK(256) KSK(257)
publicKeyيجب أن يكون المفتاح العام مشفرًا بترميز base64.
نتيجة علامة XML
الشرح
<SetDomainDnssecResponse></SetDomainDnssecResponse>عقدة الجذر للاستجابة
<SetDomainDnssecHeader></SetDomainDnssecHeader>ضبط عنوان Dnssec للنطاق
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=0&command=set_domain_dnssec&domainName=domain-haha1.com&flags=257&publicKey=123&algorithm=1

الاستجابة (بتنسيق XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDomainDnssecResponse>
  <SetDomainDnssecHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetDomainDnssecHeader>
  <SetDomainDnssecContent/>
</SetDomainDnssecResponse>
طلب (بتنسيق JSON)

https://api.dynadot.com/api3.xml?key=0&command=set_domain_dnssec&domainName=domain-haha1.com&flags=257&publicKey=123&algorithm=1

استجابة (بتنسيق JSON)
{
  "SetDomainDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

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

الحصول على معلمات طلب إحصائيات الويز
الشرح
domainNameاسم النطاق الذي تحتاج إلى إعداد dnssec له
dateTypeيمكنك اختيار رقم من القائمة التالية لتمثيل نوع التاريخ الخاص بك: آخر 7 أيام (1) آخر 30 يومًا (2) العام الماضي (3) العام الحالي (4)
نتيجة علامة XML
الشرح
<GetWhoisStatsResponse></GetWhoisStatsResponse>عقدة الجذر للاستجابة
<GetWhoisStatsHeader></GetWhoisStatsHeader>الحصول على رأس ترويسة إحصائيات الويز
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
<GetWhoisStatsContent></GetWhoisStatsContent>محتوى الرد
<WhoisStats></WhoisStats>يحتوي على مجموعات متعددة من بيانات حالة النطاقات
<WhoisStat></WhoisStat>بيانات حالة النطاق المحددة
<Date></Date>الحد الأدنى للفترة الزمنية
<Count></Count>عدد عمليات الاستعلام ضمن الفترة الزمنية الحالية

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=0&command=get_whois_stats&domainName=domain1.com&dateType=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=0&command=get_whois_stats&domainName=domain1.com&dateType=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
      }
    ]
  }
}
 

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

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

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

الحصول على حالة الطلب كمثال

طلب (بتنسيق 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)
{
  "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"
        }
      ]
    }
  }
}
 

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

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

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

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

طلب (بتنسيق XML)

https://api.dynadot.com/api3.xml?key=0&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.xml?key=0&command=get_domain_push_request

استجابة (بتنسيق JSON)
{
  "GetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "pushDomainName": "[haha.com,haha1.com]"
  }
}
 

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

استدعاء أمر طلب دفع النطاق سيقوم بتعيين طلب دفع النطاق. هذا الأمر متوفر فقط بتنسيق 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=0&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.xml?key=0&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept

استجابة (بتنسيق JSON)
{
  "SetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
هل أنت متأكد أنك تريد إغلاق المحادثة؟سيتم إغلاق المحادثة وسيتم مسح سجل الدردشة.
استمر في تسجيل الخروج،
أو البقاء على الدردشة.
لمراجعة جلسة الدردشة هذه، يرجىانقرهذه النوافذ.
Chat Online
الدردشة عبر الإنترنت0
قم بتنزيل التطبيق:
          
قم بتنزيل التطبيق: