النطاقات

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

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

ابدأ مع API المتقدمة للنطاقات من Dynadot

تتم إرسال طلبات API نطاقنا المتقدم إلى العنوان التالي:

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

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


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

domain_info, set_whois, set_ns, set_parking, set_forwarding, set_stealth, set_hosting, set_dns, set_dns2, set_email_forward, set_clear_domain_setting, set_folder, set_note, set_renew_option, set_privacy, tld_price, list_domain

create_cn_audit, get_cn_audit_status, create_contact, edit_contact, delete_contact, contact_list, get_contact

set_contact_eu_setting, set_contact_lv_setting, cancel_transfer, get_transfer_status, set_transfer_auth_code, authorize_transfer_away, get_transfer_auth_code

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

set_reseller_hold_status, get_reseller_hold_status, get_listings, get_listing_item, buy_it_now

account_info, get_account_balance, set_default_whois, set_default_ns, set_default_parking, set_default_forwarding, set_default_stealth, set_default_hosting, set_default_dns, set_default_dns2, set_default_email_forward, set_clear_default_setting, set_default_renew_option

create_folder, delete_folder, set_folder_whois, set_folder_ns, set_folder_parking, set_folder_forwarding, set_folder_stealth, set_folder_hosting, set_folder_dns, set_folder_dns2, set_folder_email_forward, set_clear_folder_setting, set_folder_name, set_folder_renew_option, folder_list

add_backorder_request, delete_backorder_request, backorder_request_list

get_open_auctions, get_auction_details, get_auction_bids, place_auction_bid, get_closed_auctions

is_processing

get_open_backorder_auctions, get_backorder_auction_details, place_backorder_auction_bid, get_closed_backorder_auctions, get_expired_closeout_domains, buy_expired_closeout_domain, get_order_status

get_domain_push_request, set_domain_push_request, set_afternic_confirm_actionset_domain_dnssec, get_whois_stats,

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

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

أمر البحث

عند استدعاء أمر البحث، ينبغي استخدام المعلمات التالية:

معلمة طلب البحث
الشرح
domain0 - domain99Der Domainname, nach dem Sie suchen, reguläres Konto kann 1 Domain pro Befehl angeben, Bulk- und Super-Bulk-Konto können bis zu 100 Domains angeben
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>إذا قمت بضبط "show_price" على القيمة "1"، فسيخبرك ببانات السعر إذا كان النطاق متاحاً.
<Language></Language>معلومات اللغة المتعلقة باسم النطاق

مثال للبحث

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD

الاستجابة (صيغة XML)
<Results>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.com</DomainName>
      <Available>yes</Available>
      <Price>77.00 in USD</Price>
    </SearchHeader>
  </SearchResponse>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.net</DomainName>
      <Available>yes</Available>
      <Price>44.00 in USD</Price>
    </SearchHeader>
  </SearchResponse>
</Results>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD

الطلب (صيغة JSON)
{
   "SearchResponse":{
      "ResponseCode":"0",
      "SearchResults":[
         {
            "DomainName":"mydomain.com",
            "Available":"yes",
            "Price":"77.00 in USD"
         },
         {
            "DomainName":"mydomain.net",
            "Available":"yes",
            "Price":"44.00 in USD"
         }
      ]
   }
}
 

أمر التسجيل

يؤدي استدعاء أمر 'register' إلى إنشاء أمر تسجيل ومعالجته. يجب أن يكون في حسابك رصيد يكفي لدفع رسوم الأمر. عند استدعاء أمر التسجيل، ينبغي استخدام المعلمات التالية:

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

مثال للتسجيل

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "RegisterResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.net",
      "Expiration":"1458379145266"
   }
}
 

أمر الحذف

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

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

مثال للحذف

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "DeleteResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domain1.com",
   }
}
 

أمر التجديد

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

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

مثال للتجديد

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon

الاستجابة (صيغة XML)
<RenewResponse>
  <RenewHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RenewHeader>
  <RenewContent>
    <Expiration>73984579834</Expiration>
  </RenewContent>
</RenewResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&domain=domian1.com&command=renew&duration=1&currency=USD&coupon=testcoupon

الطلب (صيغة JSON)
{
   "RenewResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "DomainName":"domian1.com",
      "Expiration":"73984579834"
   }
}
 

أمر الدفع

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

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

مثال عن دفع النطاقات (push)

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=push&domain=domian1.com&receiver_push_username=username&currency=USD

الاستجابة (صيغة XML)
<PushResponse>
  <PushHeader>
    <SuccessCode>0</SuccessCode>
    <Status>order created</Status>
  </PushHeader>
</PushResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=push&domain=domian1.com&receiver_push_username=username&currency=USD

الطلب (صيغة JSON)
{
   "PushResponse":{
      "ResponseCode":"0",
      "Status":"order created"
   }
}
 

تعليمة Transfer

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

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

مثال عن النقل

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "TransferResponse":{
      "ResponseCode":"0",
      "Status":"order created",
      "DomainName":"domian1.com"
   }
}
 

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

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

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

مثال تسجيل الجملة

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
  <BulkRegisterHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BulkRegisterHeader>
  <BulkRegisterContent>
    <BulkRegister>
      <RegisterResult>
        <DomainName>domain0.com</DomainName>
        <Expiration>1234567890</Expiration>
        <Result>success</Result>
        <Message>-</Message>
      </RegisterResult>
      <RegisterResult>
        <DomainName>domain1.com</DomainName>
        <Expiration>-</Expiration>
        <Result>error</Result>
        <Message>not_available</Message>
      </RegisterResult>
    </BulkRegister>
  </BulkRegisterContent>
</BulkRegisterResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=bulk_register&domain0=domain0.com&domain1=domain1.com&currency=USD

الطلب (صيغة JSON)
{
  "BulkRegisterResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BulkRegister": [
      {
        "DomainName": "domain0.com",
        "Expiration": "1234567890",
        "Result": "success",
        "Message": "-"
      },
      {
        "DomainName": "domain1.com",
        "Expiration": "-",
        "Result": "error",
        "Message": "not_available"
      }
    ]
  }
}
 

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

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

معلمة طلب معلومات النطاق
الشرح
domainغير مسموح سوى بعدد 1 نطاق/نطاقات فقط لكل طلب
وسم XML بالنتيجة
الشرح
<DomainInfoResponse></DomainInfoResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<DomainInfoResponseHeader></DomainInfoResponseHeader>رأس الاستجابة
<ResponseCode></ResponseCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<DomainInfoContent></DomainInfoContent>محتوى الاستجابة
<Domain></Domain>النطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء الصلاحية بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المتفق عليه UTC)،
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت Unix (ميللي ثانية منذ منتصف الليل بالتوقيت العالمي المنسّق في يناير 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>Udrp مقفل أو لا
<UdrpLocked></UdrpLocked>Udrp مقفل أو لا
<RegistrantUnverified></RegistrantUnverified>لم يتم التحقق من المسجل
<Hold></Hold>انتظار
<Privacy></Privacy>وضع الخصوصية
<isForSale></isForSale>وضع البيع
<RenewOption></RenewOption>خيار إعادة التجديد
<Note></Note>ملحوظات
<Folder></Folder>بيانات الملف
<FolderId></FolderId>هوية الملف
<FolderName></FolderName>اسم الملف

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<DomainInfoResponse>
  <DomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </DomainInfoHeader>
  <DomainInfoContent>
    <Domain>
      <Name>domain1.com</Name>
      <Expiration>1361430589062</Expiration>
      <Registration>1234567890123</Registration>
      <NameServerSettings>
        <Type>Dynadot Parking</Type>
        <WithAds>Yes</WithAds>
      </NameServerSettings>
      <Whois>
        <Registrant>
          <ContactId>0</ContactId>
        </Registrant>
        <Admin>
          <ContactId>0</ContactId>
        </Admin>
        <Technical>
          <ContactId>0</ContactId>
        </Technical>
        <Billing>
          <ContactId>0</ContactId>
        </Billing>
      </Whois>
      <Locked>yes</Locked>
      <Disabled>no</Disabled>
      <UdrpLocked>no</UdrpLocked>
      <RegistrantUnverified>no</RegistrantUnverified>
      <Hold>no</Hold>
      <Privacy>none</Privacy>
      <isForSale>yes</isForSale>
      <RenewOption>no renew option</RenewOption>
      <Note/>
      <Folder>
        <FolderId>-1</FolderId>
        <FolderName>(no folder)</FolderName>
      </Folder>
    </Domain>
  </DomainInfoContent>
</DomainInfoResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
  "DomainInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "DomainInfo": {
      "Name": "domain1.com",
      "Expiration": "1361430589062",
      "Registration": "1234567890123",
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      },
      "Whois": {
        "Registrant": {
          "ContactId": "0"
        },
        "Admin": {
          "ContactId": "0"
        },
        "Technical": {
          "ContactId": "0"
        },
        "Billing": {
          "ContactId": "0"
        }
      },
      "Locked": "yes",
      "Disabled": "no",
      "UdrpLocked": "no",
      "RegistrantUnverified": "no",
      "Hold": "no",
      "Privacy": "none",
      "isForSale": "yes",
      "RenewOption": "no renew option",
      "Note": "",
      "Folder": {
        "FolderId": "-1",
        "FolderName": "(no folder)"
      }
    }
  }
}
 

أمر تعيين Whois

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

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

مثال لتعيين Whois

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

الاستجابة (صيغة XML)
<SetWhoisResponse>
  <SetWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetWhoisHeader>
</SetWhoisResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_whois&domain=domain4.com&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

