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

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

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

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

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

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

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

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

معلمة الطلب
الشرح
Keyمفتاحك للوصول إلى API، يوجد على لوحة التحكم في حسابك

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

اسم علامة 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 (اختياري)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
وسم 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>معلومات اللغة المتعلقة باسم النطاق

مثال للبحث

الطلب

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

الاستجابة
<Results>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.com</DomainName>
      <Status>success</Status>
      <Available>yes</Available>
      <Price>10.99 in USD</Price>
    </SearchHeader>
  </SearchResponse>
  <SearchResponse>
    <SearchHeader>
      <SuccessCode>0</SuccessCode>
      <DomainName>mydomain.net</DomainName>
      <Status>success</Status>
      <Available>yes</Available>
      <Price>9.99 in USD</Price>
    </SearchHeader>
  </SearchResponse>
</Results>
 

أمر التسجيل

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

معلمة طلب التسجيل
الشرح
domainاسم النطاق الذي تريد تسجيله، لا يمكن تسجيل أكثر من 1 نطاق/نطاقات في كل طلب
language (اختياري)وسم اللغة الخاصة بالنطاق المطلوب، غير ضروري سوى في حال كان النطاق مدوّلا
durationمدة تسجيل النطاق
option0 ( إذا لزم الأمر )اسم مسجّل .UK أو المؤسسة المسجّلة
اسم وكيل تسجيل .AT, .BE, .LT, أو .PH
option1 ( إذا لزم الأمر )المنظمة المسجلة .AT, .BE, .LT, أو .PH (اختياري)
يمكنك تحديد option0, option1, أو كلاهما لنطاق .AT
option2 ( إذا لزم الأمر )رمز منظمة .LT
premium (اختياري)Wenn Sie eine Premium-Domain eintragen lassen wollen, setzen Sie sie auf "1" (optional)
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
وسم 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"

مثال للتسجيل

الطلب

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

الاستجابة
<RegisterResponse>
  <RegisterHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RegisterHeader>
  <RegisterContent>
    <Expiration>1458379145266</Expiration>
  </RegisterContent>
</RegisterResponse>
 

أمر الحذف

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

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

مثال للحذف

الطلب

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

الاستجابة
<DeleteResponse>
  <DeleteHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteHeader>
</DeleteResponse>
 

أمر التجديد

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

معلمة طلب التجديد
الشرح
domainاسم النطاق الذي تريد تجديده، لا يمكن تجديد أكثر من 1 نطاق/نطاقات في كل طلب
durationعدد سنوات تجديد النطاق
year (اختياري)سنة انتهاء صلاحية تسجيل النطاق
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
وسم XML بالنتيجة
الشرح
<RenewResponse></RenewResponse>وسم استجابة التجديد، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<RenewHeader></RenewHeader>رأس التجديد
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<RenewContent></RenewContent>وسم محتوى التجديد، لا يستخدم سوى عندما تكون الحالة "success"
<Expiration></Expiration>تاريخ انتهاء الصلاحية بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المتفق عليه UTC)، لا يستخدم سوى عندما تكون النتيجة "success"

مثال للتجديد

الطلب

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

الاستجابة
<RenewResponse>
  <RenewHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </RenewHeader>
  <RenewContent>
    <Expiration>73984579834</Expiration>
  </RenewContent>
</RenewResponse>
 

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

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

معلمة طلب معلومات النطاق
الشرح
domainغير مسموح سوى بعدد 1 نطاق/نطاقات فقط لكل طلب
وسم XML بالنتيجة
الشرح
<DomainInfoResponse></DomainInfoResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<DomainInfoResponseHeader></DomainInfoResponseHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<DomainInfoContent></DomainInfoContent>محتوى الاستجابة
<Domain></Domain>النطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء الصلاحية بتوقيت يونكس (مللي ثانية منذ منتصف ليل 1 يناير 1970 بالتوقيت العالمي المتفق عليه UTC)،
<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>اسم الملف

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

الطلب

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

الاستجابة
<DomainInfoResponse>
  <DomainInfoResponseHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DomainInfoResponseHeader>
  <DomainInfoContent>
    <Domain>
      <Name>domain1.com</Name>
      <Expiration>1370056762789</Expiration>
      <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></Note>
      <Folder>
        <FolderId>-1</FolderId>
        <FolderName>(no folder)</FolderName>
      </Folder>
    </Domain>
  </DomainInfoContent>
