المجالات

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

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

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

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

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

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

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

مستوى السعرالحساب
عاديخيط واحد
جملة5 خيوط
جملة كبرى25 خيط
جملة ممتازة25 خيط


 
طلب المعلمة
الشرح
Keyمفتاحك للوصول إلى واجهة برمجة التطبيقات، متاح في لوحة تحكم حساب داينادوت الخاص بك تحت قائمة الأدوات الجانبية 'الأدوات' -> 'واجهة برمجة التطبيقات'.
Command
Domain:
search, register, delete, renew, push, 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, lock_domain, set_dnssec, get_dnssec, clear_dnssec

cancel_transfer, get_transfer_status, set_transfer_auth_code, authorize_transfer_away, get_transfer_auth_code

get_domain_push_request, set_domain_push_request
contact:
create_cn_audit, get_cn_audit_status, create_contact, edit_contact, delete_contact, contact_list, get_contact

set_contact_eu_setting, set_contact_lv_setting, set_contact_lt_setting
Nameserver:
get_ns, add_ns, register_ns, set_ns_ip, delete_ns, delete_ns_by_domain, server_list, get_dns
Account:
account_info, get_account_balance, set_default_whois, set_default_ns, set_default_parking, set_default_forwarding, set_default_stealth, set_default_hosting, set_default_dns, set_default_dns2, set_default_email_forward, set_clear_default_setting, set_default_renew_option
Folder:
create_folder, delete_folder, set_folder_whois, set_folder_ns, set_folder_parking, set_folder_forwarding, set_folder_stealth, set_folder_hosting, set_folder_dns, set_folder_dns2, set_folder_email_forward, set_clear_folder_setting, set_folder_name, set_folder_renew_option, folder_list
Aftermarket:
add_backorder_request, delete_backorder_request, backorder_request_list

get_open_auctions, get_auction_details, get_auction_bids, place_auction_bid, get_closed_auctions

get_open_backorder_auctions, get_backorder_auction_details, place_backorder_auction_bid, get_closed_backorder_auctions, get_expired_closeout_domains, buy_expired_closeout_domain, get_listings, get_listing_item, buy_it_now
Other:
set_afternic_confirm_action, set_sedo_confirm_action, order_list, set_for_sale, get_order_status, is_processing, list_coupons

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

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

أمر البحث

Support multi-thread

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

طلب بحث المعاملات
الشرح
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>معلومات اللغة عن اسم المجال
Search Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
Response (XML format)
<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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD
Response (JSON format)
{
   "SearchResponse":{
      "ResponseCode":"0",
      "SearchResults":[
         {
            "DomainName":"mydomain.com",
            "Available":"yes",
            "Price":"77.00 in USD"
         },
         {
            "DomainName":"mydomain.net",
            "Available":"yes",
            "Price":"44.00 in USD"
         }
      ]
   }
}
 

أمر التسجيل

Support multi-thread

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

طلب تسجيل المعلمة
الشرح
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"

تسجيل مثال

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=register&domain=domain1.net&duration=3&currency=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=register&domain=domain1.net&duration=3&currency=USD
Response (JSON format)
{
  "RegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainName": "domain1.net",
    "Expiration": 1458379145266
  }
}
 

أمر الحذف

Support multi-thread

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

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

مثال حذف

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=delete&domain=domain1.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResponse>
  <DeleteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteHeader>
</DeleteResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete&domain=domain1.com
Response (JSON format)
{
  "DeleteResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainName": "domain1.com"
  }
}
 

تجديد الأمر

Support multi-thread

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

طلب تجديد البارامتر
الشرح
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"
Renew Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
Response (XML format)
<RenewResponse>
  <RenewHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RenewHeader>
  <RenewContent>
    <Expiration>73984579834</Expiration>
  </RenewContent>
</RenewResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon
Response (JSON format)
{
   "RenewResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.com",
      "Expiration":"73984579834"
   }
}
 

أمر الدفع

Support multi-thread

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

طلب الدفع للمعاملة
الشرح
domainاسم المجال الذي ترغب في دفعه. نحن ندعم أيضاً الدفع الجماعي، يمكنك استخدام ";" لتقسيم المجالات. مثال: domain1.com;domain2.com
receiver_push_usernameاسم المستخدم لحساب المستقبل
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
unlock_domain_for_push(optional)قم بضبط هذه القيمة بما يعادل "1". إذا كان المجال مغلقًا، سنقوم بفتحه تلقائيًا، لذا لا تحتاج إلى فتح المجال يدويًا.
receiver_email(optional)بريد دفع لحساب المستقبل
نتيجة علامة XML
الشرح
<PushResponse></PushResponse>علامة استجابة الدفع، إنها العقدة الجذرية لمستند الاستجابة XML
<PushHeader></PushHeader>رأس الدفع
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Push Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
Response (XML format)
<PushResponse>
  <PushHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
  </PushHeader>
</PushResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username&currency=USD
Response (JSON format)
{
   "PushResponse":{
      "ResponseCode":"0",
      "Status":"order created"
   }
}
 

أمر ال انتقال

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<TransferResponse>
  <TransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
    <DomainName>domain1.com</DomainName>
    <OrderId>1234567</OrderId>
  </TransferHeader>
</TransferResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth&currency=USD&coupon=testcoupon
Response (JSON format)
{
  "TransferResponse": {
    "ResponseCode": 0,
    "Status": "order created",
    "DomainName": "domain1.com",
    "OrderId": "1234567"
  }
}
 

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

Support multi-thread

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

طلب تسجيل بالجملة
الشرح
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"

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD
Response (JSON format)
{
  "BulkRegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BulkRegister": [
      {
        "DomainName": "domain0.com",
        "Expiration": "1234567890",
        "Result": "success",
        "Message": "-"
      },
      {
        "DomainName": "domain1.com",
        "Expiration": "-",
        "Result": "error",
        "Message": "not_available"
      }
    ]
  }
}
 

معلومات المجال

Support multi-thread

هذا الأمر متاح فقط بصيغة 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>اسم المجلد
Domain Information Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=domain_info&domain=domain1.com
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=domain_info&domain=domain1.com
Response (JSON format)
{
  "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)"
      }
    }
  }
}
 

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

Support multi-thread

إذا تم استدعاء أمر 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"
Set Whois Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (XML format)
<SetWhoisResponse>
  <SetWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetWhoisHeader>
</SetWhoisResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format)
{
   "SetWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

تعيين مثال Ns

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetNsResponse>
  <SetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsHeader>
</SetNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Response (JSON format)
{
  "SetNsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب ركن السيارة
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
with_ads (اختياري)إذا كنت لا ترغب في الإعلانات من طرف ثالث، يمكنك استخدام هذه الباراميتر مع "no"
نتيجة علامة XML
الشرح
<SetParkingResponse></SetParkingResponse>علامة تعيين استجابة المواقف، إنها العقدة الجذرية لوثيقة الاستجابة XML
<SetParkingHeader></SetParkingHeader>تعيين عنوان مجلد وقوف السيارات
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Parking Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
Response (XML format)
<SetParkingResponse>
  <SetParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetParkingHeader>
</SetParkingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
Response (JSON format)
{
   "SetParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معامل طلب التوجيه
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
forward_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه المجال الخاص بك التي تريدها، القيمة الافتراضية هي "temporary", إذا كنت ترغب في التوجيه الدائم، استخدم هذا المعامل مع "no"
نتيجة علامة XML
الشرح
<SetForwardingResponse></SetForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetForwardingHeader></SetForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Forwarding Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Response (XML format)
<SetForwardingResponse>
  <SetForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetForwardingHeader>
</SetForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Response (JSON format)
{
   "SetForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معامل طلب الخفاء
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
stealth_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (اختياري)عنوان الصفحة
نتيجة علامة XML
الشرح
<SetStealthResponse></SetStealthResponse>العقدة الجذرية لمستند الاستجابة XML
<SetStealthHeader></SetStealthHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Stealth Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (XML format)
<SetStealthResponse>
  <SetStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetStealthHeader>
</SetStealthResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (JSON format)
{
   "SetStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب الاستضافة
الشرح
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"
Set Hosting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Response (XML format)
<SetHostingResponse>
  <SetHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetHostingHeader>
</SetHostingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Response (JSON format)
{
   "SetHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين DNS2

Support multi-thread

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

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

تعيين معامل طلب DNS2
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
main_record_type0 - main_record_type19 (optional)النوع الرئيسي للسجل يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email".
main_record0 - main_record19حدد سجل نظام أسماء المجالات ل مجالك
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"
Set DNS2 Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
  <SetDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnsHeader>
</SetDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Response (JSON format)
{
  "SetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تعيين Dnssec

Support multi-thread

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

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

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

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

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

تعيين معامل طلب Dnssec
الشرح
domain_nameاسم المجال الذي تحتاج إلى إعداد dnssec له
key_tagعلامة رئيسية
digest_typeيمكنك اختيار رقم من القائمة التالية لتمثيل نوع توقيعك الرقمي: SHA-1(1) SHA-256(2) GOSTR 34.11-94 (3) SHA-384(4)
digestيرجى إدخال القيمة المقابلة لنوع الهضم الذي قمت باختياره
algorithmيمكنك اختيار رقم من القائمة التالية لتمثيل خوارزمية التوقيع الرقمي الخاصة بك: RSA/MD5(1) ديفي-هيلمان(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) GOSTR 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)
public_keyيجب أن يكون المفتاح العام مشفرًا بترميز base64.
نتيجة علامة XML
الشرح
<SetDnssecResponse></SetDnssecResponse>عقدة الجذر للاستجابة
<SetDnssecHeader></SetDnssecHeader>تعيين رأس Dnssec
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"

تعيين مثال لنظام أمان نظام أسماء المجالات

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnssecResponse>
  <SetDnssecHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnssecHeader>
  <SetDnssecContent/>
</SetDnssecResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Response (JSON format)
{
  "SetDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب توجيه البريد الإلكتروني
الشرح
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"
Set Email Forward Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
Response (XML format)
<SetEmailForwardingResponse>
  <SetEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetEmailForwardingHeader>
</SetEmailForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&[email protected]
Response (JSON format)
{
   "SetEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب إعداد المجال بوضوح
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، "dnssec"، و "nameservers".
نتيجة علامة XML
الشرح
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearDomainSettingHeader></SetClearDomainSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Clear Domain Setting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Response (XML format)
<SetClearDomainSettingResponse>
  <SetClearDomainSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDomainSettingHeader>
</SetClearDomainSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Response (JSON format)
{
   "SetClearDomainSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب المجلد
الشرح
domainاسم المجال المطلوب تحديثه، يمكن تعيين مجال 1 واحد فقط لكل طلب
folderاسم المجلد الذي ترغب في انتقال مجالك إليه. استخدم "Default" كاسم للمجلد إذا كنت تريد انتقال المجال إلى المجلد الافتراضي. اسم المجلد حساس لحالة الأحرف. على سبيل المثال، "Folder1" و "folder1" هما اسمان مختلفان للمجلدات.
folder_id (اختياري)المجلد المعرّف الذي ترغب في انتقال مجالك إليه
نتيجة علامة XML
الشرح
<SetFolderResponse></SetFolderResponse>علامة استجابة مجموعة المجلد، وهي العقدة الجذرية لمستند الاستجابة XML
<SetFolderHeader></SetFolderHeader>تعيين عنوان المجلد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Response (XML format)
<SetFolderResponse>
  <SetFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHeader>
</SetFolderResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Response (JSON format)
{
   "SetFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب الملاحظة
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين مجال 1 فقط لكل طلب
noteملاحظة: تريد إعداد المجال، يمكن أن يكون فارغًا
نتيجة علامة XML
الشرح
<SetNoteResponse></SetNoteResponse>العقدة الجذرية لمستند الاستجابة XML
<SetNoteHeader></SetNoteHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Note Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
Response (XML format)
<SetNoteResponse>
  <SetNoteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNoteHeader>
</SetNoteResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_note&domain=domain1.com&note=Do not modify any information
Response (JSON format)
{
   "SetNoteResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معامل طلب معرف العميل
الشرح
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"

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456
Response (JSON format)
{
  "SetCustomerIdResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetCustomerIdSuccess": [
      {
        "Domain": "domain1.com",
        "CustomerId": 123456
      },
      {
        "Domain": "domain2.com",
        "CustomerId": 123456
      }
    ]
  }
}
 

خيار التجديد

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetRenewOptionResponse>
  <SetRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetRenewOptionHeader>
</SetRenewOptionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Response (JSON format)
{
  "SetRenewOptionResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

تعيين معلمة طلب الخصوصية
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
optionحالة الخصوصية لل مجال الذي ترغب في ضبطه، يمكن أن تكون "full", "partial", أو "off"
whois_privacy_optionحالة خصوصية الـ whois للنطاق الذي ترغب في ضبطه، يمكن أن تكون "yes" أو "no"
نتيجة علامة XML
الشرح
<SetPrivacyResponse></SetPrivacyResponse>العقدة الجذرية لمستند الاستجابة XML
<SetPrivacyHeader></SetPrivacyHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Privacy Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Response (XML format)
<SetPrivacyResponse>
  <SetPrivacyHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetPrivacyHeader>
</SetPrivacyResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Response (JSON format)
{
   "SetPrivacyResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

طلب معلمات أسعار مجالات المستوى الأعلى
الشرح
currency (اختياري)عملة نتيجة الإرجاع، يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي العملة الافتراضية لإعدادات حساب Api.
count_per_page (optional)كم عدد الكيانات المعروضة في كل صفحة؟
page_index (optional)أي كيانات الصفحة تريد عرضها?
sort (optional)يرجى اختيار إحدى الخيارات التالية كقيمة لمعامل الترتيب:
* إذا لم تقم باختياره، سنستخدم الترتيب الافتراضي.
1) RankAsc (الافتراضي)
2) RankDesc
3) NameAsc
4) NameDesc
5) SalesAsc
6) SalesDesc
7) LaunchDateAsc
8) LaunchDateDesc
9) CountAsc
10) CountDesc
11) RegistryAsc
12) RegistryDesc
نتيجة علامة 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>اسم المجال
TLD Prices Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=tld_price&currency=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
  <TldPriceResponseHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <PriceLevel>Regular Pricing</PriceLevel>
    <Currency>USD</Currency>
  </TldPriceResponseHeader>
  <TldPriceContent>
    <TldContent>
      <Tld>com</Tld>
      <Usage>General</Usage>
      <Price>
        <Unit>(Price/1 year)</Unit>
        <Register>15.00</Register>
        <Renew>15.00</Renew>
        <Transfer>15.00</Transfer>
        <Restore>10.00</Restore>
      </Price>
      <Privacy>10.00</Privacy>
      <GracePeriod>
        <Unit>10.00</Unit>
        <Renew>10.00</Renew>
        <Delete>30</Delete>
        <Restore>YES</Restore>
      </GracePeriod>
      <IDN>YES</IDN>
      <Restrictions>--</Restrictions>
    </TldContent>
  </TldPriceContent>
</TldPriceResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=tld_price&currency=USD
Response (JSON format)
{
  "TldPriceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "PriceLevel": "Regular Pricing",
    "Currency": "USD",
    "TldPrice": [
      {
        "Tld": "com",
        "Usage": "General",
        "IDN": "YES",
        "Restrictions": "--",
        "Privacy": "10.00",
        "Price": {
          "Unit": "(Price/1 year)",
          "Register": "15.00",
          "Renew": "15.00",
          "Transfer": "15.00",
          "Restore": "10.00"
        },
        "GracePeriod": {
          "Unit": "10.00",
          "Renew": "10.00",
          "Delete": "30",
          "Restore": "YES"
        }
      }
    ]
  }
}
 

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

Support multi-thread

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

قائمة معاملات طلب المجال
الشرح
customer_id (اختياري)تصفية البيانات حسب معرف العميل (يمكن لموزعين فقط استخدام هذه البارامتر)
count_per_page (optional)كم عدد الكيانات المعروضة في كل صفحة؟
page_index (optional)أي كيانات الصفحة تريد عرضها?
sort (optional)يرجى اختيار إحدى الخيارات التالية كقيمة لمعامل الترتيب:
* إذا لم تقم باختياره، سنستخدم الترتيب الافتراضي.
1) CountAsc (الافتراضي)
2) CountDesc
3) NameAsc
4) NameDesc
نتيجة علامة 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>اسم المجلد

قائمة أمثلة المجالات

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=list_domain
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=list_domain
Response (JSON format)
{
  "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)"
        }
      }
    ]
  }
}
 

أمر قفل المجال

Support multi-thread

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

طلب قفل معلمات المجال
الشرح
domainاسم المجال الذي ترغب في قفله، يمكن إدخال مجال 1 واحد فقط لكل طلب
نتيجة علامة XML
الشرح
<LockDomainResponse></LockDomainResponse>جذر العقدة لمستند XML الاستجابة
<LockDomainHeader></LockDomainHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Lock Domain Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=lock_domain&domain=domain4.com
Response (XML format)
<LockDomainResponse>
   <LockDomainHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </LockDomainHeader>
</LockDomainResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=lock_domain&domain=domain4.com
Response (JSON format)
{
   "LockDomainResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=cancel_transfer&domain=domain4.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<CancelTransferResponse>
  <CancelTransferHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CancelTransferHeader>
</CancelTransferResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=cancel_transfer&domain=domain4.com
Response (JSON format)
{
  "CancelTransferResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

طلب معلمة حالة ال انتقال
الشرح
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 لإعادة تقديم رمز المصادقة. هناك أيضا بعض الحالات الأخرى، سنرسل لك بريدًا إلكترونيًا أو قد يحتاج الأمر للتحقق من قبل مهندسينا.
Get Transfer Status Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Response (JSON format)
{
  "GetTransferStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "TransferList": [
      {
        "OrderId": "testorderid",
        "TransferStatus": "teststatus"
      },
      {
        "OrderId": "testorderid2",
        "TransferStatus": "teststatus2"
      }
    ]
  }
}
 

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

Support multi-thread

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

طلب تعيين رمز تفويض ال انتقال
الشرح
domainالاسم المُحدَّث ل انتقال الصلاحية ل مجال، يمكن إدخال مجال 1 واحد فقط لكل طلب
auth_codeالرمز التفويضي الذي ترغب في إعادة تقديمه
order_idيمكنك الحصول على معرف أمر ال انتقال من خلال واجهة برمجة التطبيقات الأخرى لاستعلام حالة ال انتقال.
نتيجة علامة XML
الشرح
<GetTransferStatusResponse></GetTransferStatusResponse>جذر العقدة لمستند XML الاستجابة
<GetTransferStatusHeader></GetTransferStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Transfer Auth Code Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Response (XML format)
<SetTransferAuthCodeResponse>
   <SetTransferAuthCodeHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Response (JSON format)
{
   "SetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

طلب تفويض انتقال بعيدًا
الشرح
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>نتيجة التفويض بال انتقال بعيدًا

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AuthorizeTransferAwayResponse>
  <AuthorizeTransferAwayHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <Result>away_approved</Result>
  </AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Response (JSON format)
{
  "AuthorizeTransferAwayResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Result": "away_approved"
  }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferAuthCodeResponse>
  <GetTransferAuthCodeHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <AuthCode>testauthcode</AuthCode>
  </GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Response (JSON format)
{
  "GetTransferAuthCodeResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AuthCode": "testauthcode"
  }
}
 

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

Support multi-thread

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

احصل على طلب دفع المجال
الشرح
N/Aلا توجد معلمات إضافية مطلوبة
نتيجة علامة XML
الشرح
<GetDomainPushRequestResponse></GetDomainPushRequestResponse>عقدة الجذر للاستجابة
<GetDomainPushRequestHeader></GetDomainPushRequestHeader>احصل على ترويسة طلب دفع المجال
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
<GetDomainPushRequestContent></GetDomainPushRequestContent>محتوى الرد
<PushDomain></PushDomain>دفع المجال
<PushDomainName></PushDomainName>دفع اسم المجال
Get Domain Push Request Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_domain_push_request
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_domain_push_request
Response (JSON format)
{
  "GetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "pushDomainName": "[haha.com,haha1.com]"
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب دفع المجال
الشرح
domainsاسم المجال الخاص بالطلب المراد معالجته
actionيمكنك اختيار "accept" أو "decline" لمعالجة أمر العمل.
نتيجة علامة XML
الشرح
<SetDomainPushRequestResponse></SetDomainPushRequestResponse>عقدة الجذر للاستجابة
<SetDomainPushRequestHeader></SetDomainPushRequestHeader>تعيين عنوان طلب دفع المجال
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Set Domain Push Request Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDomainPushRequestResponse>
  <SetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetDomainPushRequestHeader>
  <SetDomainPushRequestContent/>
</SetDomainPushRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Response (JSON format)
{
  "SetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

الأمر يتيح لك إنشاء تدقيق 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"

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<CreateCnAuditResponse>
  <CreateCnAuditHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateCnAuditHeader>
</CreateCnAuditResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Response (JSON format)
{
  "CreateCnAuditResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

الحصول على معلمة طلب حالة تدقيق المجال الصيني
الشرح
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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
  <GetCnAuditStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <CnAuditStatus>pass</CnAuditStatus>
  </GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
Response (JSON format)
{
  "GetCnAuditStatusResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "CnAuditStatus": "pass"
  }
}
 

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

Support multi-thread

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

إنشاء معلمة طلب الاتصال
الشرح
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"
Create Contact Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Response (XML format)
<CreateContactResponse>
  <CreateContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateContactHeader>
  <CreateContactContent>
    <ContactId>1234</ContactId>
  </CreateContactContent>
</CreateContactResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Response (JSON format)
{
   "CreateContactResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "CreateContactContent":{
         "ContactId":"0"
      }
   }
}
 

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

Support multi-thread

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

تحرير معلمة طلب الاتصال
الشرح
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>معرف الاتصال

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

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

success,
,
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_contact&contact_id=0
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteContactResponse>
  <DeleteContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteContactHeader>
</DeleteContactResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_contact&contact_id=0
Response (JSON format)
{
  "DeleteContactResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

هذا الأمر متاح فقط بصيغة 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
Contact List Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=contact_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
  <ContactListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ContactListHeader>
  <ContactListContent>
    <ContactList>
      <Contact>
        <ContactId>0</ContactId>
        <Organization/>
        <Name>Jack tester</Name>
        <Email>[email protected]</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>test street</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
      <Contact>
        <ContactId>1</ContactId>
        <Organization/>
        <Name>John tester</Name>
        <Email>[email 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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=contact_list
Response (JSON format)
{
  "ContactListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ContactList": [
      {
        "ContactId": "0",
        "Organization": "",
        "Name": "Jack tester",
        "Email": "[email protected]",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "test street",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "no"
      },
      {
        "ContactId": "1",
        "Organization": "",
        "Name": "John tester",
        "Email": "[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"
      }
    ]
  }
}
 

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

Support multi-thread

هذا الأمر متاح فقط بصيغة 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
Get Contact Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_contact&contact_id=10000
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_contact&contact_id=10000
Response (JSON format)
{
  "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"
    }
  }
}
 

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

Support multi-thread

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

تعيين طلب معامل إعداد الاتصال الأوروبي
الشرح
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>معرف الاتصال
Set Contact EU Setting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
  <SetContactEUSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactEUSettingHeader>
  <SetContactEUSettingContent>
    <ContactId>0</ContactId>
  </SetContactEUSettingContent>
</SetContactEUSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Response (JSON format)
{
  "SetContactEUSettingResponse": {
    "ResponseCode: ": "0",
    "Status": "Success",
    "SetContactEUSettingContent": {
      "ContactId: ": "0"
    }
  }
}
 

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

Support multi-thread

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

تعيين طلب معاملة إعداد جهة الاتصال
الشرح
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>معرف الاتصال

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
  <SetContactLvSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactLvSettingHeader>
  <SetContactLvSettingContent>
    <ContactId>0</ContactId>
  </SetContactLvSettingContent>
</SetContactLvSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Response (JSON format)
{
  "SetContactLvSettingResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetContactLvSettingContent": {
      "ContactId: ": "0"
    }
  }
}
Set Contact LV Setting Example
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=set_contact_lv_setting&contact_id=0&registration_number=test_reg_number&vat_number=test_vat_number
Response (تنسيق CSV)
ok,success,0
 

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

Support multi-thread

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

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

الحصول على مثال Ns

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_ns&domain=mydomain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetNsResponse>
  <GetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetNsHeader>
  <NsContent>
    <Host>ns1.mydomain.com</Host>
    <Host>ns2.mydomain.com</Host>
  </NsContent>
</GetNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_ns&domain=mydomain.com
Response (JSON format)
{
  "GetNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "NsContent": {
      "Host0": "ns1.mydomain.com",
      "Host1": "ns2.mydomain.com"
    }
  }
}
 

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

Support multi-thread

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

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

إضافة مثالNs

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=add_ns&host=ns1.mydomain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AddNsResponse>
  <AddNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddNsHeader>
  <AddNsContent>
    <Server>
      <Host>ns1.mydomain.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </AddNsContent>
</AddNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=add_ns&host=ns1.mydomain.com
Response (JSON format)
{
  "AddNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AddNsContent": {
      "Server": {
        "Host": "ns1.mydomain.com",
        "ServerId": 0
      }
    }
  }
}
 

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

Support multi-thread

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

طلب تسجيل معاملات خادم الأسماء
الشرح
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>معرف الخادم
Register Name Server Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Response (XML format)
<RegisterNsResponse>
  <RegisterNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterNsHeader>
  <RegisterNsContent>
    <Server>
      <Host>domain1.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </RegisterNsContent>
</RegisterNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Response (JSON format)
{
   "RegisterNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "RegisterNsContent":{
         "Server":{
            "Host":"ndomain1.com",
            "ServerId":"0"
         }
      }
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب عنوان IP لخادم الأسماء
الشرح
server_idمعرف خادم الأسماء الذي تريد تعيينه
ip0 - ip9عنوان الآي بي الذي ترغب في تعيينه لخادم الأسماء، يمكن تعيين 9 عناوين آي بي لكل طلب ويجب فصلها بفواصل.
نتيجة علامة XML
الشرح
<SetNsIpResponse></SetNsIpResponse>العقدة الجذرية لمستند الاستجابة XML
<SetNsIpHeader></SetNsIpHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Name Server IP Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Response (XML format)
<SetNsIpResponse>
  <SetNsIpHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsIpHeader>
</SetNsIpResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Response (JSON format)
{
   "SetNsIpResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

مثال حذف الأسماء

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns&server_id=0
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns&server_id=0
Response (JSON format)
{
  "DeleteNsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

حذف خادم الأسماء بناءً على طلب المجال
الشرح
server_domainاسم خادم الأسماء. مثال: ns1.testnameserver.com
نتيجة علامة XML
الشرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteNsHeader></DeleteNsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Delete Name Server By Domain Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Response (XML format)
<DeleteNsResponse>
  <DeleteNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteNsHeader>
</DeleteNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Response (JSON format)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

هذا الأمر متاح فقط بصيغة 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>عنوان آي بي للخادم
Server List Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=server_list
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=server_list
Response (JSON format)
{
  "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"
          }
        ]
      }
    ]
  }
}
 

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

Support multi-thread

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

احصل على إعدادات خادم أسماء المجال لطلب البارامتر
الشرح
domain المجال الذي ترغب في الحصول على إعدادات خادم الأسماء الخاصة به، يمكن سحب إعدادات خادم الأسماء ل مجال 1 واحد فقط في كل طلب.
نتيجة علامة XML
الشرح
<GetDnsResponse></GetDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<GetDnsHeader></GetDnsHeader>رأس الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetDnsContent></GetDnsContent>محتوى الاستجابة
<NameServerSettings></NameServerSettings>إعدادات خادم اسم المجال
<Type></Type>نوع خادم اسم المجال
Get Domain Nameserver Settings Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_dns&domain=mydomain.com
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_dns&domain=mydomain.com
Response (JSON format)
{
  "GetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetDns": {
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      }
    }
  }
}
 

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

Support multi-thread

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

طلب بيانات حساب
الشرح
N/Aلا توجد معلمات إضافية مطلوبة
نتيجة علامة XML
الشرح
<AccountInfoResponse></AccountInfoResponse>العقدة الجذرية لمستند الاستجابة XML
<AccountInfoHeader></AccountInfoHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<AccountInfoContent></AccountInfoContent>محتوى الاستجابة
<AccountInfo></AccountInfo>معلومات الحساب
<Username></Username>اسم المستخدم
<ForumName></ForumName>اسم المنتدى
<Contact></Contact>معلومات الاتصال
<Organization></Organization>منظمة
<Organization></Organization>رأس الاستجابة
<Name></Name>اسمك
<Email></Email>البريد الإلكتروني
<PhoneCc></PhoneCc>رمز البلد الخاص بالهاتف
<PhoneNum></PhoneNum>رقم الهاتف
<Address1></Address1>العنوان 1
<Address2></Address2>العنوان 2
<City></City>مدينة
<State></State>ولاية
<ZipCode></ZipCode>الرمز البريدي
<Country></Country>بلد
<CustomerSince></CustomerSince>عميل منذ
<AccountLock></AccountLock>قفل الحساب
<TotalSpending></TotalSpending>الإنفاق الكلي
<PriceLevel></PriceLevel>مستوى السعر
<AccountBalance></AccountBalance>رصيد الحساب
<CustomTimeZone></CustomTimeZone>المنطقة الزمنية المخصصة
<DefaultSettings></DefaultSettings>الإعدادات الافتراضية
<DefaultWhois></DefaultWhois>المعلومات الافتراضية لنظام الويس
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرّف الاتصال
<DefaultAdmin></DefaultAdmin>المسؤول الافتراضي
<DefaultTechnical></DefaultTechnical>الافتراضية التقنية
<DefaultBilling></DefaultBilling>الفوترة الافتراضية
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع الإعلانات أم لا
Account Information Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=account_info
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
  <AccountInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AccountInfoHeader>
  <AccountInfoContent>
    <AccountInfo>
      <Username>testname</Username>
      <ForumName>test forum name</ForumName>
      <AvatarUrl>test avatar url</AvatarUrl>
      <Contact>
        <Organization/>
        <Name>testname test</Name>
        <Email>[email 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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=account_info
Response (JSON format)
{
  "AccountInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AccountInfo": {
      "Username": "testname",
      "ForumName": "test forum name",
      "AvatarUrl": "test avatar url",
      "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"
        }
      }
    }
  }
}
 

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