الطلب (صيغة JSON)
{
   "SetWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال لضبط الإيقاف المؤقت

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<SetParkingResponse>
  <SetParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetParkingHeader>
</SetParkingResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "SetParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_forwarding&forward_url=http%3A%2F%2Fwww.mydomain.com&domain=domain1.com,domain2.com

الاستجابة (صيغة XML)
<SetForwardingResponse>
  <SetForwardingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetForwardingHeader>
</SetForwardingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_forwarding&forward_url=http%3A%2F%2Fwww.mydomain.com&domain=domain1.com,domain2.com

الطلب (صيغة JSON)
{
   "SetForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

تعيين وضع التسلل

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

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

مثال على تعيين وضع التسلل

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes

الاستجابة (صيغة XML)
<SetHostingResponse>
  <SetHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetHostingHeader>
</SetHostingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes

الطلب (صيغة JSON)
{
   "SetHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين خادم أسماء نطاقات

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

(هذا الأمر قديم ولا ينصح باستخدامه، يرجى استخدام أمر تعيين خادم أسماء نطاقات 2 بدلاً منه)

معلمة طلب تعيين خادم أسماء نطاقات
الشرح
domainاسم النطاق الذي تريد تعيينه، لا يمكن تعيين أكثر من 100 نطاق/نطاقات في كل طلب، احرص على فصلها بفواصل (,)
main_record_typeنوع السجل الرئيسي
main_recordتحديد سجل خادم أسماء نطاقات لنطاقك
main_txt1 - main_txt4 (اختياري)تحديد سجلات نصية لنطاقك. إذا كان نوع السجل الرئيسي الخاص بك هو aaaa وقمت يتحديد main_record2,، يمكنك ضبط 3 سجلات نصية رئيسية، وإلا يمكنك ضبط 4 سجلات نصية رئيسية.
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_host4 (اختياري)تحديد البريد الإليكتروني المضيف لنطاقك، distance0 تمثل أعلى أولوية
mx_distance0 - mx_distance4 (اختياري)Distance0 تمثل أعلى أولوية
ttl (اختياري)المدة المتبقية للعمل
add_dns_to_current_setting (اختياري)إذا كنت ترغب في إضافة إعدادات DNS الجديدة إلى إعدادات DNS الموجودة. ضعها تساوي "1" (اختياري)
وسم XML بالنتيجة
الشرح
<SetDnsResponse></SetDnsResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetDnsHeader></SetDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_dns&domain=domain1.com&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
  <SetDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnsHeader>
</SetDnsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_dns&domain=domain1.com&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

الطلب (صيغة JSON)
{
  "SetDnsResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

أمر تعيين DNS2

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

الرجاء الانتباه إلى أن استدعاء أمر تعيين DNS2 سوف يتجاوز إعداد DNS الحالي.

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

مثال لتعيين DNS2

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
  <SetDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDnsHeader>
</SetDnsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1

الطلب (صيغة JSON)
{
  "SetDnsResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين نطاق واضح

عند القيام بأمر تعيين نطاق واضح، يجب تضمين الثوابت التالية:

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<SetClearDomainSettingResponse>
  <SetClearDomainSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDomainSettingHeader>
</SetClearDomainSettingResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "SetClearDomainSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder&domain=domian1.com&folder=folder1

الاستجابة (صيغة XML)
<SetFolderResponse>
  <SetFolderHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHeader>
</SetFolderResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder&domain=domian1.com&folder=folder1

الطلب (صيغة JSON)
{
   "SetFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

عند استدعاء أمر تعيين ملاحظة، ينبغي استخدام المعلمات التالية:

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_note&domain=domain1.com&note=Do not modify any information

الاستجابة (صيغة XML)
<SetNoteResponse>
  <SetNoteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNoteHeader>
</SetNoteResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_note&domain=domain1.com&note=Do not modify any information

الطلب (صيغة JSON)
{
   "SetNoteResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر تعيين معرف العميل (للبائعين فقط)

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

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

مثال على معرف العميل

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
    "SetCustomerIdResponse": {
        "ResponseCode": 0,
        "Status": "success",
        "SetCustomerIdSuccess": [
            {
                "Domain": "domain1.com",
                "CustomerId": 123456
            },
            {
                "Domain": "domain2.com",
                "CustomerId": 123456
            }
        ]
    }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetPrivacyResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال عن أسعار نطاقات TLD

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
  <TldPriceResponseHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <PriceLevel>Regular Pricing</PriceLevel>
    <Currency>USD</Currency>
  </TldPriceResponseHeader>
  <TldPriceContent>
    <TldContent>
      <Tld>.com</Tld>
      <Usage>Usage</Usage>
      <Price>
        <Unit>(Price/1 year)</Unit>
        <Register>99.00</Register>
        <Renew>60.00</Renew>
        <Transfer>92.00</Transfer>
      </Price>
      <Privacy>Yes</Privacy>
      <GracePeriod>
        <Unit>(Grace Period/days)</Unit>
        <Renew>40</Renew>
        <Delete>5</Delete>
      </GracePeriod>
      <IDN>Yes</IDN>
      <Restrictions>--</Restrictions>
    </TldContent>
  </TldPriceContent>
</TldPriceResponse>
الطلب (صيغة JSON)

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

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

أمر تعيين قائمة النطاق

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

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

مثال على تعيين قائمة النطاق

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<ListDomainInfoResponse>
  <ListDomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ListDomainInfoHeader>
  <ListDomainInfoContent>
    <DomainInfoList>
      <DomainInfo>
        <Domain>
          <Name>domain-exp140.com</Name>
          <Expiration>1361430589062</Expiration>
          <Registration>1234567890123</Registration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>Yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>0</ContactId>
            </Registrant>
            <Admin>
              <ContactId>0</ContactId>
            </Admin>
            <Technical>
              <ContactId>0</ContactId>
            </Technical>
            <Billing>
              <ContactId>0</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <UdrpLocked>no</UdrpLocked>
          <RegistrantUnverified>no</RegistrantUnverified>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note/>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
        </Domain>
        <Domain>
          <Name>domain-exp141.com</Name>
          <Expiration>1361430589062</Expiration>
          <Registration>1234567890123</Registration>
          <NameServerSettings>
            <Type>Dynadot Parking</Type>
            <WithAds>Yes</WithAds>
          </NameServerSettings>
          <Whois>
            <Registrant>
              <ContactId>1</ContactId>
            </Registrant>
            <Admin>
              <ContactId>2</ContactId>
            </Admin>
            <Technical>
              <ContactId>3</ContactId>
            </Technical>
            <Billing>
              <ContactId>4</ContactId>
            </Billing>
          </Whois>
          <Locked>yes</Locked>
          <Disabled>no</Disabled>
          <UdrpLocked>no</UdrpLocked>
          <RegistrantUnverified>no</RegistrantUnverified>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note/>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
        </Domain>
      </DomainInfo>
    </DomainInfoList>
  </ListDomainInfoContent>
</ListDomainInfoResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=list_domain

الطلب (صيغة JSON)
{
  "ListDomainInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "MainDomains": [
      {
        "Name": "domain-exp140.com",
        "Expiration": "1361430589062",
        "Registration": "1234567890123",
        "NameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "Yes"
        },
        "Whois": {
          "Registrant": {
            "ContactId": "0"
          },
          "Admin": {
            "ContactId": "0"
          },
          "Technical": {
            "ContactId": "0"
          },
          "Billing": {
            "ContactId": "0"
          }
        },
        "Locked": "yes",
        "Disabled": "no",
        "UdrpLocked": "no",
        "RegistrantUnverified": "no",
        "Hold": "no",
        "Privacy": "none",
        "isForSale": "no",
        "RenewOption": "no renew option",
        "Note": "",
        "Folder": {
          "FolderId": "-1",
          "FolderName": "(no folder)"
        }
      },
      {
        "Name": "domain-exp141.com",
        "Expiration": "1361430589062",
        "Registration": "1234567890123",
        "NameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "Yes"
        },
        "Whois": {
          "Registrant": {
            "ContactId": "1"
          },
          "Admin": {
            "ContactId": "2"
          },
          "Technical": {
            "ContactId": "3"
          },
          "Billing": {
            "ContactId": "4"
          }
        },
        "Locked": "yes",
        "Disabled": "no",
        "UdrpLocked": "no",
        "RegistrantUnverified": "no",
        "Hold": "no",
        "Privacy": "none",
        "isForSale": "no",
        "RenewOption": "no renew option",
        "Note": "",
        "Folder": {
          "FolderId": "-1",
          "FolderName": "(no folder)"
        }
      }
    ]
  }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US

الاستجابة (صيغة XML)
<CreateContactResponse>
  <CreateContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateContactHeader>
  <CreateContactContent>
    <ContactId>1234</ContactId>
  </CreateContactContent>
</CreateContactResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=create_contact&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US

الطلب (صيغة JSON)
{
   "CreateContactResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "CreateContactContent":{
         "ContactId":"0"
      }
   }
}
 

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

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

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

https://api.dynadot.com/api3.xml?key=mykey&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<EditContactResponse>
  <EditContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </EditContactHeader>
  <EditContactContent>
    <ContactId>0</ContactId>
  </EditContactContent>
</EditContactResponse>
الطلب (صيغة CSV)

https://api.dynadot.com/api3.html?key=mykey&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US

الطلب (صيغة CSV)
ok,

success,
,
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=edit_contact&contact_id=0&name=Webb&[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US

الطلب (صيغة JSON)
{
  "EditContactResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "EditContactContent": {
      "ContactId": "0"
    }
  }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
  <SetContactEUSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactEUSettingHeader>
  <SetContactEUSettingContent>
    <ContactId>0</ContactId>
  </SetContactEUSettingContent>
</SetContactEUSettingResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
  "SetContactEUSettingResponse": {
    "ResponseCode: ": "0",
    "Status": "Success",
    "SetContactEUSettingContent": {
      "ContactId: ": "0"
    }
  }
}
 

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

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

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

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

الطلب (صيغة CSV)

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

الطلب (صيغة CSV)
ok,success,0
الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
  <SetContactLvSettingHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetContactLvSettingHeader>
  <SetContactLvSettingContent>
    <ContactId>0</ContactId>
  </SetContactLvSettingContent>
</SetContactLvSettingResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
  "SetContactLvSettingResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "SetContactLvSettingContent": {
      "ContactId: ": "0"
    }
  }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "DeleteContactResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
  <ContactListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ContactListHeader>
  <ContactListContent>
    <ContactList>
      <Contact>
        <ContactId>0</ContactId>
        <Organization/>
        <Name>Jack Slater</Name>
        <Email>[email protected]</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>1 Free Way</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
      <Contact>
        <ContactId>1</ContactId>
        <Organization/>
        <Name>John tester</Name>
        <Email>[email protected]</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>123.456.7890</PhoneNum>
        <FaxCc>1</FaxCc>
        <FaxNum>123.456.7890</FaxNum>
        <Address1>high Way first</Address1>
        <Address2/>
        <City>San Francisco</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
        <GtldVerified>yes</GtldVerified>
      </Contact>
    </ContactList>
  </ContactListContent>
</ContactListResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=contact_list

الطلب (صيغة JSON)
{
  "ContactListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ContactList": [
      {
        "ContactId": "0",
        "Organization": "",
        "Name": "Jack Slater",
        "Email": "[email protected]",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "1 Free Way",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "no"
      },
      {
        "ContactId": "1",
        "Organization": "",
        "Name": "John tester",
        "Email": "[email protected]",
        "PhoneCc": "1",
        "PhoneNum": "123.456.7890",
        "FaxCc": "1",
        "FaxNum": "123.456.7890",
        "Address1": "high Way first",
        "Address2": "",
        "City": "San Francisco",
        "State": "CA",
        "ZipCode": "90068",
        "Country": "US",
        "GtldVerified": "yes"
      }
    ]
  }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=get_contact&contact_id=10000

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetContactResponse>
  <GetContactHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetContactHeader>
  <GetContactContent>
    <GetContact>
      <Contact>
        <ContactId>12345</ContactId>
        <Organization>org</Organization>
        <Name>name</Name>
        <Email>[email protected]</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>address1</Address1>
        <Address2>address2</Address2>
        <City>city</City>
        <State>state</State>
        <ZipCode>zipcode</ZipCode>
        <Country>country</Country>
        <GtldVerified>no</GtldVerified>
      </Contact>
    </GetContact>
  </GetContactContent>
</GetContactResponse>
الطلب (صيغة JSON)

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

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

احصل على تعليمة خادم الأسماء

في حال استدعائك أمر الحصول على خادم الاسم، فعليك بتضمين المعلمات التالية:

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

مثال على Get Name Server

الطلب (صيغة XML)

https://api.dynadot.com/api3.html?key=mykey&command=get_ns&domain=mydomain.com

الاستجابة (صيغة XML)
<GetNsResponse>
  <GetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetNsHeader>
  <NsContent>
    <Host>ns1.mydomain.com</Host>
    <Host>ns2.mydomain.com</Host>
  </NsContent>
</GetNsResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "GetNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "NsContent":{
         "Host":"ns1.mydomain.com",
         "Host":"ns2.mydomain.com"
      }
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<AddNsResponse>
  <AddNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddNsHeader>
  <AddNsContent>
    <Server>
      <Host>ns1.mydomain.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </AddNsContent>
</AddNsResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "AddNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "AddNsContent":{
         "Server":{
            "Host":"ns1.mydomain.com",
            "ServerId":"0"
         }
      }
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=register_ns&host=domain1.com&ip=192.168.1.1

الاستجابة (صيغة XML)
<RegisterNsResponse>
  <RegisterNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterNsHeader>
  <RegisterNsContent>
    <Server>
      <Host>domain1.com</Host>
      <ServerId>0</ServerId>
    </Server>
  </RegisterNsContent>
</RegisterNsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=register_ns&host=domain1.com&ip=192.168.1.1

الطلب (صيغة JSON)
{
   "RegisterNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "RegisterNsContent":{
         "Server":{
            "Host":"ndomain1.com",
            "ServerId":"0"
         }
      }
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_ns_ip&server_id=1&ip0=192.168.1.1

الاستجابة (صيغة XML)
<SetNsIpResponse>
  <SetNsIpHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsIpHeader>
</SetNsIpResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_ns_ip&server_id=1&ip0=192.168.1.1

الطلب (صيغة JSON)
{
   "SetNsIpResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

عند استدعاء أمر حذف خادم أسماء، ينبغي استخدام المعلمات التالية:

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

تعليمة Delete Name Server By Domain

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

مُعامل Delete Name Server By Domain Request
الشرح
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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com

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

https://api.dynadot.com/api3.json?key=mykey&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com

الطلب (صيغة JSON)
{
   "DeleteNsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<ServerListResponse>
  <ServerListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ServerListHeader>
  <ServerListContent>
    <NameServerList>
      <List>
        <Server>
          <ServerId>0</ServerId>
          <ServerName>ns1.com</ServerName>
        </Server>
        <Server>
          <ServerId>1</ServerId>
          <ServerName>domain1.com</ServerName>
          <ServerIp>192.168.1.1</ServerIp>
          <ServerIp>1.1.1.1</ServerIp>
        </Server>
      </List>
    </NameServerList>
  </ServerListContent>
</ServerListResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=server_list

الطلب (صيغة JSON)
{
  "ServerListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "ServerList": [
      {
        "ServerId": "0",
        "ServerName": "ns1.com"
      },
      {
        "ServerId": "1",
        "ServerName": "domain1.com",
        "ServerIps": [
          {
            "Ip": "192.168.1.1"
          },
          {
            "Ip": "1.1.1.1"
          }
        ]
      }
    ]
  }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetDnsResponse>
  <GetDnsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetDnsHeader>
  <GetDnsContent>
    <NameServerSettings>
      <Type>Dynadot Parking</Type>
      <WithAds>Yes</WithAds>
    </NameServerSettings>
  </GetDnsContent>
</GetDnsResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
  "GetDnsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetDns": {
      "NameServerSettings": {
        "Type": "Dynadot Parking",
        "WithAds": "Yes"
      }
    }
  }
}
 

تعليمة Get Transfer Auth Code

عليك إلغاء قفل النطاق أو الحساب قبل طلب رمز المصادقة.

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "GetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "AuthCode":"testauthcode"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=get_transfer_status&domain=domian1.com&transfer_type=in

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferStatusResponse>
  <GetTransferStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetTransferStatusHeader>
  <GetTransferStatusContent>
    <TransferList>
      <Transfer>
        <OrderId>testorderid</OrderId>
        <TransferStatus>teststatus</TransferStatus>
      </Transfer>
      <Transfer>
        <OrderId>testorderid2</OrderId>
        <TransferStatus>teststatus2</TransferStatus>
      </Transfer>
    </TransferList>
  </GetTransferStatusContent>
</GetTransferStatusResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=get_transfer_status&domain=domian1.com&transfer_type=in

الطلب (صيغة JSON)
{
  "GetTransferStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "TransferList": [
      {
        "OrderId": "testorderid",
        "TransferStatus": "teststatus"
      },
      {
        "OrderId": "testorderid2",
        "TransferStatus": "teststatus2"
      }
    ]
  }
}
 

ضبط كود تفويض نقل لأمر التحويل

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<SetTransferAuthCodeResponse>
   <SetTransferAuthCodeHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "SetTransferAuthCodeResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "CancelTransferResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

الأمر المخول لنقل بعيدًا (للوكلاء فقط)

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

تخول نقل مثال

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "AuthorizeTransferAwayResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "Result":"away_approved"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2

الاستجابة (صيغة XML)
<CreateCnAuditResponse>
  <CreateCnAuditHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateCnAuditHeader>
 </CreateCnAuditResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "CreateCnAuditResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.xml/api3.xml?key=mykey&command=get_cn_audit_status&contact_id=testcontactid

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
  <GetCnAuditStatusHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
    <CnAuditStatus>pass</CnAuditStatus>
  </GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
الطلب (صيغة JSON)

https://api.dynadot.json/api3.xml?key=mykey&command=get_cn_audit_status&contact_id=testcontactid

الطلب (صيغة JSON)
{
  "GetCnAuditStatusResponse": {
    "ResponseCode": "0",
    "Status": "success",
    "CnAuditStatus": "pass"
  }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetAccountBalanceResponse>
  <GetAccountBalanceHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAccountBalanceHeader>
  <GetAccountBalanceContent>
    <BalanceList>
      <Balance>
        <Currency>USD</Currency>
        <Amount>300.00</Amount>
      </Balance>
    </BalanceList>
  </GetAccountBalanceContent>
</GetAccountBalanceResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=get_account_balance

الطلب (صيغة JSON)
{
  "GetAccountBalanceResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BalanceList": [
      {
        "Currency": "USD",
        "Amount": "300.00"
      }
    ]
  }
}
 

تعليمة Get Listings

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

معامل Get Listings Request
الشرح
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny", والعملة الافتراضية هي الدولار الأمريكي
exclude_pending_sale (اختياري)إذا لم تكن تود الحصول على قوائك قفل العروض المعلقة، فيجب أن تكون "yes", الافتراضية هي "no"
وسم XML بالنتيجة
الشرح
<GetListingsResponse></GetListingsResponse>العقدة الجذرية لمستند XML للاستجابةXML مستند
<GetListingsHeader></GetListingsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetListingsContent></GetListingsContent>محتوى القوائم
<Listing></Listing>محتوى العنصر المعروض
<ListingId></ListingId>معرِّف القيد
<Domain></Domain>اسم النطاق
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر

مثال على Get Listings

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsResponse>
  <GetListingsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetListingsHeader>
  <GetListingsContent>
    <Listing>
      <ListingId>id1</ListingId>
      <Domain>domain_name1</Domain>
      <Price>1</Price>
      <InboundLinks>1</InboundLinks>
      <Age>1</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
    </Listing>
    <Listing>
      <ListingId>id2</ListingId>
      <Domain>domain_name2</Domain>
      <Price>2</Price>
      <InboundLinks>2</InboundLinks>
      <Age>2</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
    </Listing>
  </GetListingsContent>
</GetListingsResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
  "GetListingsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Listing": [
      {
        "ListingId": "id1",
        "Domain": "domain_name1",
        "Price": "1",
        "InboundLinks": "1",
        "Age": "1",
        "PendingSaleLocked": "No"
      },
      {
        "ListingId": "id2",
        "Domain": "domain_name2",
        "Price": "2",
        "InboundLinks": "2",
        "Age": "2",
        "PendingSaleLocked": "No"
      }
    ]
  }
}
 

تعليمة Get Listing Item

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

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

مثال على Get Listing Item

الطلب (صيغة XML)

http://api.dynadot.com/api3.xml?key=my_key&command=get_listing_item&currency=usd&domain=domain_name

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsItemResponse>
  <GetListingsItemHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetListingsItemHeader>
  <GetListingsItemContent>
    <Listing>
      <ListingId>id</ListingId>
      <Domain>domain_name</Domain>
      <Price>0</Price>
      <InboundLinks>0</InboundLinks>
      <Age>0</Age>
      <PendingSaleLocked>No</PendingSaleLocked>
    </Listing>
  </GetListingsItemContent>
</GetListingsItemResponse>
الطلب (صيغة JSON)

http://api.dynadot.com/api3.json?key=my_key&command=get_listing_item&currency=usd&domain=domain_name

الطلب (صيغة JSON)
{
  "GetListingsItemResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Listing": {
      "ListingId": "id",
      "Domain": "domain_name",
      "Price": "0",
      "InboundLinks": "0",
      "Age": "0",
      "PendingSaleLocked": "No"
    }
  }
}
 

تعليمة Buy It Now Command

في حال استدعائك أمر الشراء الآن، فعليك بتضمين المعلمات التالية:

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

مثال على Buy It Now

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "BuyItNowResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "Message":"domain order created"
   }
}
 

أمر بيانات الحساب

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

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

مثال على بيانات الحساب

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
  <AccountInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AccountInfoHeader>
  <AccountInfoContent>
    <AccountInfo>
      <Username>testname</Username>
      <ForumName>test forum name</ForumName>
      <Contact>
        <Organization/>
        <Name>testname test</Name>
        <Email>[email protected]</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc/>
        <FaxNum/>
        <Address1>1 test road</Address1>
        <Address2/>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90000</ZipCode>
        <Country>US</Country>
      </Contact>
      <CustomerSince>1364888735253</CustomerSince>
      <AccountLock>on</AccountLock>
      <TotalSpending>$0.00</TotalSpending>
      <PriceLevel>Regular Pricing</PriceLevel>
      <AccountBalance>$70.02</AccountBalance>
      <CustomTimeZone>PST</CustomTimeZone>
      <DefaultSettings>
        <DefaultWhois>
          <DefaultRegistrant>
            <ContactId>0</ContactId>
          </DefaultRegistrant>
          <DefaultAdmin>
            <ContactId>0</ContactId>
          </DefaultAdmin>
          <DefaultTechnical>
            <ContactId>0</ContactId>
          </DefaultTechnical>
          <DefaultBilling>
            <ContactId>0</ContactId>
          </DefaultBilling>
        </DefaultWhois>
        <DefaultNameServerSettings>
          <Type>Dynadot Parking</Type>
          <WithAds>yes</WithAds>
        </DefaultNameServerSettings>
      </DefaultSettings>
    </AccountInfo>
  </AccountInfoContent>
</AccountInfoResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=account_info

الطلب (صيغة JSON)
{
  "AccountInfoResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "AccountInfo": {
      "Username": "testname",
      "ForumName": "test forum name",
      "Contact": {
        "Organization": "",
        "Name": "testname test",
        "Email": "[email protected]",
        "PhoneCc": "1",
        "PhoneNum": "555.555.5233",
        "FaxCc": "",
        "FaxNum": "",
        "Address1": "1 test road",
        "Address2": "",
        "City": "Los Angeles",
        "State": "CA",
        "ZipCode": "90000",
        "Country": "US"
      },
      "CustomerSince": "1364888735253",
      "AccountLock": "on",
      "TotalSpending": "$0.00",
      "PriceLevel": "Regular Pricing",
      "AccountBalance": "$70.02",
      "CustomTimeZone": "PST",
      "DefaultSettings": {
        "DefaultWhois": {
          "DefaultRegistrant": {
            "ContactId": "0"
          },
          "DefaultAdmin": {
            "ContactId": "0"
          },
          "DefaultTechnical": {
            "ContactId": "0"
          },
          "DefaultBilling": {
            "ContactId": "0"
          }
        },
        "DefaultNameServerSettings": {
          "Type": "Dynadot Parking",
          "WithAds": "yes"
        }
      }
    }
  }
}
 

ضبط قائمة "من يكون" Whois افتراضية

عند القيام بأمر ضبط قائمة من يكون الافتراضية، يجب تضمين الثوابت التالية:

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

مثال على ضبط قائمة من يكون الافتراضية

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

الاستجابة (صيغة XML)
<SetDefaultWhoisResponse>
   <SetDefaultWhoisHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultWhoisHeader>
</SetDefaultWhoisResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_whois&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