</DomainInfoResponse>
 

أمر تعيين 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

الطلب

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

الاستجابة
<SetWhoisResponse>
  <SetWhoisHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetWhoisHeader>
</SetWhoisResponse>
 

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

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

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

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

الطلب

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

الاستجابة
<SetNsResponse>
  <SetNsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetNsHeader>
</SetNsResponse>
 

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

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

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

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

الطلب

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

الاستجابة

<SetParkingResponse><SetParkingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetParkingHeader></SetParkingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetForwardingResponse><SetForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetForwardingHeader></SetForwardingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetStealthResponse><SetStealthHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetStealthHeader></SetStealthResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetHostingResponse><SetHostingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetHostingHeader></SetHostingResponse>

 

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

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

(هذا الأمر قديم ولا ينصح باستخدامه، يرجى استخدام أمر تعيين خادم أسماء نطاقات 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 - subdomain20 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type20 (اختياري)نوع سجلات النطاق الفرعي
sub_record0 - sub_record20 (اختياري)عناوين الآي بي أو المضيف المستهدف
mx_host0 - mx_host2 (اختياري)تحديد البريد الإليكتروني المضيف لنطاقك، distance0 تمثل أعلى أولوية
mx_distance0 - mx_distance2 (اختياري)Distance0 تمثل أعلى أولوية
ttl (اختياري)المدة المتبقية للعمل
وسم XML بالنتيجة
الشرح
<SetDnsResponse></SetDnsResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetDnsHeader></SetDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب

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

الاستجابة

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

أمر تعيين DNS2

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

معلمة طلب تعيين DNS2
الشرح
domainاسم النطاق الذي تريد تعيينه، لا يمكن تعيين أكثر من 100 نطاق/نطاقات في كل طلب، احرص على فصلها بفواصل (,)
main_record_type0 - main_record_type19يجب أن يكون نوع السجل الرئيسي إما "a" أو "aaaa" أو "cname" أو "إعادة توجيه" أو "txt" أو "mx" أو "التخفي" أو "البريد الإلكتروني"
main_record0 - main_record19عيّن سجل DNS لنطاقك
main_recordx0 - main_recordx19تكون مسافة Mx أو نوع إعادة التوجيه أو عنوان إعادة التوجيه الخفي أو البريد الإلكتروني المستعار ضرورية عندما يكون نوع_السجل_الرئيسي إما "إعادة التوجيه" أو "mx" أو "التخفي" أو "البريد الإلكتروني"
subdomain0 - subdomain49 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type49يجب أن يكون نوع سجل النطاق الفرعي إما "a" أو "aaaa" أو "cname" أو "إعادة توجيه" أو "txt" أو "srv" أو "mx" أو "التخفي" أو "البريد الإلكتروني"
sub_record0 - sub_record49عنوان IP للنطاق الفرعي أو مضيف مستهدف
sub_recordx0 - sub_recordx49تكون مسافة Mx أو نوع إعادة التوجيه أو عنوان إعادة التوجيه الخفي أو البريد الإلكتروني المستعار ضرورية عندما يكون نوع_السجل_الرئيسي إما "إعادة التوجيه" أو "mx" أو "التخفي" أو "البريد الإلكتروني"
ttl (اختياري)المدة المتبقية للعمل
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

مثال لتعيين DNS2

الطلب

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

الاستجابة

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

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

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

معلمة طلب تعيين الاستضافة المجانية
الشرح
domainاسم النطاق الذي تريد تعيينه، لا يمكن تعيين أكثر من 100 نطاق/نطاقات في كل طلب، احرص على فصلها بفواصل (,)
style (اختياري)نمط الصفحة المجانية
titleعنوان الصفحة المجانية
bodyالجزء الرئيسي من الصفحة، مسموح باستخدام HTML ولكن لابد من تضمين الكلمات المفتاحية التالية: <html>,<title>, <body>, <meta>, <script>; يرجى ملاحظة أي HTML يتم إدخالها في الجزء الرئيسي لن يتم تفعيلها.
وسم XML بالنتيجة
الشرح
<SetFreeHostResponse></SetFreeHostResponse>وسم استجابة تعيين المضيف المجاني، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetFreeHostHeader></SetFreeHostHeader>ضبط العنوان الرئيسي للمضيف المجاني
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=set_free_hosting&domain=domain1.com,domain2.com&title=Obama's shop&body=<div>this is obama's shop</div>

الاستجابة

<SetFreeHostResponse><SetFreeHostHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFreeHostHeader></SetFreeHostResponse>

 

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

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

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

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=set_email_forward&domain=domain1.com&forward_type=forward&username0=peter&exist_email0=Alex@dynadot.com

الاستجابة

<SetEmailForwardingResponse><SetEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetEmailForwardingHeader></SetEmailForwardingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetClearDomainSettingResponse><SetClearDomainSettingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetClearDomainSettingHeader></SetClearDomainSettingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderResponse><SetFolderHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderHeader></RenewResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetRenewOptionResponse><SetRenewOptionHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetRenewOptionHeader></SetRenewOptionResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetNoteResponse><SetNoteHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetNoteHeader></SetNoteResponse>

 

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

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

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

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

الطلب

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

الاستجابة
<SetPrivacyResponse>
  <SetPrivacyHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </SetPrivacyHeader>
</SetPrivacyResponse>
 

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

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

عامل طلب قائمة النطاق
الشرح
N/Aغير مطلوب أية معلمات إضافية
وسم 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)،
<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>اسم الملف

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