Support multi-thread

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

طلب الحصول على معلمات رصيد الحساب
الشرح
N/Aلا توجد معلمات إضافية مطلوبة
نتيجة علامة XML
الشرح
<GetAccountBalanceResponse></GetAccountBalanceResponse>جذر العقدة لمستند XML الاستجابة
<GetAccountBalanceHeader></GetAccountBalanceHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAccountBalanceContent></GetAccountBalanceContent>محتوى الاستجابة
<Balance></Balance>رصيد الحساب
Get Account Balance Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_account_balance
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_account_balance
Response (JSON format)
{
  "GetAccountBalanceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BalanceList": [
      {
        "Currency": "USD",
        "Amount": "300.00"
      }
    ]
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب الويس الافتراضي
الشرح
registrant_contactمعلومات المسجل الخاصة ب المجال
admin_contactمعلومات مسؤول المجال
technical_contactمعلومات فنية حول المجال
billing_contactمعلومات الفوترة الخاصة ب المجال
نتيجة علامة XML
الشرح
<SetDefaultWhoisResponse></SetDefaultWhoisResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultWhoisHeader></SetDefaultWhoisHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Whois Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (XML format)
<SetDefaultWhoisResponse>
   <SetDefaultWhoisHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultWhoisHeader>
</SetDefaultWhoisResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format)
{
   "SetDefaultWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultNsResponse>
  <SetDefaultNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultNsHeader>
  <SetDefaultNsContent>
    <Servers>
      <Server>
        <ServerName>ns1.hosts.com</ServerName>
        <ServerId>0</ServerId>
      </Server>
      <Server>
        <ServerName>ns2.hosts.com</ServerName>
        <ServerId>1</ServerId>
      </Server>
    </Servers>
  </SetDefaultNsContent>
</SetDefaultNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Response (JSON format)
{
  "SetDefaultNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetDefaultNsContent": {
      "Servers": [
        {
          "ServerName": "ns1.hosts.com",
          "ServerId": "0"
        },
        {
          "ServerName": "ns2.hosts.com",
          "ServerId": "1"
        }
      ]
    }
  }
}
 

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

Support multi-thread

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

تعيين إعدادات طلب ركن المجال الافتراضية
الشرح
with_ads (اختياري)إذا كنت لا ترغب في إعلانات من طرف ثالث، يمكنك استخدام هذه الباراميتر حيث أن القيمة الافتراضية هي "yes"
نتيجة علامة XML
الشرح
<SetDefaultParkingResponse></SetDefaultParkingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultParkingHeader></SetDefaultParkingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Parking Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
Response (XML format)
<SetDefaultParkingResponse>
   <SetDefaultParkingHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultParkingHeader>
</SetDefaultParkingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
Response (JSON format)
{
   "SetDefaultParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين إعدادات طلب التوجيه الافتراضي
الشرح
forward_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه المجال الخاص بك التي تريدها، القيمة الافتراضية هي "temporary", إذا كنت ترغب في التوجيه الدائم، استخدم هذا المعامل مع "no"
نتيجة علامة XML
الشرح
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Forwarding Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Response (XML format)
<SetDefaultForwardingResponse>
  <SetDefaultForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultForwardingHeader>
</SetDefaultForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Response (JSON format)
{
   "SetDefaultForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب الإخفاء الافتراضية
الشرح
stealth_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (اختياري)عنوان الصفحة
نتيجة علامة XML
الشرح
<SetDefaultStealthResponse></SetDefaultStealthResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultStealthHeader></SetDefaultStealthHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Stealth Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (XML format)
<SetDefaultStealthResponse>
  <SetDefaultStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultStealthHeader>
</SetDefaultStealthResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (JSON format)
{
   "SetDefaultStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معامل طلب الاستضافة الافتراضي
الشرح
hosting_typeنوع الاستضافة الافتراضية التي تريدها، يمكنك الاختيار في "advanced" و "basic"
نتيجة علامة XML
الشرح
<SetDefaultHostingResponse></SetDefaultHostingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultHostingHeader></SetDefaultHostingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Hosting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_hosting&hosting_type=advanced
Response (XML format)
<SetDefaultHostingResponse>
  <SetDefaultHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultHostingHeader>
</SetDefaultHostingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_hosting&hosting_type=advanced
Response (JSON format)
{
   "SetDefaultHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

إذا كنت تقوم بتعيين أمر 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"
Set Default DNS Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

إذا كنت تقوم بتعيين أمر 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"
Set Default DNS2 Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (XML format)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (JSON format)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين إعدادات طلب توجيه البريد الإلكتروني الافتراضي
الشرح
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"
Set Default Email Forward Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
Response (XML format)
<SetDefaultEmailForwardingResponse>
  <SetDefaultEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&[email protected]
Response (JSON format)
{
   "SetDefaultEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين طلب معامل الإعداد الافتراضي الواضح
الشرح
serviceالخدمة التي ترغب في مسحها، يمكن أن تكون التوجيه، التخفي، إعادة توجيه البريد الإلكتروني، نظام أسماء المجالات، وخوادم الأسماء.
نتيجة علامة XML
الشرح
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Clear Default Setting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_default_setting&service=nameservers
Response (XML format)
<SetClearDefaultSettingResponse>
  <SetClearDefaultSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_default_setting&service=nameservers
Response (JSON format)
{
   "SetClearDefaultSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_renew_option&renew_option=auto
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultRenewOptionResponse>
  <SetDefaultRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_renew_option&renew_option=auto
Response (JSON format)
{
  "SetDefaultRenewOptionResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

إنشاء معلمة طلب مجلد
الشرح
folder_nameاسم المجلد الذي تريد إنشاءه
نتيجة علامة XML
الشرح
<FolderCreateResponse></FolderCreateResponse>العقدة الجذرية لمستند الاستجابة XML
<FolderCreateHeader></FolderCreateHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<FolderCreateContent></FolderCreateContent>محتوى الاستجابة
<FolderName></FolderName>اسم المجلد
<FolderId></FolderId>معرف المجلد الجديد
Create Folder Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=create_folder&folder_name=new
Response (XML format)
<FolderCreateResponse>
  <FolderCreateHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </FolderCreateHeader>
  <FolderCreateContent>
    <FolderName>new</FolderName>
    <FolderId>1</FolderId>
  </FolderCreateContent>
</FolderCreateResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=create_folder&folder_name=new
Response (JSON format)
{
   "FolderCreateResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "FolderCreateContent":{
         "FolderName":"new",
         "FolderId":"1"
      }
   }
}
 

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

Support multi-thread

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

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

مثال حذف مجلد

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_folder&folder_id=0,1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteFolderResponse>
  <DeleteFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteFolderHeader>
</DeleteFolderResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_folder&folder_id=0,1
Response (JSON format)
{
  "DeleteFolderResponse": {
    "SuccessCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

تعيين معلمة طلب البحث في بيانات المجلد
الشرح
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"
Set Folder Whois Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (XML format)
<SetFolderWhoisResponse>
  <SetFolderWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderWhoisHeader>
</SetFolderWhoisResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format)
{
   "SetFolderWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderNsResponse>
  <SetFolderNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNsHeader>
  <SetFolderNsContent>
    <Servers>
      <Server>
        <ServerName>ns1.hosts.com</ServerName>
        <ServerId>0</ServerId>
      </Server>
      <Server>
        <ServerName>ns2.hosts.com</ServerName>
        <ServerId>1</ServerId>
      </Server>
    </Servers>
  </SetFolderNsContent>
</SetFolderNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Response (JSON format)
{
  "SetFolderNsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetFolderNsContent": {
      "Servers": [
        {
          "ServerName": "ns1.hosts.com",
          "ServerId": "0"
        },
        {
          "ServerName": "ns2.hosts.com",
          "ServerId": "1"
        }
      ]
    }
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب ركن المجلد
الشرح
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"
Set Folder Parking Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Response (XML format)
<SetFolderParkingResponse>
  <SetFolderParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderParkingHeader>
</SetFolderParkingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Response (JSON format)
{
   "SetFolderParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معامل طلب توجيه المجلد
الشرح
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"
Set Folder Forwarding Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Response (XML format)
<SetFolderForwardingResponse>
  <SetFolderForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderForwardingHeader>
</SetFolderForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Response (JSON format)
{
   "SetFolderForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين بارامتر طلب إخفاء المجلد
الشرح
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"
Set Folder Stealth Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Response (XML format)
<SetFolderStealthResponse>
  <SetFolderStealthHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderStealthHeader>
</SetFolderStealthResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Response (JSON format)
{
   "SetFolderStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معلمة طلب استضافة المجلد
الشرح
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"
Set Folder Hosting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Response (XML format)
<SetFolderHostingResponse>
  <SetFolderHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHostingHeader>
</SetFolderHostingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Response (JSON format)
{
   "SetFolderHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

إذا تم استدعاء أمر تعيين مجلد 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"
Set Folder DNS Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format)
{
   "SetFolderDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

إذا تم استدعاء أمر تعيين مجلد 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 للمجلد

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (JSON format)
{
  "SetFolderDnsResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب توجيه البريد الإلكتروني للمجلد
الشرح
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"
Set Folder Email Forward Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
Response (XML format)
<SetFolderEmailForwardingResponse>
  <SetFolderEmailForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&[email protected]
Response (JSON format)
{
   "SetFolderEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين طلب إعداد مجلد واضح
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه
serviceالخدمة التي ترغب في مسحها، يمكن أن تكون التوجيه، التخفي، إعادة توجيه البريد الإلكتروني، نظام أسماء المجالات، وخوادم الأسماء.
نتيجة علامة XML
الشرح
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearFolderSettingHeader></SetClearFolderSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Clear Folder Setting Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Response (XML format)
<SetClearFolderSettingResponse>
  <SetClearFolderSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearFolderSettingHeader>
</SetClearFolderSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Response (JSON format)
{
   "SetClearFolderSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

تعيين معامل طلب اسم المجلد
الشرح
folder_idمعرف المجلد الذي تريد ضبطه
folder_nameاسم المجلد الجديد
نتيجة علامة XML
الشرح
<SetFolderNameResponse></SetFolderNameResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderNameHeader></SetFolderNameHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Name Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
Response (XML format)
<SetFolderNameResponse>
  <SetFolderNameHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNameHeader>
</SetFolderNameResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
Response (JSON format)
{
   "SetFolderNameResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

طلب تعيين معلمة خيار تجديد المجلد
الشرح
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"
Set Folder Renew Option Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Response (XML format)
<SetFolderRenewOptionResponse>
  <SetFolderRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Response (JSON format)
{
   "SetFolderRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

هذا الأمر متاح فقط بصيغة 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>حالة القفل
Folder List Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=folder_list
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=folder_list
Response (JSON format)
{
  "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"
        }
      }
    ]
  }
}
 

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

Support multi-thread

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

إضافة طلب حجز مسبق للمعلمات
الشرح
domain المجالات التي ترغب في إضافتها والموافقة على الدفع مقابلها في حالة قيام داينادوت بالتقاطها، يمكن إضافة 100 مجالات لكل طلب، يجب فصلها بفواصل.
نتيجة علامة XML
الشرح
<AddBackorderRequestResponse></AddBackorderRequestResponse>العقدة الجذرية لمستند الاستجابة XML
<AddBackorderRequestHeader></AddBackorderRequestHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Add Backorder Request Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Response (XML format)
<AddBackorderRequestResponse>
  <AddBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddBackorderRequestHeader>
</AddBackorderRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Response (JSON format)
{
   "AddBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

طلب حذف طلب الشراء المعلق
الشرح
domain المجالات التي ترغب في إزالتها من قائمة طلبات الحجز المسبق الخاصة بك، يمكن إزالة 100 مجالات لكل طلب، يجب فصلها بفواصل
نتيجة علامة XML
الشرح
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Delete Backorder Request Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
Response (XML format)
<DeleteBackorderRequestResponse>
  <DeleteBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
Response (JSON format)
{
   "DeleteBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (JSON format)
{
  "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"
      }
    ]
  }
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (تنسيق CSV)
ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
 

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

Support multi-thread

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

طلب الحصول على معلمات المزادات المفتوحة
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
typeنوع المزاد الذي تريد رؤيته، يجب أن يكون "expired", "user", "backorder", أو "registry_expired", "registrar", إذا كنت ترغب في الحصول على أكثر من نوع مزاد، يمكنك استخدام "," لفصل كل نوع مزاد
نتيجة علامة 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>عمر المجال
Get Open Auctions Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_auctions&currency=usd&type=expired
Response (XML format)
<GetOpenAuctionsResponse>
  <GetOpenAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenAuctionsHeader>
  <GetOpenAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    .
    .
    .
  </GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
طلب (تنسيق csv)

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

الاستجابة

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
.
.
.

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

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

Support multi-thread

استدعاء أمر الحصول على تفاصيل المزاد سيعيد تفاصيل المزاد المحدد. هذا الأمر متوفر فقط بصيغة 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>سعر التجديد
Get Auction Details Example
Request (XML format) https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd
Response (JSON format)
{
  "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": []
    }
  ]
}
 

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

Support multi-thread

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

طلب الحصول على معلمات عروض المزاد
الشرح
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>وقت انتهاء المزاد
Get Auction Bids Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_auction_bids&ampcurrency=usd
Response (XML format)
<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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_auction_bids&ampcurrency=usd
Response (JSON format)
{
    "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
        }
        ...
    ]
}
 

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

Support multi-thread

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

طلب معلمات المزايدة في المزاد
الشرح
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"
Domain Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Response (XML format)
<PlaceAuctionBidResponse>
  <PlaceAuctionBidHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
طلب (تنسيق csv)

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

الاستجابة

ok,success

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

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

Support multi-thread

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

طلب الحصول على معلمات المزادات المغلقة
الشرح
start_dateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
end_dateتاريخ انتهاء المزاد، 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>عرضك البديل لهذا المزاد

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (JSON format)
{
  "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"
      }
    ]
  }
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (تنسيق 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
 

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

Support multi-thread

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

طلب الحصول على معلمات مزادات الطلب المفتوح المعلقة
الشرح
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)
Get Open Backorder Auctions Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_backorder_auctions&currency=usd
Response (XML format)
<GetOpenBackorderAuctionsResponse>
  <GetOpenBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenBackorderAuctionsHeader>
  <GetOpenBackorderAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    .
    .
    .
  </GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
طلب (تنسيق csv)

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

الاستجابة

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

 

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

Support multi-thread

استدعاء أمر تفاصيل مزاد الطلب المسبق سيعيد تفاصيل المزاد المحدد. هذا الأمر متاح فقط بتنسيق 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>عرضك الافتراضي للمزاد المحدد. إذا لم تكن قد قدمت عرضًا، سيكون {و}
Get Backorder Auction Details Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_backorder_auction_details&domain=example.com&currency=usd
Response (JSON format)
{
  "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"
      }
    }
  }
}
 

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

Support multi-thread

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

طلب معلمة المزايدة في مزاد الطلبات المسبقة
الشرح
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"
Place Backorder Auction Bid Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Response (XML format)
<PlaceBakcorderAuctionBidResponse>
 <PlaceBackorderAuctionBidHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Response (JSON format)
{
   "PlaceBakcorderAuctionBidResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9&currency=usd
Response (تنسيق CSV)
ok,success
 

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

Support multi-thread

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

الحصول على معلمة طلب المزادات المغلقة لأوامر الشراء المسبقة
الشرح
start_dateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
end_dateتاريخ انتهاء المزاد، 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>عدد عروض المزاد

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (JSON format)
{
  "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"
      }
    ]
  }
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (تنسيق 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
 

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

Support multi-thread

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

طلب معلمة المجالات المنتهية الصلاحية المغلقة
الشرح
currency(optional)العملة الخاصة بنتيجة العائد يجب أن تكون دولار أمريكي أو يورو أو يوان صيني، والعملة الافتراضية هي الدولار الأمريكي.
domain(optional)إضافة هذه البارامتر إذا كنت ترغب في الاستعلام عن مجال قريب من الإغلاق
count_per_page (optional)كم عدد الكيانات المعروضة في كل صفحة؟
page_index (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>إيرادات التصفية
<DynaAppraisal></DynaAppraisal>تقييم دينا
<InboundLinks></InboundLinks>روابط الدومين الواردة
<MonthlyVisitors></MonthlyVisitors>زوار المجال
<Currency></Currency>عملة
Get Expired Closeout Domains Example
Request (XML format) https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains&currency=usd
Response (JSON format)
{
  "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"
        }
      }
    ]
  }
}
 

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

Support multi-thread

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

شراء طلب معاملة مجال منتهي الصلاحية
الشرح
domain المجال الذي ترغب في شرائه، يمكن إدخال مجال واحد فقط لكل طلب
currency(optional)العملة الخاصة بنتيجة العائد يجب أن تكون دولار أمريكي أو يورو أو يوان صيني، والعملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XML
الشرح
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>تصنيف استجابة شراء مجال مغلق منتهي الصلاحية، إنه العقدة الجذرية لوثيقة الاستجابة XML
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>شراء مجال منتهي الصلاحية المغلق
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Buy Expired Closeout Domain Example
Request (XML format) https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
  <BuyExpiredCloseoutDomainHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain&currency=USD&domain=domain.com
Response (JSON format)
{
  "BuyExpiredCloseoutDomainResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

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

Support multi-thread

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

الحصول على معايير طلب القوائم
الشرح
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>العمر
Get Listings Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&currency=usd&command=get_listings
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&currency=usd&command=get_listings
Response (JSON format)
{
  "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"
      }
    ]
  }
}
 

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