الطلب (صيغة JSON)
{
   "SetDefaultWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط خوادم اسم افتراضية

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

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

مثال على ضبط خوادم الاسم الافتراضية

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetDefaultNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "SetDefaultNsContent":{
         "Servers":[
            {
               "ServerName":"ns1.hosts.com",
               "ServerId":"0"
            },
            {
               "ServerName":"ns2.host.com",
               "ServerId":"1"
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            }
         ]
      }
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_parking&folder_id=0&with_ads=no

الاستجابة (صيغة XML)
<SetDefaultParkingResponse>
   <SetDefaultParkingHeader>
      <SuccessCode>0</SuccessCode>
      <Status>success</Status>
   </SetDefaultParkingHeader>
</SetDefaultParkingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_parking&folder_id=0&with_ads=no

الطلب (صيغة JSON)
{
   "SetDefaultParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetDefaultForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط وضع التسلل الافتراضي

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

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

تعيين نموذج التخفي الافتراضي

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetDefaultStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط الاستضافة الافتراضية

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

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

مثال على ضبط الاستضافة الافتراضية

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_hosting&hosting_type=advanced

الاستجابة (صيغة XML)
<SetDefaultHostingResponse>
  <SetDefaultHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultHostingHeader>
</SetDefaultHostingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_hosting&hosting_type=advanced

الطلب (صيغة JSON)
{
   "SetDefaultHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط خادم اسم النطاق الافتراضي

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

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

معلمة طلب تعيين خادم أسماء النطاقات الافتراضي
الشرح
main_record_typeنوع السجل الرئيسي
main_recordتحديد سجل خادم أسماء نطاقات لنطاقك
main_txt (اختياري)حدد سجل نصي لنطاقك. إذا ما كان نوع سجلك الرئيسي هو aaaa وقمت بتحديد main_record2، فيمكنك ضبط 3 سجلات نصية رئيسية، وإلا يمكنك ضبط 4 سجلات نصية رئيسية.
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"

مثال على ضبط خادم اسم النطاق الافتراضي

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

الاستجابة (صيغة XML)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

الطلب (صيغة JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

الاستجابة (صيغة XML)
<SetDefaultDnsResponse>
  <SetDefaultDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetDefaultDnsHeader>
</SetDefaultDnsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

الطلب (صيغة JSON)
{
   "SetDefaultDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetDefaultEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_default_setting&service=nameservers

الاستجابة (صيغة XML)
<SetClearDefaultSettingResponse>
  <SetClearDefaultSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_clear_default_setting&service=nameservers

الطلب (صيغة JSON)
{
   "SetClearDefaultSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط خيار التجديد الافتراضي

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetDefaultRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=create_folder&folder_name=new

الاستجابة (صيغة XML)
<FolderCreateResponse>
  <FolderCreateHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </FolderCreateHeader>
  <FolderCreateContent>
    <FolderName>new</FolderName>
    <FolderId>1</FolderId>
  </FolderCreateContent>
</FolderCreateResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=create_folder&folder_name=new

الطلب (صيغة JSON)
{
   "FolderCreateResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "FolderCreateContent":{
         "FolderName":"new",
         "FolderId":"1"
      }
   }
}
 

أمر حذف مجلد

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

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

مثال على حذف مجلد

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "DeleteFolderResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

مثال على ضبط مجلد من يكون

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

الاستجابة (صيغة XML)
<SetFolderWhoisResponse>
  <SetFolderWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderWhoisHeader>
</SetFolderWhoisResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_whois&folder_id=0&registrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0

الطلب (صيغة JSON)
{
   "SetFolderWhoisResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر ضبط مجلد خوادم الاسم

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

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

مثال على ضبط مجلد خوادم الاسم

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)

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

الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "SetFolderNsResponse":{
      "ResponseCode":"0",
      "Status":"success",
      "SetFolderNsContent":{
         "Servers":[
            {
               "ServerName":"ns1.hosts.com",
               "ServerId":"0"
            },
            {
               "ServerName":"ns2.host.com",
               "ServerId":"1"
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            },
            {
               "ServerName":"",
               "ServerId":""
            }
         ]
      }
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_parking&folder_id=0&with_ads=no

الاستجابة (صيغة XML)
<SetFolderParkingResponse>
  <SetFolderParkingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderParkingHeader>
</SetFolderParkingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_parking&folder_id=0&with_ads=no

الطلب (صيغة JSON)
{
   "SetFolderParkingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetFolderForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetFolderStealthResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes

الاستجابة (صيغة XML)
<SetFolderHostingResponse>
  <SetFolderHostingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderHostingHeader>
</SetFolderHostingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes

الطلب (صيغة JSON)
{
   "SetFolderHostingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

معلمة طلب تعيين خادم أسماء النطاقات لمجلد
الشرح
folder_idهوية المجلد الذي تود تعيينه
main_record_typeنوع السجل الرئيسي
main_recordتحديد سجل خادم أسماء نطاقات لنطاقك
main_recordتحديد سجل خادم أسماء نطاقات لنطاقك
with_ads (اختياري)حدد سجل نصي لنطاقك. إذا ما كان نوع سجلك الرئيسي هو aaaa وقمت بتحديد main_record2، فيمكنك ضبط 3 سجلات نصية رئيسية، وإلا يمكنك ضبط 4 سجلات نصية رئيسية.
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 (اختياري)إذا أردت تطبيق اعدادات خادم أسماء النطاقات هذه على النطاقات المستقبلية التي تنقلها لهذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
sync (اختياري)إذا أردت مزامنة إعدادات خادم أسماء النطاقات هذه مع كل النطاقات داخل هذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
وسم XML بالنتيجة
الشرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetFolderDnsHeader></SetFolderDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

الاستجابة (صيغة XML)
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1

الطلب (صيغة JSON)
{
   "SetFolderDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

معلمة طلب تعيين مجلد DNS2
الشرح
folder_idهوية المجلد الذي تود تعيينه
main_record_type0 - main_record_type19يجب أن يكون نوع السجل الرئيسي إما "a" أو "aaaa" أو "cname" أو "إعادة توجيه" أو "txt" أو "mx" أو "التخفي" أو "البريد الإلكتروني"
main_record0 - main_record19عيّن سجل DNS لنطاقك
main_recordx0 - main_recordx19تكون مسافة Mx أو نوع إعادة التوجيه أو عنوان إعادة التوجيه الخفي أو البريد الإلكتروني المستعار ضرورية عندما يكون نوع_السجل_الرئيسي إما "إعادة التوجيه" أو "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 (اختياري)إذا أردت تطبيق اعدادات خادم أسماء النطاقات هذه على النطاقات المستقبلية التي تنقلها لهذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
sync (اختياري)إذا أردت مزامنة إعدادات خادم أسماء النطاقات هذه مع كل النطاقات داخل هذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
وسم XML بالنتيجة
الشرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetFolderDnsHeader></SetFolderDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

الاستجابة (صيغة XML)
<SetFolderDnsResponse>
  <SetFolderDnsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderDnsHeader>
</SetFolderDnsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1

الطلب (صيغة JSON)
{
   "SetFolderDnsResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
   "SetFolderEmailForwardingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_clear_folder_setting&folder_id=0&service=nameservers

الاستجابة (صيغة XML)
<SetClearFolderSettingResponse>
  <SetClearFolderSettingHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetClearFolderSettingHeader>
</SetClearFolderSettingResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_clear_folder_setting&folder_id=0&service=nameservers

الطلب (صيغة JSON)
{
   "SetClearFolderSettingResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_name&folder_id=0&folder_name=new

الاستجابة (صيغة XML)
<SetFolderNameResponse>
  <SetFolderNameHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderNameHeader>
</SetFolderNameResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=set_folder_name&folder_id=0&folder_name=new

الطلب (صيغة JSON)
{
   "SetFolderNameResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_renew_option&folder_id=0&renew_option=auto

الاستجابة (صيغة XML)
<SetFolderRenewOptionResponse>
  <SetFolderRenewOptionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "SetFolderRenewOptionResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<FolderListResponse>
  <FolderListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </FolderListHeader>
  <FolderListContent>
    <FolderList>
      <List>
        <Folder>
          <FolderId>0</FolderId>
          <FolderName>new</FolderName>
          <DefaultWhois>
            <DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
            <DefaultRegistrant>
              <ContactId>0</ContactId>
            </DefaultRegistrant>
            <DefaultAdmin>
              <ContactId>0</ContactId>
            </DefaultAdmin>
            <DefaultTechnical>
              <ContactId>0</ContactId>
            </DefaultTechnical>
            <DefaultBilling>
              <ContactId>0</ContactId>
            </DefaultBilling>
          </DefaultWhois>
          <DefaultNameServers>
            <DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
            <NameServerSettings>
              <Type>Dynadot Parking</Type>
              <WithAds>Yes</WithAds>
            </NameServerSettings>
          </DefaultNameServers>
          <DefaultRenewOption>
            <DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
            <RenewOption>no renew option</RenewOption>
          </DefaultRenewOption>
          <DefaultTransferLock>
            <DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
            <LockStatus>locked</LockStatus>
          </DefaultTransferLock>
        </Folder>
      </List>
    </FolderList>
  </FolderListContent>
</FolderListResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=folder_list

الطلب (صيغة JSON)
{
  "FolderListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "FolderList": [
      {
        "FolderId": "0",
        "FolderName": "new",
        "DefaultWhois": {
          "DefaultWhoisEnableStatus": "disable",
          "DefaultRegistrant": {
            "ContactId": "0"
          },
          "DefaultAdmin": {
            "ContactId": "0"
          },
          "DefaultTechnical": {
            "ContactId": "0"
          },
          "DefaultBilling": {
            "ContactId": "0"
          }
        },
        "DefaultNameServers": {
          "DefaultTransferLockEnableStatus": "disable",
          "NameServerSettings": {
            "Type": "Dynadot Parking",
            "WithAds": "Yes"
          }
        },
        "DefaultRenewOption": {
          "DefaultRenewOptionEnableStatus": "disable",
          "RenewOption": "no renew option"
        },
        "DefaultTransferLock": {
          "DefaultTransferLockEnableStatus": "disable",
          "LockStatus": "locked"
        }
      }
    ]
  }
}
 

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

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

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

مثال على طلب إضافة حجز نطاق

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=mykey&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org

الاستجابة (صيغة XML)
<AddBackorderRequestResponse>
  <AddBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddBackorderRequestHeader>
</AddBackorderRequestResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=mykey&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org

الطلب (صيغة JSON)
{
   "AddBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

أمر حذف طلب حجز نطاق مستخدم حاليا

عند استدعاء أمر طلب إلغاء حجز نطاق مستخدم حاليا، ينبغي استخدام المعلمات التالية:

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<DeleteBackorderRequestResponse>
  <DeleteBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "DeleteBackorderRequestResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

معلمة طلب قائمة طلبات حجز النطاقات المستخدمة حاليا
الشرح
startDateبدء الموعد الأخير الذي تود طلبه، بصيغة يوم-شهر-سنة مثل: 05-05-2015
endDateإنتهاءالموعد الأخير الذي تود طلبه، بصيغة يوم-شهر-سنة مثل: 05-05-2015
وسم 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>التاريخ النهائي للإلغاء بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 ،1970 من شهر يناير بتوقيت جرينتش)
<BackorderRequestStatus></BackorderRequestStatus>وضع عملية إنتهاء التسجيل

مثال على طلب قائمة حذف النطاق

الطلب (صيغة XML)

http://api.dynadot.com/api3.xml?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<BackorderRequestListResponse>
  <BackorderRequestListHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </BackorderRequestListHeader>
  <BackorderRequestListContent>
    <BackorderRequestList>
      <BackorderRequest>
        <DomainName>testdrop.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop3.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop4.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
      <BackorderRequest>
        <DomainName>testdrop5.com</DomainName>
        <CutoffTime>1403914140000</CutoffTime>
        <BackorderRequestStatus>Active</BackorderRequestStatus>
      </BackorderRequest>
    </BackorderRequestList>
  </BackorderRequestListContent>
</BackorderRequestListResponse>
الطلب (صيغة CSV)

http://api.dynadot.com/api3.html?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20

الطلب (صيغة CSV)
ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
الطلب (صيغة JSON)

http://api.dynadot.com/api3.json?key=1&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20

الطلب (صيغة JSON)
{
  "BackorderRequestListResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "BackorderRequestList": [
      {
        "DomainName": "testdrop.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop3.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop4.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      },
      {
        "DomainName": "testdrop5.com",
        "CutoffTime": "1403914140000",
        "BackorderRequestStatus": "Active"
      }
    ]
  }
}
 

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

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

معلمة طلب جلب المزادات المفتوحة
الشرح
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny", والعملة الافتراضية هي الدولار الأمريكي
typeيجب أن يكون نوع المزاد الذي ترغب بعرضه "expired", "user", أو "backorder", وإذا ما رغبت في الحصول على أكثر من نوع واحد من المزادات، يمكنك استخدام "،" للفصل بين أنواع المزادات
وسم 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>تاريخ انتهاء المزاد بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 من شهر يناير عام 1970 بتوقيت جرينتش)
<Revenue></Revenue>عائد المزاد
<RevenueCurrency></RevenueCurrency>عملة العائد
<Visitors></Visitors>زائرو النطاق
<Links></Links>الروابط الواردة الخاصة بالنطاق
<Age></Age>عمر النطاق

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<GetOpenAuctionsResponse>
  <GetOpenAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenAuctionsHeader>
  <GetOpenAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
            <Revenue>72</Revenue>
            <RevenueCurrency>USD</RevenueCurrency>
            <Visitors>-1</Visitors>
            <Links>-1</Links>
            <Age>1</Age>
    </Auction>
    .
    .
    .
  </GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
الطلب (بصيغة csv)

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

الاستجابة

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

الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
    "status": "success",
    "auction_list": [
        {
            "auction_id": 11,
            "domain": "domain.com",
            "utf_name": "domain.com",
            "is_idn": false,
            "auction_type": "expired",
            "currency": "USD",
            "current_bid_price": "124.00",
            "bids": 4,
            "bidders": 2,
            "time_left": "1 day, 23 hours",
            "start_time": "2022/03/28 02:20 PST",
            "start_time_stamp": 1648459234033,
            "end_time": "2022/04/04 02:20 PST",
            "end_time_stamp": 1649064034033,
            "visitors": 223,
            "links": "-",
            "age": 0,
            "estibot_appraisal": "-"
        },
        {
            "auction_id": 12,
            "domain": "domain0.com",
            "utf_name": "domain0.com",
            "is_idn": false,
            "auction_type": "expired",
            "currency": "USD",
            "current_bid_price": "44.99",
            "bids": 1,
            "bidders": 1,
            "time_left": "2 days, 23 hours",
            "start_time": "2022/03/29 02:20 PST",
            "start_time_stamp": 1648545634049,
            "end_time": "2022/04/05 02:20 PST",
            "end_time_stamp": 1649150434049,
            "visitors": 245,
            "links": "-",
            "age": 0,
            "estibot_appraisal": "-"
        }
        ...
    ]
}
 

أمر جلب تفاصيل مزاد

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

معلمة طلب جلب تفاصيل مزاد
الشرح
domainيجب أن يستخدم اسم النطاق للمزاد IDN (اسم النطاق المدوَّل) رمز Punycode، مثل "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>مزايدة البروكسي الخاصة بك للمزاد المحدد. إذا لم تقم بالمزايدة فستكون النتيجة '-1'
<AuctionId></AuctionId>هوية المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزاد
<Bids></Bids>عدد المزايدات في المزاد
<EndTime></EndTime>وقت إنتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 من شهر يناير عام 1970 بتوقيت جرينتش)
<IsPremium></IsPremium>سواء كانت نطاقًا مميزًا
<RenewalPrice></RenewalPrice>سعر التجديد

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetAuctionDetailsResponse>
  <GetAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAuctionDetailsHeader>
  <GetAuctionDetailsContent>
    <Auction>
      <AuctionStatusId>0</AuctionStatusId>
      <AuctionStatus>1</AuctionStatus>
      <AuctionId>0</AuctionId>
      <Domain>test.biz</Domain>
      <BidPrice>46.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>1970/01/01 00:00 UTC</EndTime>
      <EndTimestamp>0</EndTimestamp>
      <Revenue>1</Revenue>
      <RevenueCurrency>USD</RevenueCurrency>
      <Visitors>-1</Visitors>
      <Links>1</Links>
      <Age>10</Age>
      <isPremium>false</isPremium>
      <RenewalPrice>-0.1</RenewalPrice>
      <UserIsHighBid>false</UserIsHighBid>
      <YourCurrentBid>-1</YourCurrentBid>
      <YourProxyBid>-1</YourProxyBid>
    </Auction>
  </GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com&currency=usd

الطلب (صيغة JSON)
{
  "status": "success",
  "size": 1,
  "auction_details": [
    {
      "auction_json": {
        "auction_id": 0,
        "domain": "test.biz",
        "utf_name": "test.biz",
        "is_idn": false,
        "auction_type": "expired",
        "current_bid_price": "46.99",
        "accepted_bid_price": "46.99",
        "currency": "USD",
        "is_high_bidder": false,
        "bids": 0,
        "bidders": 0,
        "auction_status_id": 0,
        "time_left": "1",
        "start_time": "1",
        "start_time_stamp": 0,
        "end_time": "",
        "end_time_stamp": 0,
        "revenue": "1",
        "visitors": -1,
        "links": "1",
        "age": 10,
        "estibot_appraisal": "",
        "bidder_name": "",
        "bid_price": "",
        "timestamp": 0,
        "bid_status": "",
        "is_proxy_auto_bid": false,
        "auction_ended": false,
        "customer_bided": false,
        "customer_bid": "1",
        "customer_proxy_bid": "1",
        "is_premium": false,
        "renewal_price": "-0.1"
      },
      "bid_history": []
    }
  ]
}
 

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

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

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

نطاق كمثال

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<PlaceAuctionBidResponse>
  <PlaceAuctionBidHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
الطلب (بصيغة csv)

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

الاستجابة

ok,success

الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
    "status": "success",
    "auction_details": {
        "auction_json": {
            "auction_id": 12,
            "domain": "example.com",
            "utf_name": "example.com",
            "is_idn": false,
            "auction_type": "expired",
            "current_bid_price": "44.99",
            "accepted_bid_price": "45.99",
            "currency": "USD",
            "is_high_bidder": true,
            "bids": 3,
            "bidders": 2,
            "time_left": "2 days, 22 hours",
            "start_time": "2022/03/29 02:20 PST",
            "start_time_stamp": 1648545634049,
            "end_time": "2022/04/05 02:20 PST",
            "end_time_stamp": 1649150434049,
            "revenue": "$26.50",
            "visitors": 245,
            "links": "-",
            "age": 0,
            "estibot_appraisal": "-",
            "auction_ended": false,
            "customer_bided": true,
            "customer_bid": "44.99",
            "customer_proxy_bid": "$121.00"
        },
        "bid_history": [
            {
                "bidder_name": "You",
                "bid_price": "44.99",
                "currency": "USD",
                "timestamp": 1648892255084,
                "bid_status": "High Bidder",
                "is_proxy_auto_bid": false
            }
            ...        ]
    }
}
 

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

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

معلمة طلب جلب المزادات المغلقة
الشرح
startDateتاريخ بدء المزاد، يوم-شهر-سنة، مثل 05-05-2015
endDateتاريخ إنتهاءالمزاد، يوم-شهر-سنة، مثل 05-05-2015
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny",والعملة الافتراضية هي الدولار الأمريكي
وسم XML بالنتيجة
الشرح
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>وسم استجابة جلب المزادات المغلقة، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>الحصول على العنوان الرئيسي للمزادات المغلقة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>الكلمة المفتاحية للحصول على محتوى تفاصيل المزادات المغلقة، ويمكن استخدامها فقط عندما يكون الوضع "success"
<Auction></Auction>كلمة مفتاحية لعنصر في المزاد، وتستخدم فقط إذا كان الوضع هو "success"
<AuctionId></AuctionId>هوية المزاد
<Domain></Domain>اسم نطاق المزاد
<AuctionStatusId></AuctionStatusId>وضع هوية المزاد، '0' في حالة كونه قيد الحدوث و '1' للمزاد المغلق من قبل المستخدم، و '2' للمزاد المغلق من المشرف، و '3' للمزاد المغلق للتجديد، و '4' المغلق بسبب انتهاء الوقت، و '5' للمزاد المغلق بسبب النقل.
<AuctionStatus></AuctionStatus>وضع المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزاد
<Bids></Bids>عدد المزايدات في المزاد
<AuctionWonStatus></AuctionWonStatus>إذا فاز المستخدم بالمزاد
<YourHighBid></YourHighBid>عرض سعرك العالي لهذا المزاد
<YourProxyBid></YourProxyBid>مزايدة البروكسي الخاص بك في هذا المزاد

مثال لجلب المزادات المغلقة

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedAuctionsResponse>
  <GetClosedAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedAuctionsContent>
    <Auction>
      <AuctionId>2</AuctionId>
      <Domain>testdomain1.test</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
    <Auction>
      <AuctionId>3</AuctionId>
      <Domain>testdomain2.test</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
    </Auction>
  </GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
الطلب (صيغة CSV)

https://api.dynadot.com/api3.html?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15

الطلب (صيغة CSV)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=1&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15

الطلب (صيغة JSON)
{
  "GetClosedAuctionsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Auctions": [
      {
        "AuctionId": "2",
        "Domain": "testdomain1.test",
        "AuctionStatusId": "4",
        "AuctionStatus": "Closed by Timeout",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "AuctionWonStatus": "won",
        "YourHighBid": "89.99",
        "YourProxyBid": "1000.0"
      },
      {
        "AuctionId": "3",
        "Domain": "testdomain2.test",
        "AuctionStatusId": "4",
        "AuctionStatus": "Closed by Timeout",
        "BidPrice": "28.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "AuctionWonStatus": "won",
        "YourHighBid": "28.99",
        "YourProxyBid": "1000.0"
      }
    ]
  }
}
 

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

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<GetOpenBackorderAuctionsResponse>
  <GetOpenBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetOpenBackorderAuctionsHeader>
  <GetOpenBackorderAuctionsContent>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    <Auction>
           <AuctionId>0</AuctionId>
            <Domain>domain.com</Domain>
            <BidPrice>63.99</BidPrice>
            <BidPriceCurrency>USD</BidPriceCurrency>
            <Bids>0</Bids>
            <EndTime>2015/04/28 05:46 UTC</EndTime>
            <EndTimestamp>1430199960354</EndTimestamp>
    </Auction>
    .
    .
    .
  </GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
الطلب (بصيغة csv)

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

الاستجابة

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

 

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

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

معلمة طلب جلب تفاصيل مزاد
الشرح
domainاسم النطاق لمزاد حجز مسبق، IDN (اسم النطاق الدولي) يجب أن يستخدم البنيكود، مثل "xn--wkccg.com"
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny", والعملة الافتراضية هي الدولار الأمريكي
وسم XML بالنتيجة
الشرح
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>وسم استجابة جلب تفاصيل المزاد، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>احصل على العنوان الرئيسي لتفاصيل المزاد
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>الكلمة المفتاحية للحصول على محتوى تفاصيل المزاد، ويمكن استخدامها فقط عندما يكون الوضع "success"
<AuctionStatusId></AuctionStatusId>وضع هوية المزاد، '0' في حالة كونه قيد الحدوث و '1' للمزاد المغلق من قبل المستخدم، و '2' للمزاد المغلق من المشرف، و '3' للمزاد المغلق للتجديد، و '4' المغلق بسبب انتهاء الوقت، و '5' للمزاد المغلق بسبب النقل.
<AuctionStatus></AuctionStatus>وضع المزاد
<AuctionId></AuctionId>هوية المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزاد
<Bids></Bids>عدد المزايدات في المزاد
<EndTime></EndTime>وقت إنتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 من شهر يناير عام 1970 بتوقيت جرينتش)
<Revenue></Revenue>عائد المزاد
<RevenueCurrency></RevenueCurrency>عملة العائد
<Visitors></Visitors>زائرو النطاق
<Links></Links>الروابط الواردة الخاصة بالنطاق
<Age></Age>عمر النطاق
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم صاحب أعلى مزايدة
<YourCurrentBid></YourCurrentBid>سعر المزايدة الحالي الخاص بك للمزاد المحدد. إذا لم تقم بالمزايدة فستكون النتيجة هي '-1'
<YourProxyBid></YourProxyBid>مزايدة البروكسي الخاصة بك للمزاد المحدد. إذا لم تقم بالمزايدة فستكون النتيجة '-1'

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetBackorderAuctionDetailsResponse>
  <GetBackorderAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetBackorderAuctionDetailsHeader>
  <GetBackorderAuctionDetailsContent>
    <AuctionStatusId>0</AuctionStatusId>
    <AuctionStatus>In Progress</AuctionStatus>
    <UserIsHighBid>no</UserIsHighBid>
    <YourCurrentBid>-1</YourCurrentBid>
    <YourProxyBid>-1</YourProxyBid>
    <Auction>
      <AuctionId>10001</AuctionId>
      <Domain>example.com</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>0</Bids>
      <EndTime>2015/04/28 18:16 UTC</EndTime>
      <EndTimestamp>1430244969779</EndTimestamp>
    </Auction>
  </GetBackorderAuctionDetailsContent>
</GetBackorderAuctionDetailsResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
  "GetBackorderAuctionDetailsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "GetBackorderAuctionDetails": {
      "AuctionStatusId": "0",
      "AuctionStatus": "In Progress",
      "UserIsHighBid": "no",
      "YourCurrentBid": "-1",
      "YourProxyBid": "-1",
      "Auction": {
        "AuctionId": "10001",
        "Domain": "example.com",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "0",
        "EndTime": "2015/04/28 18:16 UTC",
        "EndTimestamp": "1430244969779"
      }
    }
  }
}
 