الطلب

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

الاستجابة
<ListDomainInfoResponse>
  <ListDomainInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ListDomainInfoHeader>
  <ListDomainInfoContent>
    <DomainInfoList>
      <DomainInfo>
        <Domain>
          <Name>domain-exp140.com</Name>
          <Expiration>1361430589062</Expiration>
          <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>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note></Note>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
        </Domain>
      </DomainInfo>
      <DomainInfo>
        <Domain>
          <Name>domain-exp141.com</Name>
          <Expiration>1361430589062</Expiration>
          <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>
          <Hold>no</Hold>
          <Privacy>none</Privacy>
          <isForSale>no</isForSale>
          <RenewOption>no renew option</RenewOption>
          <Note></Note>
          <Folder>
            <FolderId>-1</FolderId>
            <FolderName>(no folder)</FolderName>
          </Folder>
        </Domain>
      </DomainInfo>
    </DomainInforList>
  </ListDomainInfoContent>
</ListDomainInfoResponse>
 

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

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

معلمة طلب إنشاء جهة اتصال
الشرح
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>&lt;ContactId&gt; جهة اتصال جديدة&lt;/ContactId&gt;,، تستخدم فقط عندما يكون الوضع "success"

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

الطلب

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

الاستجابة
<CreateContactResponse>
  <CreateContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </CreateContactHeader>
  <CreateContactContent>
    <ContactId>1234</ContactId>
  </CreateContactContent>
</CreateContactResponse>
 

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

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

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

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

الطلب

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

الاستجابة
<EditContactResponse>
  <EditContactHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </EditContactHeader>
  <EditContactContent>
    <ContactId>0</ContactId>
  </EditContactContent>
</EditContactResponse>
 

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

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

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

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

الطلب

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

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

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

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

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

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

الطلب

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

الاستجابة
<ContactListResponse>
  <ContactListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ContactListHeader>
  <ContactListContent>
    <ContactList>
      <Contact>
        <ContactId>0</ContactId>
        <Organization></Organization>
        <Name>Jack Slater</Name>
        <Email>test@dynadot.com</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <FaxCc></FaxCc>
        <FaxNum></FaxNum>
        <Address1>1 Free Way</Address1>
        <Address2></Address2>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</ZipCode>
        <Country>US</Country>
      </Contact>
    </ContactList>
  </ContactListContent>
</ContactListResponse>
 

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

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

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

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

الطلب

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

الاستجابة
<GetContactResponse>
 <GetContactHeader>
  <ResponseCode>0</ResponseCode>
  <Status>success</Status>
 </GetContactHeader>
 <GetContactContent>
  <Contact>
   <ContactId>12345</ContactId>
   <Organization>org</Organization>
   <Name>name</Name>
   <Email>example@example.com</Email>
   <PhoneCc>0</PhoneCc>
   <PhoneNum>phone number</PhoneNum>
   <FaxCc>example faxcc</FaxCc>
   <FaxNum>example faxnum</FaxNum>
   <Address1>address1</Address1>
   <Address2>address2</Address2>
   <City>city</City>
   <State>state</State>
   <ZipCode>zipcode</ZipCode>
   <Country>country</Country>
  </Contact>
 </GetContactContent></GetContactResponse>
 

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

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

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

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

