API المتقدمة للنطاقات

Advanced Domain API from Dynadot - Manage Domains with Your Own Software

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

هل تبحث عن طريقة أكثر بساطة لاستخدام واجهة برمجة التطبيقات؟ اطلع على صفحة واجهة برمجة تطبيقات النطاقات!

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

Requests to our Advanced Domain API are sent to the following URL:

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

يرجى مراعاة ضرورة إرسال الطلبات عبر https (مأخذ توصيل آمن) لغرض الأمان. لا يمكن معالجة أكثر من 1 طلب/طلبات في نفس الوقت، لذا يرجى الانتظار حتى ينتهي الطلب الحالي قبل إرسال آخر. ينبغي أن يضم الطلب المعلمات التالية:

Request Parameter
الشرح
Keyمفتاحك للوصول إلى 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

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

Our Advanced Domain API will return results in an XML format. The response you receive should contain 2 or 3 of the following fields:

وسم 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 (اختياري)The registrant contact you want to use on the domain
admin_contact (اختياري)The admin contact you want to use on the domain
technical_contact (اختياري)The technical contact you want to use on the domain
billing_contact (اختياري)The billing contact you want to use on the domain
option0 ( إذا لزم الأمر )
اسم مسجل .AT, .BE,
option1 ( إذا لزم الأمر )The .AT, .BE, registrant organization (optional)
يمكنك تحديد 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_usernamePush Username of receiver account
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"
   }
}
 

Bulk Register Command

Calling the bulk register command will create and process registration orders. You must have enough account balance to pay for the orders. If calling the bulk register command, the following parameters should be included:

Bulk Register Request Parameter
الشرح
domain0-domain99The domain name(s) you want to register, maximum 100 domains can be registered per request
premium (اختياري)إذا رغبت في تسجيل نطاق مميز، اضبطه مساوياً لـ"1" (اختياري)
currency (اختياري)You can decide the currency type and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on. If you missed this parameter,we will use the account default currency
coupon (اختياري)رمز القسيمة التي تريد تقديمها ضمن هذا الأمر
وسم XML بالنتيجة
الشرح
<BulkRegisterResponse></BulkRegisterResponse>Tag of bulk register response
<BulkRegisterHeader></BulkRegisterHeader>Tag of bulk register header
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<BulkRegisterContent></BulkRegisterContent>The tag of bulk register content
<Expiration></Expiration>تاريخ انتهاء الصلاحية بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المتفق عليه UTC)، لا يستخدم سوى عندما تكون النتيجة "success"
<Result></Result>The result of the register action
<Message></Message>Error message of register action, only used when result is "error"

Bulk Register Example

الطلب (صيغة 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"
      }
    ]
  }
}
 

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

This command is only available in XML and JSON format:

معلمة طلب معلومات النطاق
الشرح
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 (اختياري)if you want to append the new DNS settings to existing Dns settings. Set it equal to "1" (optional)
وسم 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يجب أن يكون نوع السجل الرئيسي إما "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 (اختياري)if you want to append the new DNS settings to existing Dns settings. Set it equal to "1" (optional)
وسم 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.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

الطلب (صيغة 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"
   }
}
 

Set Customer Id Command (RESELLER ONLY)

If calling set customer id command, the following parameters should be included:

Set Customer Id Request Parameter
الشرح
domainThe domain you want to set, multiple domains are separated by commas (Max:100)
customer_idCustomer id you want to set to the domain, can't be null
وسم XML بالنتيجة
الشرح
<SetCustomerIdResponse></SetCustomerIdResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetCustomerIdHeader></SetCustomerIdHeader>رأس الاستجابة
<SetCustomerIdContent></SetCustomerIdContent>محتوى الاستجابة
<SetCustomerIdSuccess></SetCustomerIdSuccess>Set customer id success response content
<SetCustomerIdFailed></SetCustomerIdFailed>Set customer id failed response content
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure, "1" for problem
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

Set Customer Id Example