أمر المزايدة في مزاد حجز مسبق

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

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

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<PlaceBakcorderAuctionBidResponse>
 <PlaceBackorderAuctionBidHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
الطلب (صيغة CSV)

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

الطلب (صيغة CSV)
ok,success
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "PlaceBakcorderAuctionBidResponse":{
      "ResponseCode":"0",
      "Status":"success"
   }
}
 

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

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

عامل طلب الحصول على مزادات حجز النطاقات المغلقة
الشرح
startDateتاريخ بدء المزاد، يوم-شهر-سنة، مثل 05-05-2015
endDateتاريخ إنتهاءالمزاد، يوم-شهر-سنة، مثل 05-05-2015
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny",والعملة الافتراضية هي الدولار الأمريكي
وسم XML بالنتيجة
الشرح
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>وسم استجابة جلب المزادات المغلقة، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>الحصول على العنوان الرئيسي للمزادات المغلقة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>الكلمة المفتاحية للحصول على محتوى تفاصيل المزادات المغلقة، ويمكن استخدامها فقط عندما يكون الوضع "success"
<Auction></Auction>كلمة مفتاحية لعنصر في المزاد، وتستخدم فقط إذا كان الوضع هو "success"
<YourHighBid></YourHighBid>عرض سعرك العالي لهذا المزاد
<YourProxyBid></YourProxyBid>مزايدة البروكسي الخاص بك في هذا المزاد
<AuctionId></AuctionId>هوية المزاد
<Domain></Domain>اسم نطاق المزاد
<AuctionStatusId></AuctionStatusId>وضع هوية المزاد، '0' في حالة كونه قيد الحدوث و '1' للمزاد المغلق من قبل المستخدم، و '2' للمزاد المغلق من المشرف، و '3' للمزاد المغلق للتجديد، و '4' المغلق بسبب انتهاء الوقت، و '5' للمزاد المغلق بسبب النقل.
<AuctionStatus></AuctionStatus>وضع المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزاد
<Bids></Bids>عدد المزايدات في المزاد