الطلب

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

الاستجابة

<AddNsResponse><AddNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></AddNsHeader><AddNsContent><Server><Host>ns1.mydomain.com</Host><ServerId>0</ServerId></Server></AddNsContent></AddNsResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<RegisterNsResponse><RegisterNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></RegisterNsHeader><RegisterNsContent><Server><Host>domain1.com</Host><ServerId>0</ServerId></Server></RegisterNsContent></RegisterNsResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetNsIpResponse><SetNsIpHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetNsIpHeader></SetNsIpResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<DeleteNsResponse><DeleteNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></DeleteNsHeader></DeleteNsResponse>

 

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

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

عامل طلب قائمة الخوادم
الشرح
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>الآي بي الخاص بالخادم

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

الطلب

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

الاستجابة
<ServerListResponse>
  <ServerListHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </ServerListHeader>
  <ServerListContent>
    <NameServerList>
      <List>
        <Server>
          <ServerId>0</ServerId>
          <ServerName>ns1.com</ServerName>
          <ServerIp></ServerIp>
        </Server>
        <Server>
          <ServerId>1</ServerId>
          <ServerName>domain1.com</ServerName>
          <ServerIp>192.168.1.1,,,,,,,,,</ServerIp>
        </Server>
      </List>
    </NameServerList>
  </ServerListContent>
</ServerListResponse>
 

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

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

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

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

الطلب

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

الاستجابة
<AccountInfoResponse>
  <AccountInfoHeader>
    <ResponseCode>0</ResponseCode>
    <Status>success</Status>
  </AccountInfoHeader>
  <AccountInfoContent>
    <AccountInfo>
      <Username>slater</Username>
      <ForumName>slaterinforum</ForumName>
      <Contact>
        <Organization></Organization>
        <Name>Jack Slater</Name>
        <Email>bishop@dynadot.local</Email>
        <PhoneCc>1</PhoneCc>
        <PhoneNum>555.555.5233</PhoneNum>
        <Address1>1 Free Way</Address1>
        <Address2></Address2>
        <City>Los Angeles</City>
        <State>CA</State>
        <ZipCode>90068</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>
 

ضبط قائمة "من يكون" 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"

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

الطلب

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

الاستجابة

<SetDefaultWhoisResponse><SetDefaultWhoisHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultWhoisHeader></SetDefaultWhoisResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultNsResponse><SetDefaultNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultNsHeader><SetDefaultNsContent><Servers><Server><Servername>ns1.hosts.com</Servername><ServerId>1</ServerId></Server><Server><Servername>ns2.hosts.com</Servername><ServerId>2</ServerId></Server></Servers></SetDefaultNsContent></SetDefaultNsResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultParkingResponse><SetDefaultParkingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultParkingHeader></SetDefaultParkingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultForwardingResponse><SetDefaultForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultForwardingHeader></SetDefaultForwardingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultStealthResponse><SetDefaultStealthHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultStealthHeader></SetDefaultStealthResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultHostingResponse><SetDefaultHostingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultHostingHeader></SetDefaultHostingResponse>

 

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

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultDnsResponse><SetDefaultDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultDnsHeader></SetDefaultDnsResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultDnsResponse><SetDefaultDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultDnsHeader></SetDefaultDnsResponse>

 

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

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

معلمة طلب تعيين الاستضافة المجانية الافتراضية
الشرح
style (اختياري)نمط الصفحة المجانية
titleعنوان الصفحة المجانية
bodyالجزء الرئيسي من الصفحة، مسموح باستخدام HTML ولكن لابد من تضمين الكلمات المفتاحية التالية: <html>,<title>, <body>, <meta>, <script>; يرجى ملاحظة أي HTML يتم إدخالها في الجزء الرئيسي لن يتم تفعيلها.
وسم XML بالنتيجة
الشرح
<SetDefaultFreeHostResponse></SetDefaultFreeHostResponse>وسم استجابة تعيين المضيف المجاني الافتراضي، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetDefaultFreeHostHeader></SetDefaultFreeHostHeader>ضبط عنوان المضيف المجاني الافتراضي
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_free_hosting&title=Obama's shop&body=<div>this is obama's shop</div>