الطلب (صيغة 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

This feature is only available in XML and JSON format:

معيار طلب أسعار 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>Price info of this tld. Contain sub-tags: : Unit of price : Price of Registration : Price of Renew : Price of Transfer
<Privacy></Privacy>إذا كان هذا النطاق يدعم خصوصية whois
<GracePeriod></GracePeriod>Grace period info of this tld. Contain sub-tags: : Unit of grace period info : Renew grace period : Delete grace period
<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": "--"
      }
    ]
  }
}
 

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

This feature is only available in XML and JSON format:

عامل طلب قائمة النطاق
الشرح
customer_id (اختياري)Filter data by customer id (only resellers can use this parameter)
وسم 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"
    }
  }
}
 

Set Contact EU Setting Command

If calling set contact eu setting command, the following parameters should be included:

Set Contact EU Setting Request Parameter
الشرح
contact_idهوية جهة الاتصال التي ترغب في تحريرها
country_of_citizenshipMust be an EU member state, The country codes of member states include :
AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE
وسم XML بالنتيجة
الشرح
<SetContactEUSettingResponse></SetContactEUSettingResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetContactEUSettingHeader></SetContactEUSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<SetContactEUSettingContent></SetContactEUSettingContent>محتوى الاستجابة
<ContactId></ContactId>هوية جهة الاتصال

Set Contact EU Setting Example

الطلب (صيغة 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"
    }
  }
}
 

Set Contact LV Setting Command

If calling set contact lv setting command, the following parameters should be included:

Set Contact LV Setting Request Parameter
الشرح
contact_idهوية جهة الاتصال التي ترغب في تحريرها
registration_number- For individual, Please enter Latvian identification number.
- For companies and other legal entities, please enter registration number issued by the Latvian Register of Enterprises.
vat_number (اختياري)VAT number for foreign legal entities registered within European Union countries (this includes also Latvian companies)
وسم XML بالنتيجة
الشرح
<SetContactLvSettingResponse></SetContactLvSettingResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetContactLvSettingHeader></SetContactLvSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<SetContactLvSettingContent></SetContactLvSettingContent>محتوى الاستجابة
<ContactId></ContactId>هوية جهة الاتصال

Set Contact LV Setting Example

الطلب (صيغة 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"
   }
}
 

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

This command is only available in XML and JSON format:

معلمة طلب قائمة جهات الاتصال
الشرح
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"
      }
    ]
  }
}
 

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

This command is only available in XML and JSON format:

عامل طلب الحصول على جهة اتصال
الشرح
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"
   }
}
 

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

This command is only available in XML and JSON format:

عامل طلب قائمة الخوادم
الشرح
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>
        </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",
        "ServerIp": "192.168.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"
   }
}
 

Get Transfer Status Command

If calling get transfer status command, the following parameters should be included:

Get Transfer Status Request Parameter
الشرح
domainThe domain name you want to get transfer status for, only 1 domain can be entered per request
transfer_typeThe transfer type you want to get transfer status for (transfer in or transfer away)
وسم XML بالنتيجة
الشرح
<GetTransferStatusResponse></GetTransferStatusResponse>العقدة الجذرية لمستند XML للاستجابةXML مستند
<GetTransferStatusHeader></GetTransferStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetTransferStatusContent></GetTransferStatusContent>محتوى الاستجابة
<TransferList></TransferList>Transfer list
<Transfer></Transfer>Transfer info
<OrderId></OrderId>The order id
<TransferStatus></TransferStatus>The transfer status of domain.If you got 'none' or 'approved', you can cancel the transfer.If you got 'waiting', means transfer already start.If you got 'auth code needed', means bad auth code, you can use another api SET_TRANSFER_AUTH re-submit auth code.There are also some other statuses, we will send you an email or needs to be checked by our engineers.

Get Transfer Status Example

الطلب (صيغة 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"
      }
    ]
  }
}
 

Set Transfer Auth Code For Transfer Order Command

The command which allows you to update auth code for processing transfer orders. If calling set transfer auth code command, the following parameters should be included:

Set Transfer Auth Code Request Parameter
الشرح
domainThe domain name you update the transfer auth for, only 1 domain can be entered per request
auth_codeThe auth_code you want to re-submit
order_idThe transfer order id, you can get it from another api get_transfer_status.
وسم XML بالنتيجة
الشرح
<GetTransferStatusResponse></GetTransferStatusResponse>العقدة الجذرية لمستند XML للاستجابةXML مستند
<GetTransferStatusHeader></GetTransferStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