احصل على مثال عن مزادات الحجز المسبق المغلقة

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedBackorderAuctionsResponse>
  <GetClosedBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedBackorderAuctionsHeader>
  <GetClosedBackorderAuctionsContent>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>2</AuctionId>
      <Domain>testdomain1.test</Domain>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <EndTime>2022/04/04 02:20:34 PST</EndTime>
      <EndTimestamp>1649064034033</EndTimestamp>
    </Auction>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>3</AuctionId>
      <Domain>testdomain2.test</Domain>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
      <EndTime>2022/04/05 02:20:34 PST</EndTime>
      <EndTimestamp>1649150434049</EndTimestamp>
    </Auction>
  </GetClosedBackorderAuctionsContent>
</GetClosedBackorderAuctionsResponse>
الطلب (صيغة CSV)

https://api.dynadot.com/api3.html?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15

الطلب (صيغة CSV)
ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=1&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15

الطلب (صيغة JSON)
{
  "GetClosedBackorderAuctionsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Auctions": [
      {
        "AuctionWonStatus": "won",
        "YourHighBid": "89.99",
        "YourProxyBid": "1000.0",
        "AuctionId": "2",
        "Domain": "testdomain1.test",
        "BidPrice": "89.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "EndTime": "2022/04/04 02:20:34 PST",
        "EndTimestamp": "1649064034033"
      },
      {
        "AuctionWonStatus": "won",
        "YourHighBid": "28.99",
        "YourProxyBid": "1000.0",
        "AuctionId": "3",
        "Domain": "testdomain2.test",
        "BidPrice": "28.99",
        "BidPriceCurrency": "USD",
        "Bids": "1",
        "EndTime": "2022/04/05 02:20:34 PST",
        "EndTimestamp": "1649150434049"
      }
    ]
  }
}
 

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

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

احصل على معيار طلب عروض المزاد
الشرح
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny",والعملة الافتراضية هي الدولار الأمريكي
وسم XML بالنتيجة
الشرح
<GetAuctionBidsResponse></GetAuctionBidsResponse>علامة الحصول على استجابة عروض المزاد، وهو العقدة الجذرية لمستند XML الاستجابة
<GetAuctionBidsHeader></GetAuctionBidsHeader>احصل على عنوان عروض المزاد
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetAuctionBidsContent></GetAuctionBidsContent>علامة الحصول على محتوى عروض المزاد، والذي يستخدم فقط عندما تكون الحالة "success"
<BidList></BidList> قائمة العروض
<Bid></Bid> بند المزايدة
<BidId></BidId> معرِّف العرض
<AuctionId></AuctionId>هوية المزاد
<AccountId></AccountId>معرِّف الحساب
<Domain></Domain>اسم نطاق المزاد
<DomainUtf></DomainUtf>اسم utf النطاق للمزاد
<AuctionType></AuctionType>نوع المزاد
<IsIdn></IsIdn>إذا كان هذا النطاق اسم نطاق مدوَّل
<CurrentBid></CurrentBid>سعر العرض الحالي للمزاد
<YourStatus></YourStatus>حالة العرض للمزاد لديك
<ProxyBid></ProxyBid>سعر عرض الوكالة للمزاد لديك
<ActiveBidders></ActiveBidders>عدد مقدمي العروض الذين يشاركون في هذا المزاد
<TimeLeft></TimeLeft>الوقت المتبقي للمزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>الطابع الزمني لنهاية المزاد

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

الطلب (صيغة XML)

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

الاستجابة (صيغة XML)
<GetAuctionBidsResponse>
    <GetAuctionBidsHeader>
        <SuccessCode>0</SuccessCode>
        <Status>success</Status>
    </GetAuctionBidsHeader>
    <GetAuctionBidsContent>
        <BidList>
            <Bid>
                <BidId>0</BidId>
                <AuctionId>11</AuctionId>
                <AccountId>1</AccountId>
                <Domain>domain.com</Domain>
                <DomainUtf>domain.com</DomainUtf>
                <AuctionType>expired</AuctionType>
                <IsIdn>false</IsIdn>
                <CurrentBid>$124.00</CurrentBid>
                <YourStatus>Out Bid</YourStatus>
                <ProxyBid>$119.00</ProxyBid>
                <ActiveBidders>2</ActiveBidders>
                <TimeLeft>1 day, 6 hours</TimeLeft>
                <EndTime>2022/04/04 02:20:34 PST</EndTime>
                <EndTimestamp>1649064034033</EndTimestamp>
            </Bid>
            <Bid>
                <BidId>9</BidId>
                <AuctionId>12</AuctionId>
                <AccountId>1</AccountId>
                <Domain>domain0.com</Domain>
                <DomainUtf>domain0.com</DomainUtf>
                <AuctionType>expired</AuctionType>
                <IsIdn>false</IsIdn>
                <CurrentBid>$44.99</CurrentBid>
                <YourStatus>High Bidder</YourStatus>
                <ProxyBid>$121.00</ProxyBid>
                <ActiveBidders>1</ActiveBidders>
                <TimeLeft>2 days, 6 hours</TimeLeft>
                <EndTime>2022/04/05 02:20:34 PST</EndTime>
                <EndTimestamp>1649150434049</EndTimestamp>
            </Bid>
        </BidList>
    </GetAuctionBidsContent>