الاستجابة

<SetDefaultFreeHostResponse><SetDefaultFreeHostHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultFreeHostHeader></SetDefaultFreeHostResponse>

 

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

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

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

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=set_default_email_forward&forward_type=forward&username0=peter&exist_email0=peter@dynadot.com

الاستجابة

<SetDefaultEmailForwardingResponse><SetDefaultEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetClearDefaultSettingResponse><SetClearDefaultSettingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetClearDefaultSettingHeader></SetClearDefaultSettingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetDefaultRenewOptionResponse><SetDefaultRenewOptionHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDefaultRenewOptionHeader></SetDefaultRenewOptionResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<FolderCreateResponse><FolderCreateHeader><SuccessCode>0</SuccessCode><Status>success</Status></FolderCreateHeader><FolderCreateContent><FolderName>new</FolderName><FolderId>2</FolderId></FolderCreateContent></FolderCreateResponse>

 

أمر حذف مجلد

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

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

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

الطلب

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

الاستجابة

<DeleteFolderRespofoldere><DeleteFolderHeader><SuccessCode>0</SuccessCode><Status>success</Status></DeleteFolderHeader></DeleteFolderRespofoldere>

 

أمر تعيين مجلد 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"

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

الطلب

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

الاستجابة

<SetFolderWhoisResponse><SetFolderWhoisHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderWhoisHeader></SetFolderWhoisResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderNsResponse><SetFolderNsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderNsHeader><SetFolderNsContent><Servers><Server><ServerName>ns1.hosts.com</ServerName><ServerId>0</ServerId></Server><Server><ServerName>ns2.host.com</ServerName><ServerId>1</ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server><Server><ServerName></ServerName><ServerId></ServerId></Server></Servers></SetFolderNsContent></SetFolderNsResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderParkingResponse><SetFolderParkingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderParkingHeader></SetFolderParkingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderForwardingResponse><SetFolderForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderForwardingHeader></SetFolderForwardingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderStealthResponse><SetFolderStealthHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderStealthHeader></SetFolderStealthResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderHostingResponse><SetFolderHostingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderHostingHeader></SetFolderHostingResponse>

 

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

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