Set Transfer Auth Code Example

الطلب (صيغة 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"
   }
}
 

Cancel Transfer For Order Command

The Command allows you to cancel a transfer item in the order. If calling cancel transfer command, the following parameters should be included:

Cancel Transfer Request Parameter
الشرح
domainThe domain name you want to cancel transfer for, only 1 domain can be entered per request
order_idThe transfer order id, you can get it from another api get_transfer_status.
وسم XML بالنتيجة
الشرح
<CancelTransferResponse></CancelTransferResponse>العقدة الجذرية لمستند XML للاستجابةXML مستند
<CancelTransferHeader></CancelTransferHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

Cancel Transfer Example

الطلب (صيغة 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"
   }
}
 

Authorize Transfer Away Command (RESELLER ONLY)

Authorize Transfer Away Request Parameter
الشرح
domainThe domain name you want to authorize transfer away for, only 1 domain can be entered per request
order_idThe Dynadot order_id of the domain you want to transfer away
authorizeTo authorize the transfer away, set it equal to "approve". To deny the transfer away, set it equal to "deny".
وسم XML بالنتيجة
الشرح
<AuthorizeTransferAwayResponse></AuthorizeTransferAwayResponse>العقدة الجذرية لمستند XML للاستجابةXML مستند
<AuthorizeTransferAwayHeader></AuthorizeTransferAwayHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<Result></Result>The result of authorize transfer away

Authorize Transfer Away Example

الطلب (صيغة 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"
   }
}
 

Create CN Audit Command

The Command allows you to create a CN audit for a contact. If calling create cn audit command, the following parameters should be included:

Create CN Audit Request Parameter
الشرح
contact_idThe contact record id you want start audit for, only 1 contact id can be entered per request
contact_typeType of contact, can be either "Individual" or "Enterprise"
individual_id_typeNatural person's ID type, expected values (description of value) are:
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_idThe License number of natural person's ID
individual_urlDocument of natural person license ID. The file url on the server. Only jpg, gif, png, jpeg are allowed
enterprise_id_type (Mandatory when contact type is "Enterprise")Enterprise ID type, expected values (description of value) are:
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")The License number of enterprise document
enterprise_url (Mandatory when contact type is "Enterprise")Document of enterprise license. The file url on the server. Only jpg, gif, png, jpeg are allowed
وسم XML بالنتيجة
الشرح
<CreateCnAuditResponse></CreateCnAuditResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<CreateCnAuditHeader></CreateCnAuditHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

Create CN Audit Example

الطلب (صيغة 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"
   }
}
 

Get Cn Audit Status Command

If calling get cn audit status command, the following parameters should be included:

Get Cn Audit Status Request Parameter
الشرح
contact_idThe contact record id you want to get audit status for, only 1 contactId can be entered per request
gtldIf you query the audit result of the cnnic-gtld, set this parameter to 1
وسم XML بالنتيجة
الشرح
<GetCnAuditStatusResponse></GetCnAuditStatusResponse>العقدة الجذرية لمستند XML للاستجابةXML مستند
<GetCnAuditStatusHeader></GetCnAuditStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<CnAuditStatus></CnAuditStatus>the audit status of cnnic audit record. You may got 'processing' or 'waiting for cnnic' or 'failed'. If failed, we will send you an email.
<FailedReason></FailedReason>If the audit unpass, the failed reason will be displayed

Get Cn Audit Status Example

الطلب (صيغة 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"
  }
}
 

Get Account Balance Command

This command is only available in XML and JSON format:

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

Get Account Balance Example

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

مثال على 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"
   }
}
 

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

This command is only available in XML and JSON format:

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

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

This command is only available in XML and JSON format:

عامل طلب قائمة المجلدات
الشرح
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

الاستجابة (صيغة 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

الاستجابة

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

الطلب (صيغة 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": "-"
        }
        ...
    ]
}
 

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

Calling the get auction details command will return the details of auction specified. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:

معلمة طلب جلب تفاصيل مزاد
الشرح
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>Whether it is a premium domain
<RenewalPrice></RenewalPrice>Renewal price

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