</GetAuctionBidsResponse>
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
    "status": "success",
    "auction_bids": [
        {
            "bid_id": 0,
            "auction_id": 11,
            "account_id": "1",
            "domain": "domain.com",
            "domain_utf": "domain.com",
            "auction_type": "expired",
            "is_idn": false,
            "current_bid": "$44.99",
            "your_status": "High Bidder",
            "proxy_bid": "$119.00",
            "active_bidders": 1,
            "time_left": "1 day, 23 hours",
            "end_time": "2022/04/04 02:20:34 PST",
            "end_time_stamp": 1649064034033
        },
        {
            "bid_id": 2,
            "auction_id": 12,
            "account_id": "1",
            "domain": "domain0.com",
            "domain_utf": "domain0.com",
            "auction_type": "expired",
            "is_idn": false,
            "current_bid": "$44.99",
            "your_status": "High Bidder",
            "proxy_bid": "$119.00",
            "active_bidders": 1,
            "time_left": "2 days, 23 hours",
            "end_time": "2022/04/05 02:20:34 PST",
            "end_time_stamp": 1649150434049
        }
        ...
    ]
}
 

أمر تجهيز البيانات

إن استدعاء أمر تجهيز البيانات سيخبرك إذا ما كان تقديم طلب جديد سيتم بصورة آمنة

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

مثال على تجهيز البيانات

الطلب (صيغة XML)

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

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

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

الطلب (صيغة CSV)
ok,yes
الطلب (صيغة JSON)

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

الطلب (صيغة JSON)
{
   "Response":{
      "ResponseCode":"0",
      "ResponseMsg":"no"
   }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
  <GetExpiredCloseoutDomainsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetExpiredCloseoutDomainsHeader>
  <GetExpiredCloseoutDomainsContent>
    <CloseoutItem>
      <DomainName>test.biz</DomainName>
      <DomainNameUtf>test.biz</DomainNameUtf>
      <CurrentPrice>9.91</CurrentPrice>
      <IsIDN>false</IsIDN>
      <EndTimeStamp>0</EndTimeStamp>
      <RenewalPrice>9.99</RenewalPrice>
      <ExpiredRevenue>9.90</ExpiredRevenue>
      <EstibotAppraisal>1223</EstibotAppraisal>
      <InboundLinks>-1</InboundLinks>
      <MonthlyVisitors>-1</MonthlyVisitors>
      <Currency>usd</Currency>
    </CloseoutItem>
  </GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd

الطلب (صيغة JSON)
{
  "GetExpiredCloseoutDomainsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "Size": 1,
    "CloseoutDomains": [
      {
        "closeoutItem": {
          "domainName": "test.biz",
          "domainNameUtf": "test.biz",
          "currentPrice": "9.91",
          "isIdn": false,
          "endTimeStamp": 0,
          "renewalPrice": "9.99",
          "expiredRevenue": "9.90",
          "estibotAppraisal": "1223",
          "inboundLinks": -1,
          "monthlyVisitors": -1,
          "currency": "usd"
        }
      }
    ]
  }
}
 

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

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

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

شراء نطاق مخفض منتهي الصلاحية (مثال)

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
  <BuyExpiredCloseoutDomainHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com

الطلب (صيغة JSON)
{
  "BuyExpiredCloseoutDomainResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

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

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

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

تعيين مثال عملية تأكيد Afternic

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetAfternicConfirmActionResponse>
  <SetAfternicConfirmActionHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetAfternicConfirmActionHeader>
</SetAfternicConfirmActionResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic

الطلب (صيغة JSON)
{
  "SetAfternicConfirmActionResponse": {
    "ResponseCode": "0",
    "Status": "success"
  }
}
 

أمر إعداد DNSSEC للنطاق

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

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

الخيار 1: domainName، keyTag، digestType، digest، Algorithm

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

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

تعيين معامل طلب Dnssec للنطاق
الشرح
domainNameاسم النطاق الذي تحتاج إلى إعداد dnssec له
keyTagعلامة مفتاح
digestTypeيمكنك اختيار رقم من القائمة التالية لتمثيل نوع توقيعك الإلكتروني: SHA-1(1) SHA-256(2) GOSTR 34.11-94 (3) SHA-384(4)
digestDigest.
Algorithmيمكنك اختيار رقم من القائمة التالية لتمثيل خوارزمية التوقيع الرقمي الخاصة بك: RSA/MD5(1) Diffie-Hellman (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 Curve P-256 مع SHA-256(13 ECDSA Curve P-384 مع SHA-384(14) ED25519(15 ED448(16) غير مباشر (252) DNS الخاص (253 OID الخاص (254)
flagsيمكنك اختيار رقم من القائمة التالية لتمثيل رمز التوقيع الرقمي الخاص بك: ZSK (256) KSK (257)
publicKeyيجب أن يكون المفتاح العام في الترميز base64.
وسم XML بالنتيجة
الشرح
<SetDomainDnssecResponse></SetDomainDnssecResponse>العقدة الجذرية للإجابة
<SetDomainDnssecHeader></SetDomainDnssecHeader>تعيين رأس DNSSEC للنطاق
<ResponseCode></ResponseCode>إذا نجحت العملية ، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب ، يتم استخدامها فقط عندما يكون الحالة "خطأ"

مثال على إعدادات DNSSEC للنطاق

الطلب (صيغة XML)

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

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

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

الطلب (صيغة JSON)
{
  "SetDomainDnssecResponse": {
    "ResponseCode": 0,
    "Status": "success"
  }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=0&command=get_whois_stats&domainName=domain1.com&dateType=Last 7 days

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetWhoisStatsResponse>
  <GetWhoisStatsHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetWhoisStatsHeader>
  <GetWhoisStatsContent>
    <WhoisStats>
      <WhoisStat>
        <Date>2023-11-04</Date>
        <Count>200</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-05</Date>
        <Count>300</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-06</Date>
        <Count>100</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-07</Date>
        <Count>200</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-08</Date>
        <Count>300</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-09</Date>
        <Count>100</Count>
      </WhoisStat>
      <WhoisStat>
        <Date>2023-11-10</Date>
        <Count>200</Count>
      </WhoisStat>
    </WhoisStats>
  </GetWhoisStatsContent>
</GetWhoisStatsResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=0&command=get_whois_stats&domainName=domain1.com&dateType=Last 7 days

الطلب (صيغة JSON)
{
  "GetWhoisStatsResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "WhoisStats": [
      {
        "Date": "2023-11-04",
        "Count": 200
      },
      {
        "Date": "2023-11-05",
        "Count": 300
      },
      {
        "Date": "2023-11-06",
        "Count": 100
      },
      {
        "Date": "2023-11-07",
        "Count": 200
      },
      {
        "Date": "2023-11-08",
        "Count": 300
      },
      {
        "Date": "2023-11-09",
        "Count": 100
      },
      {
        "Date": "2023-11-10",
        "Count": 200
      }
    ]
  }
}
 

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

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

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

مثال على حالة الطلب

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetOrderStatusResponse>
  <GetOrderStatusHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetOrderStatusHeader>
  <GetOrderStatusContent>
    <OrderId>0</OrderId>
    <OrderStatus>Completed</OrderStatus>
    <Item>
      <ItemTypeName>domain transfer away</ItemTypeName>
      <ItemName>&amp;</ItemName>
      <ItemStatus>transfer.com</ItemStatus>
    </Item>
    <Item>
      <ItemTypeName>domain</ItemTypeName>
      <ItemName>&amp;</ItemName>
      <ItemStatus>register.com</ItemStatus>
    </Item>
  </GetOrderStatusContent>
</GetOrderStatusResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0

الطلب (صيغة JSON)
{
  "GetOrderStatusResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "OrderStatus": {
      "OrderId": 0,
      "OrderStatus": "Completed",
      "ItemList": [
        {
          "ItemTypeName": "domain transfer away",
          "ItemName": "transfer.com",
          "ItemStatus": "Completed"
        },
        {
          "ItemTypeName": "domain",
          "ItemName": "register.com",
          "ItemStatus": "Completed"
        }
      ]
    }
  }
}
 

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

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

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

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

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=0&command=get_domain_push_request

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<GetDomainPushRequestResponse>
  <GetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </GetDomainPushRequestHeader>
  <GetDomainPushRequestContent>
    <PushDomain>
      <PushDomainName>haha.com</PushDomainName>
    </PushDomain>
    <PushDomain>
      <PushDomainName>haha1.com</PushDomainName>
    </PushDomain>
  </GetDomainPushRequestContent>
</GetDomainPushRequestResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.xml?key=0&command=get_domain_push_request

الطلب (صيغة JSON)
{
  "GetDomainPushRequestResponse": {
    "ResponseCode": 0,
    "Status": "success",
    "pushDomainName": "[haha.com,haha1.com]"
  }
}
 

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

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

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

مثال على طلب دفع المجال

الطلب (صيغة XML)

https://api.dynadot.com/api3.xml?key=0&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept

الاستجابة (صيغة XML)
<?xml version="1.0" encoding="UTF-8"?>
<SetDomainPushRequestResponse>
  <SetDomainPushRequestHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </SetDomainPushRequestHeader>
  <SetDomainPushRequestContent/>
</SetDomainPushRequestResponse>
الطلب (صيغة JSON)

https://api.dynadot.com/api3.xml?key=0&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept

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