( هذا الأمر ملغى ولا ينصح به، يرجى استخدام أمر تعيين مجلد 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 - subdomain20 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type20 (اختياري)نوع سجلات النطاق الفرعي
sub_record0 - sub_record20 (اختياري)عناوين الآي بي أو المضيف المستهدف
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"

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

الطلب

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

الاستجابة

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

أمر تعيين مجلد 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 - subdomain49 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type49 (اختياري)يجب أن يكون نوع سجلات النطاق الفرعي إما "a" أو "aaaa" أو "cname" أو "إعادة توجيه" أو "txt" أو "srv" أو "mx" أو "التخفي" أو "البريد الإلكتروني"
sub_record0 - sub_record49 (اختياري)عناوين الآي بي أو المضيف المستهدف
sub_recordx0 - sub_recordx49 (اختياري)تكون مسافة Mx أو نوع إعادة التوجيه أو عنوان إعادة التوجيه الخفي أو البريد الإلكتروني المستعار ضرورية عندما يكون نوع_السجل_الفرعي "إعادة توجيه" أو "mx" أو "التخفي" أو"البريد الإلكتروني"
ttl (اختياري)المدة المتبقية للعمل
enable (اختياري)إذا أردت تطبيق اعدادات خادم أسماء النطاقات هذه على النطاقات المستقبلية التي تنقلها لهذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
sync (اختياري)إذا أردت مزامنة إعدادات خادم أسماء النطاقات هذه مع كل النطاقات داخل هذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
وسم XML بالنتيجة
الشرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetFolderDnsHeader></SetFolderDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب

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

الاستجابة

<SetDnsResponse><SetDnsHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetDnsHeader></SetDnsResponse>

 

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

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

معلمة طلب تعيين الاستضافة المجانية لمجلد
الشرح
folder_idمعرف المجلد الذي تريد تعيينه
enable (اختياري)إذا أردت تطبيق اعدادات الاستضافة المجانية هذه على النطاقات المستقبلية التي تنقلها لهذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
sync (اختياري)إذا أردت مزامنة إعدادات الاستضافة المجانية هذه مع كل النطاقات داخل هذا المجلد، يمكنك استخدام هذا الثابت مع "yes"
style (اختياري)نمط الصفحة المجانية
titleعنوان الصفحة المجانية
bodyالجزء الرئيسي من الصفحة، مسموح باستخدام HTML ولكن لابد من تضمين الكلمات المفتاحية التالية: <html>,<title>, <body>, <meta>, <script>; يرجى ملاحظة أي HTML يتم إدخالها في الجزء الرئيسي لن يتم تفعيلها.
وسم XML بالنتيجة
الشرح
<SetFolderFreeHostingResponse></SetFolderFreeHostingResponse>وسم استجابة تعيين الاستضافة المجانية للمجلد، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<SetFolderFreeHostingHeader></SetFolderFreeHostingHeader>تعيين العنوان الرئيسي لمجلد لاستضافة المجانية للمجلد
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_free_hosting&folder_id=0&title=obama's shop&body=Welcome to obama's shop&enable=yes&sync=yes

الاستجابة

<SetFolderFreeHostResponse><SetFolderFreeHostHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderFreeHostHeader></SetFolderFreeHostResponse>

 

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

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

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

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=peter&exist_email0=peter@dynadot.com

الاستجابة

<SetFolderEmailForwardingResponse><SetFolderEmailForwardingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderEmailForwardingHeader></SetFolderEmailForwardingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetClearFolderSettingResponse><SetClearFolderSettingHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetClearFolderSettingHeader></SetClearFolderSettingResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<SetFolderNameResponse><SetFolderNameHeader><SuccessCode>0</SuccessCode><Status>success</Status></SetFolderNameHeader></SetFolderNameResponse>

 

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

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

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

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

الطلب

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

الاستجابة

<Response><ResponseHeader><ResponseCode>0</ResponseCode></ResponseHeader></Response>

 

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

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

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

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

الطلب

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

الاستجابة
<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>
 

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

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

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

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

الطلب

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

الاستجابة
<AddBackorderRequestResponse>
  <AddBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </AddBackorderRequestHeader>
</AddBackorderRequestResponse>
 

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

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

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

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

الطلب

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

الاستجابة
<DeleteBackorderRequestResponse>
  <DeleteBackorderRequestHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
 

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

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

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

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

الطلب

https://api.dynadot.com/api3.xml?key=mykey&command=backorder_request_list&month=1&day=31&year=2014

الاستجابة
<BackorderRequestListResponse>
  <BackorderRequestListHeader>
    <ResponseCode>0</ResponseCode>
    <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

الاستجابة

ok,
success,
Domain,CutoffTime,BackorderRequestStatus
domain.com,1431661200000,Active
domain2.com,1431661200000,Success
domain3.com,1431661200000,Success
.
.
.

 

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

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

معلمة طلب جلب المزادات المفتوحة
الشرح
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny", والعملة الافتراضية هي الدولار الأمريكي
وسم 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

الاستجابة
<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
.
.
.

 

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

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

معلمة طلب جلب تفاصيل مزاد
الشرح
domainاسم نطاق المزاد، اسم النطاق الدولي ينبغي أن يستخدم بيونيكود، مثل "xn--wkccg.com"
currency (اختياري)عملة نتيجة الرد، وينبغي أن تكون "usd", "eur", أو "cny", والعملة الافتراضية هي الدولار الأمريكي
وسم XML بالنتيجة
الشرح
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>وسم استجابة جلب تفاصيل المزاد، هذه هي العقدة الجذرية الخاصة بمستند الاستجابة بصيغة XML
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>ترويسة الحصول على تفاصيل مزادات الحجز المسبق
<SuccessCode></SuccessCode>إذا نجحت العملية: "0" للإشارة إلى النجاح، "-1" للإشارة إلى الفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ المتعلقة بالطلب، لا يستخدم سوى عندما تكون الحالة "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>الكلمة المفتاحية للحصول على محتوى تفاصيل المزاد، ويمكن استخدامها فقط عندما يكون الوضع "success"
<AuctionStatusId></AuctionStatusId>معرفات الحالة للمزاد، '0' يعني قيد التقدم و '1' مغلق من قبل المشرف و'2' مقفل بسبب نفاذ الوقت و'3' مشكلة
<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 بتوقيت جرينتش)

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

الطلب

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