الطلب (صيغة 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,please use get_open_auctions command)

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

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

 

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

Calling the get backorder auction details command will return the details of auction specified. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:

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

Get Expired Closeout Domains Command

Calling the Get Expired Closeout Domains Command will Get Expired Closeout Domains. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:

Get Expired Closeout Domains Request Parameter
الشرح
currency(optional)The currency of return result, it should be "usd", "eur", or "cny", default currency is US Dollars
domain(optional)Add this parameter if you want to query for a closeout domain
وسم XML بالنتيجة
الشرح
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>Tag of Get Expired Closeout Domains response, it's the root node of the response XML document
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>Get Expired Closeout Domains Header
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure
<Status></Status>حالة الطلب
<Error></Error>Error information about the request, only used when status is "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>Tag of content, it's only used when status is "success"
<CloseoutItem></CloseoutItem>CloseoutItem
<DomainName></DomainName>The domain name
<DomainNameUtf></DomainNameUtf>The domain name is in utf format
<CurrentPrice></CurrentPrice>current price
<isIdn></isIdn>Whether it is the idn domain name
<EndTimeStamp></EndTimeStamp>End date of auction in Unix time (milliseconds since midnight UTC of January 1, 1970)
<RenewalPrice></RenewalPrice>Renewal price
<ExpiredRevenue></ExpiredRevenue>Revenue of closeout
<EstibotAppraisal></EstibotAppraisal>EstibotAppraisal
<InboundLinks></InboundLinks>الروابط الواردة الخاصة بالنطاق
<MonthlyVisitors></MonthlyVisitors>زائرو النطاق
<Currency></Currency>currency

Get Expired Closeout Domains Example

الطلب (صيغة 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"
        }
      }
    ]
  }
}
 

Buy Expired Closeout Domain Command

Calling the Buy Expired Closeout Domain Command will buy the specified domain name. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:

Buy Expired Closeout Domain Request Parameter
الشرح
domainThe domain you want to buy, only 1 domain can be entered per request
currency(optional)The currency of return result, it should be "usd", "eur", or "cny", default currency is US Dollars
وسم XML بالنتيجة
الشرح
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>Tag of Buy Expired Closeout Domain response, it's the root node of the response XML document
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>Buy Expired Closeout Domain header
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure
<Status></Status>حالة الطلب
<Error></Error>Error information about the request, only used when status is "error"

Buy Expired Closeout Domain Example

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

http://127.0.0.1:8889/api3.xml?key=0&command=buy_expired_closeout_domain¤cy=USD&domain=domain-exp141.org.ph

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

http://127.0.0.1:8889/api3.json?key=0&command=buy_expired_closeout_domain¤cy=USD&domain=domain-exp141.org.ph

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

Get Order Status Command

Calling the Get Order Status Command will get order status. This command is only available in XML and JSON format. If calling this command, the following parameters should be included:

Get Order Status Request Parameter
الشرح
order_idThe id of the order to be queried
وسم XML بالنتيجة
الشرح
<GetOrderStatusResponse></GetOrderStatusResponse>the root node of the response
<GetOrderStatusHeader></GetOrderStatusHeader>Get Order Status header
<ResponseCode></ResponseCode>If the operation is successful, "0" for success, "-1" for failure
<Status></Status>حالة الطلب
<Error></Error>Error information about the request, only used when status is "error"
<GetOrderStatusContent></GetOrderStatusContent>response content
<OrderId></OrderId>order id
<OrderStatus></OrderStatus>order status( Shopping, Submitted, Waitpay, Processing, Completed, Problem, Deleted, Cancelled )
<ItemTypeName></ItemTypeName>item Type
<ItemName></ItemName>item Name
<ItemStatus></ItemStatus>Item Status(Completed, Cancelled, Problem)

Get Order Status Example

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

http://127.0.0.1:8889/api3.xml?key=0&command=get_ordedr_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)

http://127.0.0.1:8889/api3.json?key=0&command=get_ordedr_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"
        }
      ]
    }
  }
}
Are you sure you want to close the chat?Chat will be closed and the chat history will be cleared.
Sorry, can't receive informationPlease move your mouse to the dialog
Chat Online
الدردشة الحية0