Support multi-thread

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

الحصول على بارامتر طلب عنصر القائمة
الشرح
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>العمر
Get Listing Item Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=get_listing_item&currency=usd&domain=domain_name
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_listing_item&currency=usd&domain=domain_name
Response (JSON format)
{
  "GetListingsItemResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Listing": {
      "ListingId": "id",
      "Domain": "domain_name",
      "Price": "0",
      "InboundLinks": "0",
      "Age": "0",
      "PendingSaleLocked": "No"
    }
  }
}
 

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

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=buy_it_now&domain=domain&currency=currency
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BuyItNowResponse>
  <BuyItNowHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </BuyItNowHeader>
</BuyItNowResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=buy_it_now&domain=domain&currency=currency
Response (JSON format)
{
  "BuyItNowResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

أمر تحديد البيع

Support multi-thread

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

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

تعيين معلمات طلب البيع
الشرح
domains المجال الذي ترغب في إدراجه للبيع في سوق المجالات، يمكن إدخال مجال واحد فقط لكل طلب
for_sale_typeيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك: > سوق: قم بإدراج مجالك للبيع في سوق المجالات. سيتم تعيين قوائم المجالات الجديدة إلى الفئة والفئة الفرعية والسعر المدخل أدناه. إذا تم تحديد سعر فعلي، سيكون المجال متاحًا للشراء الفوري ويتم دفعه إلى المشتري. لمزيد من المعلومات حول عملية بيع المجال > > غير معروض للبيع: إلغاء الإدراج
listing_type (optional)يمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك من خلال السوق (يجب تحديده إذا كان نوع البيع المطروح هو السوق): > شراء الآن تحديد سعر ثابت سيجعل المجال متاحًا للشراء الفوري ويدفعه إلى المشتري. ملاحظة: بالنسبة لل مجال في فترة السماح بالإضافة، إذا تمت عملية بيع، فقد لا يتم حذف السماح بها بعد ذلك. لمزيد من المعلومات عن حذف السماح > تقديم عرض يمكنك اختيار تحديد سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ للعرض. ملاحظة: بالنسبة لل مجال في فترة السماح بالإضافة، إذا تمت عملية بيع، فقد لا يتم حذف السماح بها بعد ذلك. لمزيد من المعلومات عن حذف السماح > شراء الآن وتقديم عرض تحديد سعر ثابت سيضع المجال متاحًا للشراء الفوري ويدفعه إلى المشتري. يمكنك اختيار تحديد سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ للعرض. ملاحظة: بالنسبة لل مجال في فترة السماح بالإضافة، إذا تمت عملية بيع، فقد لا يتم حذف السماح بها بعد ذلك. لمزيد من المعلومات عن حذف السماح
price (optional)السعر الذي ترغب في بيع مجالك به (إلزامي إذا كان نوع البيع هو السوق)
minimum_offer (optional)العرض الأدنى الذي ستقبله مقابل مجالك. (مطلوب في حال كان نوع البيع هو السوق)
installment (optional)هل يُسمح بالدفع بالتقسيط؟ إذا كنت تريد تفعيل الدفع بالتقسيط، قم بضبطه على نعم.
maximum_installments (optional)الحد الأقصى لعدد الأقساط المسموح به يستخدم فقط عندما تكون الأقساط صحيحة يمكنك اختيار قيمة من 2 إلى 12 لتمثيل الحد الأقصى للأشهر لدفع الأقساط
category (optional)اختر فئة ل مجالك، يمكنك الرجوع إلى جدول مقارنة الفئات والفئات الفرعية أدناه للتعبئة الاختيارية.
Sub-category (optional)اختر تصنيفاً فرعياً ل مجالك، يمكنك الرجوع إلى جدول مقارنة التصنيف والتصنيف الفرعي أدناه للإختيار. لاحظ: يجب أن تكون قيمة المعامل الخاص بك هي الرقم المقابل للتصنيف الفرعي.
Description (optional)وصف مجالك
نتيجة علامة XML
الشرح
<SetForSaleResponse></SetForSaleResponse>عقدة الجذر للاستجابة
<SetForSaleHeader></SetForSaleHeader>ترويسة مجموعة للبيع
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"

مجموعة للبيع كمثال

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetForSaleResponse>
  <SetForSaleHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetForSaleHeader>
</SetForSaleResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Response (JSON format)
{
  "SetForSaleResponse": {
    "ResponseCode: ": "0",
    "Status": "Success"
  }
}
 

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

Support multi-thread

يؤدي استدعاء أمر تأكيد تعيين 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"
Set Afternic Confirm Action Example
Request (XML format) https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetAfternicConfirmActionResponse>
  <SetAfternicConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetAfternicConfirmActionHeader>
</SetAfternicConfirmActionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Response (JSON format)
{
  "SetAfternicConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

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

Support multi-thread

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

تعيين معامل طلب تأكيد العمل في سيدو
الشرح
domain المجال الذي ترغ بتعيينه يتطلب من Sedo تأكيد إجراء التحويل السريع، يمكن إدخال مجال واحد فقط لكل طلب
actionالإجراء الذي تريد تعيينه يجب أن يتطابق مع تأكيد سيدو، ويجب أن يكون "confirm_sedo"، أو "delete_from_sedo"
نتيجة علامة XML
الشرح
<SetSedoConfirmActionResponse></SetSedoConfirmActionResponse>علامة تأكيد إجراء تعيين سيدو، إنها العقدة الجذرية لمستند الاستجابة XML
<SetSedoConfirmActionHeader></SetSedoConfirmActionHeader>تعيين رأس تأكيد العمل لدى Sedo
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Set Sedo Confirm Action Example
Request (XML format) https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetSedoConfirmActionResponse>
  <SetSedoConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetSedoConfirmActionHeader>
</SetSedoConfirmActionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Response (JSON format)
{
  "SetSedoConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

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

Support multi-thread

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

طلب قائمة الطلبات
الشرح
search_byيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع بحثك: date_range، domain، order_id
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>يحتوي على حالة الطلب

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<OrderListResponse>
  <OrderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </OrderListHeader>
  <OrderListContent>
    <OrderList>
      <Order>
        <OrderId>123456</OrderId>
        <SubmittedDate>1734982193000</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>1734982193000</SubmittedDate>
        <Currency>EUR</Currency>
        <PaymentMethod>Paypal</PaymentMethod>
        <TotalCost>$100.00</TotalCost>
        <TotalPaid>$100.00</TotalPaid>
        <Status>Submitted</Status>
      </Order>
    </OrderList>
  </OrderListContent>
</OrderListResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Response (JSON format)
{
  "OrderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderList": [
      {
        "OrderId": "123456",
        "SubmittedDate": "2024/12/23",
        "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/12/23",
        "Currency": "EUR",
        "PaymentMethod": "Paypal",
        "TotalCost": "$100.00",
        "TotalPaid": "$100.00",
        "Status": "Submitted",
        "ItemList": []
      }
    ]
  }
}
 

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

Support multi-thread

استدعاء أمر الحصول على حالة الطلب سيسترجع حالة الطلب. هذا الأمر متاح فقط بتنسيق 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>حالة العنصر (مكتمل، ملغى، بمشكلة)
Get Order Status Example
Request (XML format) https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
Response (XML format)
<?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>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
Response (JSON format)
{
  "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"
        }
      ]
    }
  }
}
 

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