الاستجابة
<GetAuctionDetailsResponse>
 <GetAuctionDetailsHeader>
   <SuccessCode>0</SuccessCode>
   <Status>success</Status>
 </GetAuctionDetailsHeader>
 <GetAuctionDetailsContent>
   <AuctionStatusId>0</AuctionStatusId>
   <AuctionStatus>In Progress</AuctionStatus>
   <UserIsHighBid>No</UserIsHighBid>
   <YourCurrentBid>-1</YourCurrentBid>
   <YourProxyBid>-1</YourProxyBid>
   <Auction>
     <AuctionId>0</AuctionId>
     <Domain>domain0.com</Domain>
     <BidPrice>6.35</BidPrice>
     <BidPriceCurrency>CNY</BidPriceCurrency>
     <Bids>0</Bids>
     <EndTime>2017/09/03 17:12 UTC</EndTime>
     <EndTimestamp>1504458737058</EndTimestamp>
   </Auction>
 </GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
 

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

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

معلمة طلب إرسال عرض في مزاد
الشرح
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

الاستجابة
<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

 

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

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

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

الاستجابة
<GetClosedAuctionsResponse>
  <GetClosedAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedAuctionsContent>
    <Auction>
      <AuctionId>2</AuctionId>
      <Domain>domain-exp143.ooo</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>domain-exp144.vc</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)

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

الاستجابة

ok,
success,
AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid
2,domain.com,4,Closed by Timeout,89.99,USD,1,won,89.99,200
3,domain.com,4,Closed by Timeout,28.99,USD,1,won,28.99,300
.
.
.

 

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

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

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

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

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

الاستجابة

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

 

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

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

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

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

الطلب

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

الاستجابة
<GetBackorderAuctionDetailsResponse>
  <GetAuctionDetailsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetAuctionDetailsHeader>
  <GetAuctionDetailsContent>
    <Auction>
      <AuctionStatusId>0</AuctionStatusId>
      <AuctionStatus>IN_PROGRESS</AuctionStatus>
      <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>
      <Revenue>114</Revenue>
      <RevenueCurrency>USD</RevenueCurrency>
      <Visitors>-1</Visitors>
      <Links>-1</Links>
      <Age>1</Age>
      <UserIsHighBid>false</UserIsHighBid>
      <YourCurrentBid>-1</YourCurrentBid>
      <YourProxyBid>-1</YourProxyBid>
    </Auction>
  </GetAuctionDetailsContent></GetBackorderAuctionDetailsResponse>
 

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

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

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

الاستجابة
<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

الاستجابة

ok,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

الاستجابة
<GetClosedBackorderAuctionsResponse>
  <GetClosedBackorderAuctionsHeader>
    <SuccessCode>0</SuccessCode>
    <Status>success</Status>
  </GetClosedAuctionsHeader>
  <GetClosedBackorderAuctionsContent>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>89.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>2</AuctionId>
      <Domain>domain-exp143.ooo</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>89.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
    </Auction>
    <Auction>
      <AuctionWonStatus>won</AuctionWonStatus>
      <YourHighBid>28.99</YourHighBid>
      <YourProxyBid>1000.0</YourProxyBid>
      <AuctionId>3</AuctionId>
      <Domain>domain-exp144.vc</Domain>
      <AuctionStatusId>4</AuctionStatusId>
      <AuctionStatus>Closed by Timeout</AuctionStatus>
      <BidPrice>28.99</BidPrice>
      <BidPriceCurrency>USD</BidPriceCurrency>
      <Bids>1</Bids>
    </Auction>
  </GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
الطلب (بصيغة csv)

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

الاستجابة

ok,
success,
AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid
2,domain.com,4,Closed by Timeout,89.99,USD,1,won,89.99,200
3,domain.com,4,Closed by Timeout,28.99,USD,1,won,28.99,300
.
.
.

 

أمر تجهيز البيانات

إن استدعاء أمر تجهيز البيانات سيخبرك إذا ما كان تقديم طلب جديد سيتم بصورة آمنة

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

مثال على تجهيز البيانات

الطلب

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

الاستجابة
<Response>
  <ResponseHeader>
    <ResponseCode>0</ResponseCode>
    <ResponseMsg>yes</ResponseMsg>
  </ResponseHeader>
</Response>
الطلب (بصيغة csv)

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

الاستجابة

ok,yes