Support multi-thread

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

معالجة معامل الطلب
الشرح
لا حاجة لأي معامل إضافي.
نتيجة علامة XML
الشرح
<Response></Response>علامة استجابة جاري المعالجة
<ResponseHeader></ResponseHeader>علامة رأس المعالجة الجارية
<ResponseMsg></ResponseMsg>علامة رسالة استجابة is_processing. يجب أن تكون "yes"(يوجد عملية معالجة في النظام. يجب ألا ترسل طلبًا آخر.) أو "no"(لا توجد أي عملية معالجة لحسابك. يمكنك تقديم طلب جديد بأمان.)
Is-Processing Example
Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=is_processing
Response (XML format)
<Response>
  <ResponseHeader>
    <ResponseCode>0</ResponseCode>
    <ResponseMsg>yes</ResponseMsg>
  </ResponseHeader>
</Response>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=is_processing
Response (JSON format)
{
   "Response":{
      "ResponseCode":"0",
      "ResponseMsg":"no"
   }
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=is_processing
Response (تنسيق CSV)
ok,yes
 

أمر عرض القسائم

Support multi-thread

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

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

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

Request (XML format) https://api.dynadot.com/api3.xml?key=[API Key]&command=list_coupons&coupon_type=renewal
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ListCouponsResponse>
  <ListCouponsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </ListCouponsHeader>
  <ListCouponsContent>
    <Coupons>
      <Coupon>
        <Code>DOMAINRENEW1</Code>
        <Description>Domain Renew Coupon</Description>
        <CouponType>Hosting/SSL Coupons</CouponType>
        <DiscountType>PERCENTAGE_OFF</DiscountType>
        <DiscountInfo>
          <Percentage>10%</Percentage>
        </DiscountInfo>
        <Restriction>
          <PriceLevels>Any</PriceLevels>
          <IdnRestriction>None</IdnRestriction>
          <DomainDurationMin>1</DomainDurationMin>
          <DomainDurationMax>1</DomainDurationMax>
          <Tlds>
            <Tld>.com</Tld>
            <Tld>.net</Tld>
            <Tld>.org</Tld>
          </Tlds>
          <Currencies>
            <Currency>US Dollar USD ($)</Currency>
          </Currencies>
        </Restriction>
        <StartDate>1476811260000</StartDate>
        <EndDate>1483257540000</EndDate>
      </Coupon>
    </Coupons>
  </ListCouponsContent>
</ListCouponsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=list_coupons&coupon_type=renewal
Response (JSON format)
{
  "ListCouponsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Coupons": [
      {
        "Code": "DOMAINRENEW1",
        "Description": "Domain Renew Coupon",
        "CouponType": "Hosting/SSL Coupons",
        "DiscountType": "PERCENTAGE_OFF",
        "DiscountInfo": {
          "Percentage": "10%"
        },
        "Restriction": {
          "PriceLevels": "Any",
          "IdnRestriction": "None",
          "DomainDurationMin": "1",
          "DomainDurationMax": "1",
          "Tlds": [
            ".com",
            ".net",
            ".org"
          ],
          "Currencies": [
            "US Dollar USD ($)"
          ]
        },
        "StartDate": "1476811260000",
        "EndDate": "1483257540000"
      }
    ]
  }
}
هل أنت متأكد أنك تريد إغلاق المحادثة؟سيتم إغلاق المحادثة وسيتم مسح سجل الدردشة.
استمر في تسجيل الخروج،
أو البقاء على الدردشة.
لمراجعة جلسة الدردشة هذه، يرجىانقرهذه النوافذ.
Chat Online
الدردشة عبر الإنترنت0