معامل الطلبشرح
معامل الطلب
شرح
Keyمفتاحك للوصول إلى API، متاح في لوحة التحكم بحساب Dynadot تحت قائمة 'Tools' -> 'API' الجانبية.
Commandالنطاق:
, , , , , , ,
, , , , , , , , , , , , , , , , , , , ,
, , , ,
, جهة الاتصال:
, , , , , ,
, , خادم الأسماء:
, , , , , , , الحساب:
, , , , , , , , , , , , Folder:
, , , , , , , , , , , , , , السوق الثانوي:
, ,
, , , ,
, , , , , , , , , أخرى:
, , , , , , , , , تنسيق XML. يجب أن تحتوي الاستجابة التي تتلقاها على 2 أو 3 من الحقول التالية:
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
أمر البحث
إذا كنت تستدعي أمر البحث, فيجب تضمين المعلمات التالية:
معامل طلب البحثشرح
معامل طلب البحث
شرح
domain0 - domain99اسم النطاق الذي تبحث عنه، يمكن للحساب العادي تحديد نطاق واحد لكل أمر، ويمكن لحساب الجملة والحساب فائق الجملة تحديد ما يصل إلى 100 نطاق
language0 - language99 (optional)وسم اللغة الخاص بالنطاق المعني، استخدم هذا فقط للنطاقات الدولية IDNs
show_price (optional)إذا كنت تريد عرض السعر بعملة حسابك، فاضبطه على "1". إذا كان النطاق متاحًا، فسيتم عرض تفاصيله المميزة ومعلومات السعر.
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<Results></Results>العقدة الجذرية لاستجابة XML لأمر البحث
<SearchResponse></SearchResponse>وسم استجابة البحث
<SearchHeader></SearchHeader>وسم رأس البحث
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<DomainName></DomainName>اسم النطاق الذي بحثت عنه للتو
<Available></Available>إذا كان اسم النطاق متاحًا
<Price></Price>إذا قمت بتعيين "show_price" لتساوي "1"، فسيخبرك بمعلومات السعر إذا كان هذا النطاق متاحًا.
<Language></Language>معلومات اللغة حول اسم النطاق
مثال البحث
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
الاستجابة (تنسيق XML)<Results>
<SearchResponse>
<SearchHeader>
<SuccessCode>0</SuccessCode>
<DomainName>mydomain.com</DomainName>
<Available>yes</Available>
<Price>77.00 in USD</Price>
</SearchHeader>
</SearchResponse>
<SearchResponse>
<SearchHeader>
<SuccessCode>0</SuccessCode>
<DomainName>mydomain.net</DomainName>
<Available>yes</Available>
<Price>44.00 in USD and domain is not premium</Price>
</SearchHeader>
</SearchResponse>
</Results> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
الاستجابة (تنسيق JSON){
"SearchResponse":{
"ResponseCode":"0",
"SearchResults":[
{
"DomainName":"mydomain.com",
"Available":"yes",
"Price":"77.00 in USD"
},
{
"DomainName":"mydomain.net",
"Available":"yes",
"Price":"44.00 in USD"
}
]
}
} أمر تسجيل
استدعاء أمر التسجيل سينشئ ويعالج طلب تسجيل. يجب أن يكون لديك رصيد حساب كافٍ لدفع ثمن الطلب. إذا قمت باستدعاء أمر التسجيل، يجب تضمين المعلمات التالية:
معلمة طلب التسجيلشرح
معلمة طلب التسجيل
شرح
domainاسم النطاق الذي تريد تسجيله, يمكن تسجيل نطاق واحد فقط لكل طلب
language (optional)علامة اللغة للنطاق المطلوب, تكون مطلوبة فقط إذا كان النطاق IDN
durationكم مدة تسجيل النطاق
registrant_contact (optional)جهة اتصال المسجل التي تريد استخدامها على النطاق
admin_contact (optional)جهة الاتصال الإدارية التي تريد استخدامها على النطاق
technical_contact (optional)جهة الاتصال الفنية التي تريد استخدامها للنطاق
billing_contact (optional)جهة اتصال الفوترة التي تريد استخدامها على النطاق
option0 (if necessary)
اسم المسجّل في .AT, .BE
option1 (if necessary).AT, .BE, منظمة المسجّل (اختياري)
بالنسبة لـ .AT، يمكنك تحديد إما option0، أو option1، أو كليهما
premium (optional)إذا أردت تسجيل نطاق بريميوم، فاضبطه على "1" (اختياري)
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<RegisterResponse></RegisterResponse>وسم استجابة التسجيل
<RegisterHeader></RegisterHeader>وسم ترويسة التسجيل
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<RegisterContent></RegisterContent>وسم محتوى التسجيل
<Expiration></Expiration>تاريخ الانتهاء بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"
<Registration></Registration>تاريخ التسجيل بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"
تسجيل مثال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=register&domain=domain1.net&duration=3¤cy=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=register&domain=domain1.net&duration=3¤cy=USD
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<RegisterResponse>
<RegisterHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RegisterHeader>
<RegisterContent>
<Expiration>1458379145266</Expiration>
</RegisterContent>
</RegisterResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=register&domain=domain1.net&duration=3¤cy=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=register&domain=domain1.net&duration=3¤cy=USD
الاستجابة (تنسيق JSON){
"RegisterResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainName": "domain1.net",
"Expiration": 1458379145266
}
} أمر الحذف
سيؤدي استدعاء الأمر delete إلى حذف نطاق لا يزال في فترة السماح. سيتم إعادة رصيد حسابك بقيمة رسوم التسجيل. النطاقات التي تم تجديدها, أو التي تم نقلها إلى حساب جديد لا يمكن حذفها عبر API. إذا قمت باستدعاء الأمر delete, يجب تضمين المعاملات التالية:
معلمة طلب الحذفشرح
معلمة طلب الحذف
شرح
domainاسم النطاق الذي تريد حذفه، يمكن حذف نطاق واحد فقط لكل طلب
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DeleteResponse></DeleteResponse>وسم استجابة الحذف
<DeleteHeader></DeleteHeader>وسم رأس الحذف
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال الحذف
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete&domain=domain1.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete&domain=domain1.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<DeleteResponse>
<DeleteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteHeader>
</DeleteResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete&domain=domain1.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete&domain=domain1.com
الاستجابة (تنسيق JSON){
"DeleteResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainName": "domain1.com"
}
} أمر التجديد
سيؤدي استدعاء أمر التجديد إلى إنشاء طلب تجديد ومعالجته. يجب أن يكون لديك رصيد حساب كافٍ لدفع ثمن الطلب. عند استدعاء أمر التجديد, يجب تضمين المعلمات التالية:
معامل طلب التجديدشرح
معامل طلب التجديد
شرح
domainاسم النطاق الذي تريد تجديده, يمكن تجديد نطاق واحد فقط لكل طلب
durationعدد السنوات لتجديد النطاق
year (optional)السنة الحالية التي ينتهي فيها النطاق
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
price_check (optional)يمكنك إضافة هذه المعلمة إلى الأمر للتحقق من تفاصيل سعر تجديد هذا النطاق. ملاحظة: عند إضافة هذه المعلمة إلى الأمر، لن تقوم واجهة api الخاصة بنا بتجديد النطاق، بل ستعرض معلومات السعر فقط.
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
no_renew_if_late_renew_fee_needed (optional)يمكنك إضافة هذا المعامل إلى الأمر لتجنب التجديد إذا كان النطاق يتطلب رسوم تجديد متأخرة. إذا كان النطاق يتطلب بالفعل رسوم تجديد متأخرة لتجديده, وتم تمرير "no_renew_if_late_renew_fee_needed = 1" في الأمر, فلن يتم تجديد النطاق.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<RenewResponse></RenewResponse>وسم استجابة التجديد، وهو العقدة الجذرية لمستند XML للاستجابة
<RenewHeader></RenewHeader>ترويسة التجديد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<PriceInfo></PriceInfo>وسم معلومات السعر, يُستخدم فقط عندما تكون الحالة "price_check_success"
<RenewContent></RenewContent>وسم محتوى التجديد, يُستخدم فقط عندما تكون الحالة "success"
<Expiration></Expiration>تاريخ الانتهاء بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"
مثال على التجديد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
الاستجابة (تنسيق XML)<RenewResponse>
<RenewHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RenewHeader>
<RenewContent>
<Expiration>73984579834</Expiration>
</RenewContent>
</RenewResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
الاستجابة (تنسيق JSON){
"RenewResponse":{
"ResponseCode":"0",
"Status":"success",
"DomainName":"domain1.com",
"Expiration":"73984579834"
}
} أمر الدفع
سيؤدي استدعاء أمر الدفع إلى إنشاء طلب دفع ومعالجته. يجب عليك إلغاء قفل نطاقك وحسابك من أجل الطلب. يحتاج حساب المستلم إلى رفض/قبول النطاق لإكمال الطلب. إذا قمت باستدعاء أمر الدفع, يجب تضمين المعلمات التالية:
معلمة طلب الدفعشرح
معلمة طلب الدفع
شرح
domainاسم النطاق الذي تريد نقله. ندعم أيضًا النقل الجماعي, يمكنك استخدام ";" لفصل النطاقات. مثال: domain1.com;domain2.com
receiver_push_usernameاسم مستخدم Push لحساب المستلم
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
unlock_domain_for_push(optional)اضبط هذه المعلمة على "1". إذا كان النطاق مقفلًا، فسنقوم بإلغاء قفله تلقائيًا، لذا لا تحتاج إلى إلغاء قفل النطاق يدويًا
receiver_email(optional)البريد الإلكتروني لحساب المستلم
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<PushResponse></PushResponse>وسم استجابة push, إنه العقدة الجذرية لمستند XML للاستجابة
<PushHeader></PushHeader>ترويسة الدفع
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال الدفع
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
الاستجابة (تنسيق XML)<PushResponse>
<PushHeader>
<SuccessCode>0</SuccessCode>
<Status>order created</Status>
</PushHeader>
</PushResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
الاستجابة (تنسيق JSON){
"PushResponse":{
"ResponseCode":"0",
"Status":"order created"
}
} أمر النقل
استدعاء أمر النقل سيُنشئ ويعالج طلب نقل. قد تتطلب بعض النطاقات العلوية (TLDs) تأكيدًا من المسجل الخاسر لإتمام الطلب. إذا استدعيت أمر النقل، يجب تضمين المعاملات التالية:
معامل طلب النقلشرح
معامل طلب النقل
شرح
domainاسم النطاق الذي تريد نقله إلى Dynadot، يمكن نقل نطاق واحد فقط لكل طلب
authرمز التفويض لطلب النقل.
currency (optional)يمكنك تحديد نوع العملة، والمعاملات المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وهكذا. إذا فاتك هذا المعامل، فسنستخدم العملة الافتراضية للحساب.
registrant_contact (optional)جهة اتصال المسجل التي تريد استخدامها عند اكتمال النقل. (ليست كل النطاقات العلوية تدعم هذه الميزة)
admin_contact (optional)جهة اتصال المشرف التي تريد استخدامها عند اكتمال النقل. (ليست كل نطاقات tld تدعم هذه الميزة)
technical_contact (optional)جهة الاتصال التقنية التي تريد استخدامها عند اكتمال النقل. (ليست كل النطاقات العلوية تدعم هذه الميزة)
billing_contact (optional)جهة اتصال الفوترة التي تريد استخدامها عند اكتمال النقل. (ليست كل النطاقات العلوية تدعم هذه الميزة)
premium (optional)إذا كنت تريد نقل نطاق مميز، فاضبطه على "1" (اختياري)
privacy (optional)حالة الخصوصية للنطاق الذي تريد ضبطها, يمكن أن تكون "on" أو "off". سيتم تطبيق مستوى الخصوصية الافتراضي للحساب إذا تم إدخال قيمة غير صحيحة أو لم يتم إدخال شيء
name_servers (optional)قائمة خوادم الأسماء التي سيتم تطبيقها على النطاق بعد اكتمال النقل. يمكنك استخدام "," لفصل خوادم الأسماء. مثال: ns1.domain1.com,ns2.domain2.com
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<TransferResponse></TransferResponse>وسم استجابة النقل, إنه العقدة الجذرية لمستند XML للاستجابة
<TransferHeader></TransferHeader>عنوان النقل
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على النقل
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<TransferResponse>
<TransferHeader>
<SuccessCode>0</SuccessCode>
<Status>order created</Status>
<DomainName>domain1.com</DomainName>
<OrderId>1234567</OrderId>
</TransferHeader>
</TransferResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
الاستجابة (تنسيق JSON){
"TransferResponse": {
"ResponseCode": 0,
"Status": "order created",
"DomainName": "domain1.com",
"OrderId": "1234567"
}
} أمر التسجيل بالجملة
استدعاء أمر التسجيل بالجملة سيؤدي إلى إنشاء ومعالجة طلبات التسجيل. يجب أن يكون لديك رصيد كافٍ في الحساب لدفع ثمن الطلبات. إذا كنت تستدعي أمر التسجيل بالجملة، يجب تضمين المعلمات التالية:
معامل طلب التسجيل الجماعيشرح
معامل طلب التسجيل الجماعي
شرح
domain0-domain99أسماء النطاقات التي تريد تسجيلها، يمكن تسجيل 100 نطاق كحد أقصى لكل طلب
premium (optional)إذا أردت تسجيل نطاق بريميوم، فاضبطه على "1" (اختياري)
currency (optional)يمكنك تحديد نوع العملة، وقيم هذه المعلمة المدعومة هي "USD","CNY", "GBP","EUR","INR","CAD" وهكذا. إذا فاتتك هذه المعلمة، فسنستخدم العملة الافتراضية للحساب
coupon (optional)رمز الكوبون الذي تريد تطبيقه على هذا الأمر
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<BulkRegisterResponse></BulkRegisterResponse>وسم استجابة التسجيل الجماعي
<BulkRegisterHeader></BulkRegisterHeader>وسم رأس التسجيل الجماعي
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<BulkRegisterContent></BulkRegisterContent>وسم محتوى التسجيل بالجملة
<Expiration></Expiration>تاريخ الانتهاء بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)، يُستخدم فقط عندما تكون النتيجة "success"
<Result></Result>نتيجة إجراء التسجيل
<Message></Message>رسالة خطأ لإجراء التسجيل، تُستخدم فقط عندما تكون النتيجة "error"
مثال على التسجيل بالجملة
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
<BulkRegisterHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BulkRegisterHeader>
<BulkRegisterContent>
<BulkRegister>
<RegisterResult>
<DomainName>domain0.com</DomainName>
<Expiration>1234567890</Expiration>
<Result>success</Result>
<Message>-</Message>
</RegisterResult>
<RegisterResult>
<DomainName>domain1.com</DomainName>
<Expiration>-</Expiration>
<Result>error</Result>
<Message>not_available</Message>
</RegisterResult>
</BulkRegister>
</BulkRegisterContent>
</BulkRegisterResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
الاستجابة (تنسيق JSON){
"BulkRegisterResponse": {
"ResponseCode": 0,
"Status": "success",
"BulkRegister": [
{
"DomainName": "domain0.com",
"Expiration": "1234567890",
"Result": "success",
"Message": "-"
},
{
"DomainName": "domain1.com",
"Expiration": "-",
"Result": "error",
"Message": "not_available"
}
]
}
} أمر معلومات النطاق
هذا الأمر متاح فقط بصيغة XML و JSON:
معامل طلب معلومات النطاقشرح
معامل طلب معلومات النطاق
شرح
domainيُسمح بنطاق واحد فقط لكل طلب
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DomainInfoResponse></DomainInfoResponse>العقدة الجذرية لمستند XML للاستجابة
<DomainInfoResponseHeader></DomainInfoResponseHeader>ترويسة الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<DomainInfoContent></DomainInfoContent>محتوى الاستجابة
<Domain></Domain>نطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء صلاحية النطاق بتوقيت Unix (عدد المللي ثانية منذ منتصف ليل 1 يناير 1970 بتوقيت UTC)
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء للنطاق
<Type></Type>نوع خادم الأسماء للنطاق
<WithAds></WithAds>إذا كنت تريد صفحة إيقاف مؤقت لنطاقك
<Whois></Whois>معلومات Whois
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرّف جهة الاتصال
<Admin></Admin>معلومات المسؤول
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>حالة التمكين
<UdrpLocked></UdrpLocked>Udrp مقفل أم لا
<UdrpLocked></UdrpLocked>Udrp مقفل أم لا
<RegistrantUnverified></RegistrantUnverified>المسجل غير موثق
<Hold></Hold>حالة إيقاف العميل/المسجل
<Privacy></Privacy>حالة الخصوصية
<isForSale></isForSale>حالة البيع
<RenewOption></RenewOption>خيار التجديد
<Note></Note>ملاحظة
<Folder></Folder>معلومات المجلد
<FolderId></FolderId>معرّف المجلد
<FolderName></FolderName>اسم المجلد
مثال معلومات النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=domain_info&domain=domain1.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=domain_info&domain=domain1.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<DomainInfoResponse>
<DomainInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</DomainInfoHeader>
<DomainInfoContent>
<Domain>
<Name>domain1.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>0</ContactId>
</Registrant>
<Admin>
<ContactId>0</ContactId>
</Admin>
<Technical>
<ContactId>0</ContactId>
</Technical>
<Billing>
<ContactId>0</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>yes</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
<Status>active</Status>
</Domain>
</DomainInfoContent>
</DomainInfoResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=domain_info&domain=domain1.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=domain_info&domain=domain1.com
الاستجابة (تنسيق JSON){
"DomainInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainInfo": {
"Name": "domain1.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "0"
},
"Admin": {
"ContactId": "0"
},
"Technical": {
"ContactId": "0"
},
"Billing": {
"ContactId": "0"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "yes",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
},
"Status": "active"
}
}
} أمر تعيين Whois
إذا قمت باستدعاء أمر set Whois، فيجب تضمين المعاملات التالية:
تعيين معامل طلب Whoisشرح
تعيين معامل طلب Whois
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
registrant_contactمعلومات المُسجِّل الخاصة بالنطاق
admin_contactمعلومات المسؤول عن النطاق
technical_contactالمعلومات التقنية للنطاق
billing_contactمعلومات الفوترة الخاصة بالنطاق
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetWhoisResponse></SetWhoisResponse>العقدة الجذرية لمستند XML للاستجابة
<SetWhoisHeader></SetWhoisHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين Whois
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق XML)<SetWhoisResponse>
<SetWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetWhoisHeader>
</SetWhoisResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق JSON){
"SetWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين خوادم الأسماء
عند استدعاء أمر تعيين خوادم الأسماء، يجب تضمين المعاملات التالية:
معامل طلب تعيين خوادم الأسماءشرح
معامل طلب تعيين خوادم الأسماء
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
ns0 - ns12خوادم الأسماء التي تريد تعيين نطاقك لاستخدامها، يمكنك تحديد حتى 13 خادم أسماء، ولكن يجب أن تكون موجودة بالفعل في حسابك
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetNsResponse></SetNsResponse>علامة استجابة تعيين خادم الأسماء, إنها العقدة الجذرية لوثيقة XML للاستجابة
<SetNsHeader></SetNsHeader>وسم ترويسة استجابة تعيين خادم الأسماء
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال لتعيين NS
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetNsResponse>
<SetNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNsHeader>
</SetNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
الاستجابة (تنسيق JSON){
"SetNsResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر تعيين الإيقاف
عند استدعاء أمر تعيين الباركينغ, يجب تضمين المعلمات التالية:
تعيين معامل طلب الركنشرح
تعيين معامل طلب الركن
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
with_ads (optional)إذا كنت لا تريد إعلانات طرف ثالث، يمكنك استخدام هذه المعلمة مع "no"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetParkingResponse></SetParkingResponse>وسم استجابة set parking، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة
<SetParkingHeader></SetParkingHeader>تعيين رأس مجلد الإيقاف
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين الركن
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_parking&domain=domain1.com&with_ads=no
الاستجابة (تنسيق XML)<SetParkingResponse>
<SetParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetParkingHeader>
</SetParkingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_parking&domain=domain1.com&with_ads=no
الاستجابة (تنسيق JSON){
"SetParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين إعادة التوجيه
إذا كنت تستدعي أمر تعيين إعادة التوجيه، فيجب تضمين المعلمات التالية:
معامل طلب تعيين إعادة التوجيهشرح
معامل طلب تعيين إعادة التوجيه
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
forward_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح. is_temp (optional)حالة إعادة التوجيه للنطاق الذي تريده، القيمة الافتراضية هي "temporary"، وإذا كنت تريد إعادة التوجيه بشكل دائم، استخدم هذه المعلمة مع "no"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetForwardingResponse></SetForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetForwardingHeader></SetForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على إعداد إعادة التوجيه
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
الاستجابة (تنسيق XML)<SetForwardingResponse>
<SetForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetForwardingHeader>
</SetForwardingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
الاستجابة (تنسيق JSON){
"SetForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} تعيين أمر التخفي
عند استدعاء أمر set stealth, يجب تضمين المعاملات التالية:
ضبط معامل طلب التخفيشرح
ضبط معامل طلب التخفي
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
stealth_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح. stealth_title (optional)عنوان الصفحة
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetStealthResponse></SetStealthResponse>العقدة الجذرية لمستند XML للاستجابة
<SetStealthHeader></SetStealthHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين التخفي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق XML)<SetStealthResponse>
<SetStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetStealthHeader>
</SetStealthResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق JSON){
"SetStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين الاستضافة
إذا استدعيت أمر تعيين الاستضافة، فيجب تضمين المعاملات التالية:
معامل طلب تعيين الاستضافةشرح
معامل طلب تعيين الاستضافة
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
hosting_typeنوع الاستضافة التي تريدها، يمكنك الاختيار بين "advanced" و"basic"
mobile_view_onفقط عندما يكون hosting_type هو "advanced"، يمكنك استخدام هذا المعامل كـ "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetHostingResponse></SetHostingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetHostingHeader></SetHostingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين الاستضافة
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
الاستجابة (تنسيق XML)<SetHostingResponse>
<SetHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetHostingHeader>
</SetHostingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
الاستجابة (تنسيق JSON){
"SetHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر ضبط DNS2
إذا قمت باستدعاء الأمر set DNS2, فيجب تضمين المعاملات التالية:
يرجى ملاحظة أن تنفيذ الأمر SET_DNS2 سيؤدي افتراضيًا إلى الكتابة فوق إعدادات DNS الحالية. لتغيير هذا السلوك وإلحاق إعدادات DNS الجديدة بدلاً من ذلك، يمكنك استخدام المعامل الاختياري add_dns_to_current_setting.
تعيين معامل طلب DNS2شرح
تعيين معامل طلب DNS2
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
main_record_type0 - main_record_type19 (optional)نوع السجل الرئيسي، يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email"
main_record0 - main_record19حدد سجل DNS لنطاقك
main_recordx0 - main_recordx19مسافة Mx, نوع إعادة التوجيه(301 كـ "1", 302 كـ "2"), عنوان إعادة التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني, ضروري عندما يكون main_record_type هو "forward","mx","stealth","email".
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي (اختياري)
sub_record_type0 - sub_record_type99نوع سجل النطاق الفرعي، يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "srv"، "mx"، "stealth"، "email"
sub_record0 - sub_record99عنوان IP للنطاق الفرعي أو المضيف الهدف
sub_recordx0 - sub_recordx99مسافة Mx, نوع التحويل, عنوان التحويل المتخفي أو الاسم المستعار للبريد الإلكتروني, مطلوب عندما يكون main_record_type هو "forward","mx","stealth","email"
ttl (optional)مدة البقاء
add_dns_to_current_setting (optional)إذا كنت تريد إلحاق إعدادات DNS الجديدة بإعدادات Dns الموجودة. اضبطها على "1" (اختياري)
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDnsResponse></SetDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDnsHeader></SetDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين DNS2
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
<SetDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDnsHeader>
</SetDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
الاستجابة (تنسيق JSON){
"SetDnsResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر تعيين DNSSEC
استدعاء أمر Set Dnssec سيضبط dnssec للنطاق. هذا الأمر متاح فقط بتنسيق XML و JSON. إذا استدعيت هذا الأمر، يجب تضمين المعلمات التالية:
يمكنك اختيار تعبئة قيم المعاملات المقابلة في الخيار بناءً على اسم النطاق الخاص بك.
الخيار 1 : domain_name , key_tag , digest_type , digest , algorithm
الخيار 2 : domain_name , flags , public_key , algorithm
ملاحظات: يرجى اختيار رقم التسمية المقابلة كقيمة للمعامل الخاص بك إن وُجد.
معلمة طلب Set Dnssecشرح
معلمة طلب Set Dnssec
شرح
domain_nameاسم النطاق الذي تحتاج إلى إعداد DNSSEC له
key_tagوسم المفتاح
digest_typeيمكنك اختيار رقم من القائمة التالية ليمثل نوع التوقيع الرقمي الخاص بك: SHA-1(1) SHA-256(2) GOSTR 34.11-94 (3) SHA-384(4)
digestيرجى إدخال القيمة المقابلة لنوع الملخص الذي اخترته
algorithmيمكنك اختيار رقم من القائمة التالية لتمثيل خوارزمية التوقيع الرقمي الخاصة بك: RSA/MD5(1) Diffie-Hellman (2) DSA/SHA-1(3) Elliptic Curve (4) RSA/SHA-1(5) DSA-NSEC3-SHA1(6) RSASHA1-NSEC3-SHA1(7) RSA/SHA-256(8) RSA/SHA-512(10) GOSTR 34.10-2001(12) ECDSA Curve P-256 with SHA-256(13 ECDSA Curve P-384 with SHA-384(14) ED25519(15 ED448(16) Indirect (252) Private DNS (253 Private OID (254)
flagsيمكنك اختيار رقم من القائمة التالية ليمثل رمز توقيعك الرقمي: ZSK(256) KSK(257)
public_keyيجب أن يكون المفتاح العام بترميز base64.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDnssecResponse></SetDnssecResponse>العقدة الجذرية للاستجابة
<SetDnssecHeader></SetDnssecHeader>تعيين ترويسة Dnssec
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال إعداد Dnssec
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetDnssecResponse>
<SetDnssecHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDnssecHeader>
<SetDnssecContent/>
</SetDnssecResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
الاستجابة (تنسيق JSON){
"SetDnssecResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر إزالة Dnssec
سيؤدي استدعاء أمر إزالة Dnssec إلى إزالة Dnssec من النطاق. هذا الأمر متاح فقط بتنسيق XML وJSON. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:
معلمة طلب مسح Dnssecشرح
معلمة طلب مسح Dnssec
شرح
domain_nameاسم النطاق الذي تحتاج إلى إزالة Dnssec منه
مثال إزالة Dnssec
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=clear_dnssec&domain_name=domain-haha1.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=clear_dnssec&domain_name=domain-haha1.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<ClearDnssecResponse>
<ClearDnssecHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ClearDnssecHeader>
</ClearDnssecResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=clear_dnssec&domain_name=domain-haha1.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=clear_dnssec&domain_name=domain-haha1.com
الاستجابة (تنسيق JSON){
"ClearDnssecResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر تعيين إعادة توجيه البريد الإلكتروني
عند استدعاء الأمر set email forward، يجب تضمين المعلمات التالية:
تعيين معامل طلب إعادة توجيه البريد الإلكترونيشرح
تعيين معامل طلب إعادة توجيه البريد الإلكتروني
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
forward_typeنوع التحويل, يمكن أن يكون "donot": عدم تحويل البريد الإلكتروني, "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX), "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم, يُستخدم فقط عندما تكون "forward_type" هي "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الموجود، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هو أعلى أولوية، يُستخدم فقط عندما يكون "forward_type" هو "mx"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetEmailForwardingResponse></SetEmailForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetEmailForwardingHeader></SetEmailForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إعادة توجيه البريد الإلكتروني
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&
[email protected] طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&
[email protected] الاستجابة (تنسيق XML)<SetEmailForwardingResponse>
<SetEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetEmailForwardingHeader>
</SetEmailForwardingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&
[email protected] طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&
[email protected] الاستجابة (تنسيق JSON){
"SetEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر Set Clear Domain Setting
إذا قمت باستدعاء أمر set clear domain setting، فيجب تضمين المعاملات التالية:
معامل طلب تعيين إعداد تفريغ النطاقشرح
معامل طلب تعيين إعداد تفريغ النطاق
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، "dnssec"، و "nameservers"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetClearDomainSettingResponse></SetClearDomainSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetClearDomainSettingHeader></SetClearDomainSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إعداد مسح النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
الاستجابة (تنسيق XML)<SetClearDomainSettingResponse>
<SetClearDomainSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearDomainSettingHeader>
</SetClearDomainSettingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
الاستجابة (تنسيق JSON){
"SetClearDomainSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين المجلد
إذا استدعيت الأمر set folder, فيجب تضمين المعاملات التالية:
تعيين معامل طلب المجلدشرح
تعيين معامل طلب المجلد
شرح
domainاسم النطاق المراد تحديثه, يمكن تعيين نطاق واحد فقط لكل طلب
folderاسم المجلد الذي تريد نقل نطاقك إليه. استخدم "Default" كاسم للمجلد إذا أردت نقل النطاق إلى المجلد الافتراضي. اسم المجلد حساس لحالة الأحرف. على سبيل المثال، "Folder1" و"folder1" هما اسمان مختلفان لمجلدين.
folder_id (optional)معرّف المجلد الذي تريد نقل نطاقك إليه
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderResponse></SetFolderResponse>وسم استجابة تعيين المجلد, إنه العقدة الجذرية لمستند XML للاستجابة
<SetFolderHeader></SetFolderHeader>تعيين رأس المجلد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال ضبط المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder&domain=domian1.com&folder=folder1
الاستجابة (تنسيق XML)<SetFolderResponse>
<SetFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHeader>
</SetFolderResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder&domain=domian1.com&folder=folder1
الاستجابة (تنسيق JSON){
"SetFolderResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين الملاحظة
إذا قمت باستدعاء أمر set note، فيجب تضمين المعلمات التالية:
معامل طلب تعيين ملاحظةشرح
معامل طلب تعيين ملاحظة
شرح
domainالنطاق الذي تريد تعيينه، يمكن تعيين نطاق واحد فقط لكل طلب
noteملاحظة تريد تعيينها للنطاق، يمكن أن تكون فارغة
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetNoteResponse></SetNoteResponse>العقدة الجذرية لمستند XML للاستجابة
<SetNoteHeader></SetNoteHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين ملاحظة
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_note&domain=domain1.com¬e=Do not modify any information
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_note&domain=domain1.com¬e=Do not modify any information
الاستجابة (تنسيق XML)<SetNoteResponse>
<SetNoteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNoteHeader>
</SetNoteResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_note&domain=domain1.com¬e=Do not modify any information
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_note&domain=domain1.com¬e=Do not modify any information
الاستجابة (تنسيق JSON){
"SetNoteResponse":{
"ResponseCode":"0",
"Status":"success"
}
} تعيين خيار التجديد
عند استدعاء أمر تعيين خيار التجديد، يجب تضمين المعلمات التالية:
تعيين معامل طلب خيار التجديدشرح
تعيين معامل طلب خيار التجديد
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
renew_optionيمكن أن يكون "donot"، "auto"، "reset"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetRenewOptionResponse></SetRenewOptionResponse>العقدة الجذرية لمستند XML للاستجابة
<SetRenewOptionHeader></SetRenewOptionHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين خيار التجديد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetRenewOptionResponse>
<SetRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetRenewOptionHeader>
</SetRenewOptionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
الاستجابة (تنسيق JSON){
"SetRenewOptionResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر تعيين الخصوصية
إذا كنت تستدعي أمر set privacy، يجب تضمين المعلمات التالية:
تعيين معلمة طلب الخصوصيةشرح
تعيين معلمة طلب الخصوصية
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
optionحالة الخصوصية للنطاق الذي تريد ضبطها, يمكن أن تكون "full", "partial", أو "off"
whois_privacy_optionحالة خصوصية whois للنطاق الذي تريد تعيينه, يمكن أن تكون "yes" أو "no"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetPrivacyResponse></SetPrivacyResponse>العقدة الجذرية لمستند XML للاستجابة
<SetPrivacyHeader></SetPrivacyHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين الخصوصية
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
الاستجابة (تنسيق XML)<SetPrivacyResponse>
<SetPrivacyHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetPrivacyHeader>
</SetPrivacyResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
الاستجابة (تنسيق JSON){
"SetPrivacyResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أسعار TLD
هذه الميزة متاحة فقط بصيغة XML و JSON:
معامل طلب أسعار Tldشرح
معامل طلب أسعار Tld
شرح
currency (optional)عملة نتيجة الإرجاع، يجب أن تكون "usd"، "eur"، أو "cny"، والعملة الافتراضية هي Api Default Currency في إعدادات الحساب
count_per_page (optional)كم عدد الكيانات التي تُعرض في كل صفحة
page_index (optional)كيانات أي صفحة تريد عرضها؟
sort (optional)يرجى تحديد أحد الخيارات التالية كقيمة لمعامل الفرز:
* إذا لم تختره، فسنستخدم الترتيب الافتراضي.
1) ترتيب تصاعدي (افتراضي)
2) وصف الترتيب
3) الاسم تصاعدي
4) الاسم والوصف
5) SalesAsc
6) وصف المبيعات
7) تاريخ الإطلاق تصاعديًا
8) وصف تاريخ الإطلاق
9) CountAsc
10) CountDesc
11) RegistryAsc
12) وصف السجل
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<TldPriceResponse></TldPriceResponse>العقدة الجذرية لمستند XML للاستجابة
<TldPriceResponseHeader></TldPriceResponseHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<TldPriceContent></TldPriceContent>محتوى الاستجابة
<TldContent></TldContent>معلومات Tld
<Tld></Tld>نطاقات المستوى الأعلى
<Usage></Usage>استخدام امتداد النطاق
<Price></Price>معلومات السعر لهذا tld. تحتوي على وسوم فرعية:
: وحدة السعر
: سعر التسجيل
: سعر التجديد
: سعر النقل
<Privacy></Privacy>إذا كان هذا tld يدعم خصوصية whois
<GracePeriod></GracePeriod>معلومات فترة السماح لهذا النطاق العلوي. تحتوي على وسوم فرعية:
: معلومات وحدة فترة السماح
: فترة سماح للتجديد
: حذف فترة السماح
<IDN></IDN>إذا كان هذا الـ tld يدعم أسماء النطاقات الدولية
<Restrictions></Restrictions>اسم النطاق
مثال أسعار النطاقات العلوية
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=tld_price¤cy=USD
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=tld_price¤cy=USD
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
<TldPriceResponseHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<PriceLevel>Regular Pricing</PriceLevel>
<Currency>USD</Currency>
</TldPriceResponseHeader>
<TldPriceContent>
<TldContent>
<Tld>com</Tld>
<Usage>General</Usage>
<Price>
<Unit>(Price/1 year)</Unit>
<Register>15.00</Register>
<Renew>15.00</Renew>
<Transfer>15.00</Transfer>
<Restore>10.00</Restore>
</Price>
<Privacy>10.00</Privacy>
<GracePeriod>
<Unit>10.00</Unit>
<Renew>10.00</Renew>
<Delete>30</Delete>
<Restore>YES</Restore>
</GracePeriod>
<IDN>YES</IDN>
<Restrictions>--</Restrictions>
<OnSale>Yes</OnSale>
<maxDuration>10</maxDuration>
<minDuration>1</minDuration>
</TldContent>
</TldPriceContent>
</TldPriceResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=tld_price¤cy=USD
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=tld_price¤cy=USD
الاستجابة (تنسيق JSON){
"TldPriceResponse": {
"ResponseCode": 0,
"Status": "success",
"PriceLevel": "Regular Pricing",
"Currency": "USD",
"TldPrice": [
{
"Tld": "com",
"Usage": "General",
"IDN": "YES",
"Restrictions": "--",
"OnSale": "Yes",
"Privacy": "10.00",
"Price": {
"Unit": "(Price/1 year)",
"Register": "15.00",
"Renew": "15.00",
"Transfer": "15.00",
"Restore": "10.00"
},
"GracePeriod": {
"Unit": "10.00",
"Renew": "10.00",
"Delete": "30",
"Restore": "YES"
},
"maxDuration": 10,
"minDuration": 1
}
]
}
} أمر عرض النطاقات
هذه الميزة متاحة فقط بصيغة XML و JSON:
معلمة طلب قائمة النطاقاتشرح
معلمة طلب قائمة النطاقات
شرح
customer_id (optional)تصفية البيانات حسب معرّف العميل (يمكن للموزعين فقط استخدام هذا المعامل)
count_per_page (optional)كم عدد الكيانات التي تُعرض في كل صفحة
page_index (optional)كيانات أي صفحة تريد عرضها؟
sort (optional)يرجى تحديد أحد الخيارات التالية كقيمة لمعامل الفرز:
* إذا لم تختره، فسنستخدم الترتيب الافتراضي.
1) عدّ تصاعدي (افتراضي)
2) عدد تنازلي
3) الاسم تصاعدي
4) الاسم والوصف
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<ListDomainInfoResponse></ListDomainInfoResponse>العقدة الجذرية لمستند XML للاستجابة
<ListDomainInfoHeader></ListDomainInfoHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ListDomainInfoContent></ListDomainInfoContent>محتوى الاستجابة
<DomainInfoList></DomainInfoList>قائمة معلومات النطاق
<DomainInfo></DomainInfo>معلومات النطاق
<Domain></Domain>نطاق
<Name></Name>اسم النطاق
<Expiration></Expiration>تاريخ انتهاء صلاحية النطاق بتوقيت Unix (عدد المللي ثانية منذ منتصف ليل 1 يناير 1970 بتوقيت UTC)
<Registration></Registration>تاريخ تسجيل النطاق بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع إعداد خادم الأسماء
<WithAds></WithAds>مع إعلانات أم لا
<Whois></Whois>معلومات Whois
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرّف جهة الاتصال
<Admin></Admin>معلومات المسؤول
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>حالة التمكين
<Hold></Hold>حالة إيقاف العميل/المسجل
<Privacy></Privacy>حالة الخصوصية
<isForSale></isForSale>حالة البيع
<RenewOption></RenewOption>خيار التجديد
<Note></Note>ملاحظة
<Folder></Folder>معلومات المجلد
<FolderId></FolderId>معرّف المجلد
<FolderName></FolderName>اسم المجلد
مثال سرد النطاقات
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=list_domain
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=list_domain
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<ListDomainInfoResponse>
<ListDomainInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ListDomainInfoHeader>
<ListDomainInfoContent>
<DomainInfoList>
<DomainInfo>
<Domain>
<Name>domain-exp140.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>0</ContactId>
</Registrant>
<Admin>
<ContactId>0</ContactId>
</Admin>
<Technical>
<ContactId>0</ContactId>
</Technical>
<Billing>
<ContactId>0</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>no</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
<Status>active</Status>
</Domain>
<Domain>
<Name>domain-exp141.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>1</ContactId>
</Registrant>
<Admin>
<ContactId>2</ContactId>
</Admin>
<Technical>
<ContactId>3</ContactId>
</Technical>
<Billing>
<ContactId>4</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>no</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
<Status>moved</Status>
</Domain>
</DomainInfo>
</DomainInfoList>
</ListDomainInfoContent>
</ListDomainInfoResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=list_domain
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=list_domain
الاستجابة (تنسيق JSON){
"ListDomainInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"MainDomains": [
{
"Name": "domain-exp140.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "0"
},
"Admin": {
"ContactId": "0"
},
"Technical": {
"ContactId": "0"
},
"Billing": {
"ContactId": "0"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "no",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
},
"Status": "active"
},
{
"Name": "domain-exp141.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "1"
},
"Admin": {
"ContactId": "2"
},
"Technical": {
"ContactId": "3"
},
"Billing": {
"ContactId": "4"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "no",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
},
"Status": "moved"
}
]
}
} أمر قفل النطاق
إذا قمت باستدعاء الأمر lock domain، فيجب تضمين المعاملات التالية:
معامل طلب قفل النطاقشرح
معامل طلب قفل النطاق
شرح
domainاسم النطاق الذي تريد قفله، يمكن إدخال نطاق واحد فقط لكل طلب
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<LockDomainResponse></LockDomainResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<LockDomainHeader></LockDomainHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال قفل النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=lock_domain&domain=domain4.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=lock_domain&domain=domain4.com
الاستجابة (تنسيق XML)<LockDomainResponse>
<LockDomainHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</LockDomainHeader>
</LockDomainResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=lock_domain&domain=domain4.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=lock_domain&domain=domain4.com
الاستجابة (تنسيق JSON){
"LockDomainResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر البحث عن الاقتراحات
سيؤدي استدعاء أمر البحث عن الاقتراحات إلى شراء اسم النطاق المحدد. هذا الأمر متاح فقط بصيغة XML وJSON. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب البحث عن الاقتراحاتشرح
معامل طلب البحث عن الاقتراحات
شرح
domainالنطاق الذي تريد البحث عنه، يمكن إدخال نطاق واحد فقط لكل طلب
tlds (optional)النطاقات العلوية التي تقتصر عليها نتيجة البحث
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SuggestionSearchResponse></SuggestionSearchResponse>وسم استجابة البحث عن الاقتراحات، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة
<SuggestionSearchHeader></SuggestionSearchHeader>ترويسة البحث عن الاقتراحات
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على البحث بالاقتراحات
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SuggestionSearchResponse>
<SuggestionSearchHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SuggestionSearchHeader>
<SuggestionSearchContent>
<SuggestionSearch>
<Domain>test1.com</Domain>
<Domain>test2.com</Domain>
<Domain>test3.net</Domain>
<Domain>test4.net</Domain>
</SuggestionSearch>
</SuggestionSearchContent>
</SuggestionSearchResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=suggestion_search&domain=domain.com&action=com,net
الاستجابة (تنسيق JSON){
"SuggestionSearchResponse": {
"ResponseCode": 0,
"Status": "success",
"Domains": [
"test1.com",
"test2.com",
"test3.net",
"test4.net"
]
}
} أمر إلغاء النقل
يسمح لك الأمر بإلغاء عنصر نقل في الطلب. عند استدعاء أمر إلغاء النقل، يجب تضمين المعلمات التالية:
معامل طلب إلغاء النقلشرح
معامل طلب إلغاء النقل
شرح
domainاسم النطاق الذي تريد إلغاء نقل ملكيته, يمكن إدخال نطاق واحد فقط لكل طلب
order_idمعرّف أمر النقل, يمكنك الحصول عليه من واجهة برمجة تطبيقات أخرى get_transfer_status.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<CancelTransferResponse></CancelTransferResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<CancelTransferHeader></CancelTransferHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال إلغاء النقل
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=cancel_transfer&domain=domain4.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=cancel_transfer&domain=domain4.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<CancelTransferResponse>
<CancelTransferHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CancelTransferHeader>
</CancelTransferResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=cancel_transfer&domain=domain4.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=cancel_transfer&domain=domain4.com
الاستجابة (تنسيق JSON){
"CancelTransferResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر الحصول على حالة النقل
إذا قمت باستدعاء أمر get transfer status، فيجب تضمين المعلمات التالية:
معلمة طلب الحصول على حالة النقلشرح
معلمة طلب الحصول على حالة النقل
شرح
domainاسم النطاق الذي تريد الحصول على حالة النقل له، يمكن إدخال نطاق واحد فقط في كل طلب
transfer_typeنوع النقل الذي تريد الحصول على حالة النقل له (نقل داخل أو نقل خارج)
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetTransferStatusResponse></GetTransferStatusResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetTransferStatusHeader></GetTransferStatusHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetTransferStatusContent></GetTransferStatusContent>محتوى الاستجابة
<TransferList></TransferList>قائمة النقل
<Transfer></Transfer>معلومات النقل
<OrderId></OrderId>معرّف الطلب
<TransferStatus></TransferStatus>حالة نقل النطاق. إذا حصلت على 'none' أو 'approved'، يمكنك إلغاء النقل. إذا حصلت على 'waiting'، فهذا يعني أن النقل قد بدأ بالفعل. إذا حصلت على 'auth code needed'، فهذا يعني رمز تفويض غير صالح، يمكنك استخدام واجهة API أخرى SET_TRANSFER_AUTH لإعادة إرسال رمز التفويض. هناك أيضًا بعض الحالات الأخرى، سنرسل لك بريدًا إلكترونيًا أو تحتاج إلى فحصها من قبل مهندسينا.
مثال الحصول على حالة النقل
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetTransferStatusResponse>
<GetTransferStatusHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetTransferStatusHeader>
<GetTransferStatusContent>
<TransferList>
<Transfer>
<OrderId>testorderid</OrderId>
<TransferStatus>teststatus</TransferStatus>
</Transfer>
<Transfer>
<OrderId>testorderid2</OrderId>
<TransferStatus>teststatus2</TransferStatus>
</Transfer>
</TransferList>
</GetTransferStatusContent>
</GetTransferStatusResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
الاستجابة (تنسيق JSON){
"GetTransferStatusResponse": {
"ResponseCode": 0,
"Status": "success",
"TransferList": [
{
"OrderId": "testorderid",
"TransferStatus": "teststatus"
},
{
"OrderId": "testorderid2",
"TransferStatus": "teststatus2"
}
]
}
} أمر تعيين رمز تفويض النقل لأمر النقل
الأمر الذي يسمح لك بتحديث رمز المصادقة لمعالجة طلبات النقل. عند استدعاء أمر set transfer auth code، يجب تضمين المعلمات التالية:
تعيين معلمة طلب رمز تفويض النقلشرح
تعيين معلمة طلب رمز تفويض النقل
شرح
domainاسم النطاق الذي تقوم بتحديث تفويض النقل له، يمكن إدخال نطاق واحد فقط لكل طلب.
auth_codeauth_code الذي تريد إعادة إرساله
order_idمعرّف أمر النقل, يمكنك الحصول عليه من واجهة برمجة تطبيقات أخرى get_transfer_status.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetTransferStatusResponse></GetTransferStatusResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetTransferStatusHeader></GetTransferStatusHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين رمز تفويض النقل
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
الاستجابة (تنسيق XML)<SetTransferAuthCodeResponse>
<SetTransferAuthCodeHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
الاستجابة (تنسيق JSON){
"SetTransferAuthCodeResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تفويض النقل بعيدًا
معامل طلب تفويض النقل بعيدًاشرح
معامل طلب تفويض النقل بعيدًا
شرح
domainاسم النطاق الذي تريد التصريح بنقله بعيدًا، يمكن إدخال نطاق واحد فقط لكل طلب
order_idorder_id الخاص بـ Dynadot للنطاق الذي تريد نقله بعيداً
authorizeللسماح بنقل النطاق خارجًا، اضبطه على "approve". ولرفض نقل النطاق خارجًا، اضبطه على "deny".
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<AuthorizeTransferAwayResponse></AuthorizeTransferAwayResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<AuthorizeTransferAwayHeader></AuthorizeTransferAwayHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<Result></Result>نتيجة تفويض نقل النطاق إلى مسجل آخر
مثال على تفويض النقل إلى الخارج
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<AuthorizeTransferAwayResponse>
<AuthorizeTransferAwayHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<Result>away_approved</Result>
</AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
الاستجابة (تنسيق JSON){
"AuthorizeTransferAwayResponse": {
"ResponseCode": 0,
"Status": "success",
"Result": "away_approved"
}
} أمر الحصول على رمز تفويض النقل
يجب عليك إلغاء قفل نطاقك وحسابك قبل طلب رمز التفويض.
معامل طلب الحصول على رمز تفويض النقلشرح
معامل طلب الحصول على رمز تفويض النقل
شرح
domainاسم النطاق الذي تريد الحصول على رمز تفويض النقل الخاص به، يمكن إدخال نطاق واحد فقط في كل طلب
new_code (optional)توليد رمز تفويض نقل جديد
unlock_domain_for_transfer (Optional. Requires api skip lock agreement to use)إذا كنت تريد إلغاء قفل النطاق للنقل، اضبطه على "1". إذا تمت معالجة الطلب بنجاح، فسيتم إلغاء قفل النطاق.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetTransferAuthCodeResponse></GetTransferAuthCodeResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetTransferAuthCodeHeader></GetTransferAuthCodeHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<AuthCode></AuthCode>يُستخدم رمز المصادقة لبدء نقل النطاق.
مثال الحصول على رمز تفويض النقل
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetTransferAuthCodeResponse>
<GetTransferAuthCodeHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<AuthCode>testauthcode</AuthCode>
</GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
الاستجابة (تنسيق JSON){
"GetTransferAuthCodeResponse": {
"ResponseCode": 0,
"Status": "success",
"AuthCode": "testauthcode"
}
} أمر الحصول على طلب دفع النطاق
استدعاء الأمر Get Domain Push Request سيحصل على طلب دفع النطاق. هذا الأمر متاح فقط بتنسيق XML و JSON.
معلمة طلب الحصول على طلب دفع النطاقشرح
معلمة طلب الحصول على طلب دفع النطاق
شرح
N/A
لا حاجة إلى معامل إضافي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetDomainPushRequestResponse></GetDomainPushRequestResponse>العقدة الجذرية للاستجابة
<GetDomainPushRequestHeader></GetDomainPushRequestHeader>ترويسة طلب الحصول على Domain Push
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetDomainPushRequestContent></GetDomainPushRequestContent>محتوى الاستجابة
<PushDomain></PushDomain>دفع النطاق
<PushDomainName></PushDomainName>دفع اسم النطاق
مثال على طلب نقل النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_domain_push_request
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_domain_push_request
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetDomainPushRequestResponse>
<GetDomainPushRequestHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetDomainPushRequestHeader>
<GetDomainPushRequestContent>
<PushDomain>
<PushDomainName>haha.com</PushDomainName>
</PushDomain>
<PushDomain>
<PushDomainName>haha1.com</PushDomainName>
</PushDomain>
</GetDomainPushRequestContent>
</GetDomainPushRequestResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_domain_push_request
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_domain_push_request
الاستجابة (تنسيق JSON){
"GetDomainPushRequestResponse": {
"ResponseCode": 0,
"Status": "success",
"pushDomainName": "[haha.com,haha1.com]"
}
} أمر تعيين طلب دفع النطاق
استدعاء أمر تعيين طلب دفع النطاق سيؤدي إلى تعيين طلب دفع النطاق. هذا الأمر متاح فقط بتنسيق XML و JSON. إذا استدعيت هذا الأمر، يجب تضمين المعلمات التالية:
معامل طلب تعيين دفع النطاقشرح
معامل طلب تعيين دفع النطاق
شرح
domainsاسم النطاق الخاص بالطلب المراد معالجته
actionإجراء الطلب المراد معالجته، يمكنك اختيار "accept" أو "decline"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDomainPushRequestResponse></SetDomainPushRequestResponse>العقدة الجذرية للاستجابة
<SetDomainPushRequestHeader></SetDomainPushRequestHeader>ترويسة طلب تعيين دفع النطاق
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال طلب نقل النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetDomainPushRequestResponse>
<SetDomainPushRequestHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetDomainPushRequestHeader>
<SetDomainPushRequestContent/>
</SetDomainPushRequestResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
الاستجابة (تنسيق JSON){
"SetDomainPushRequestResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر إنشاء تدقيق CN
يتيح لك الأمر إنشاء تدقيق CN لجهة اتصال. عند استدعاء الأمر create cn audit، يجب تضمين المعاملات التالية:
معامل طلب إنشاء تدقيق CNشرح
معامل طلب إنشاء تدقيق CN
شرح
contact_idمعرّف سجل جهة الاتصال الذي تريد بدء التدقيق له، يمكن إدخال معرّف جهة اتصال واحد فقط لكل طلب
contact_typeنوع جهة الاتصال, يمكن أن يكون "Individual" أو "Enterprise"
individual_id_typeنوع هوية الشخص الطبيعي، القيم المتوقعة (وصف القيمة) هي:
JGZ (بطاقة هوية ضابط في جمهورية الصين الشعبية)
SFZ (بطاقة الهوية لجمهورية الصين الشعبية)
HZ (جواز السفر)
GAJMTX (تصريح الخروج والدخول للسفر من وإلى هونغ كونغ وماكاو)
TWJMTX (تصاريح سفر لمقيمي تايوان لدخول البر الرئيسي أو مغادرته)
WJLSFZ (بطاقة الهوية الدائمة للأجانب من جمهورية الصين الشعبية)
GAJZZ (تصريح إقامة لهونغ كونغ وماكاو)
TWJZZ (تصريح إقامة لمقيمي تايوان)
QT (أخرى)
individual_license_idرقم رخصة هوية الشخص الطبيعي
individual_urlمستند رخصة الهوية لشخص طبيعي. رابط الملف على الخادم. يُسمح فقط بـ jpg, gif, png, jpeg
enterprise_id_type (Mandatory when contact type is "Enterprise")نوع معرّف المؤسسة, القيم المتوقعة (وصف القيمة) هي:
ORG (شهادة رمز المنظمة)
YYZZ (رخصة تجارية)
TYDM (شهادة رمز الائتمان الاجتماعي الموحد)
BDDM (تسمية الرمز العسكري)
JDDWFW (رخصة الخدمات الخارجية العسكرية المدفوعة)
SYDWFR (شهادة الشخص الاعتباري لمؤسسة عامة)
WGCZJG (نموذج تسجيل المكاتب التمثيلية المقيمة للشركات الأجنبية)
SHTTFR (شهادة تسجيل الشخص الاعتباري لمنظمة اجتماعية)
ZJCS (شهادة تسجيل موقع الأنشطة الدينية)
MBFQY (شهادة تسجيل كيان خاص غير مؤسسي)
JJHFR (شهادة تسجيل الشخص الاعتباري للصندوق)
LSZY (رخصة ممارسة شركة محاماة)
WGZHWH (شهادة تسجيل مركز ثقافي أجنبي في الصين)
WLCZJG (شهادة تسجيل الموافقة للمكتب التمثيلي المقيم لإدارات السياحة الحكومية الأجنبية)
SFJD (رخصة الخبرة القضائية)
JWJG (شهادة مؤسسة خارجية)
SHFWJG (شهادة تسجيل وكالة الخدمات الاجتماعية)
MBXXBX (تصريح مدرسة خاصة)
YLJGZY (ترخيص مزاولة المؤسسة الطبية)
GZJGZY (رخصة مزاولة منظمة التوثيق)
BJWSXX (تصريح مدرسة بكين لأطفال موظفي السفارات الأجنبية في الصين)
QTTYDM (أخرى-شهادة رمز الائتمان الاجتماعي الموحد)
QT (أخرى)
enterprise_license_id (Mandatory when contact type is "Enterprise")رقم ترخيص وثيقة المؤسسة
enterprise_url (Mandatory when contact type is "Enterprise")مستند ترخيص المؤسسة. رابط الملف على الخادم. يُسمح فقط بـ jpg، gif، png، jpeg
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<CreateCnAuditResponse></CreateCnAuditResponse>العقدة الجذرية لمستند XML للاستجابة
<CreateCnAuditHeader></CreateCnAuditHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على إنشاء تدقيق Cn
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<CreateCnAuditResponse>
<CreateCnAuditHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CreateCnAuditHeader>
</CreateCnAuditResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
الاستجابة (تنسيق JSON){
"CreateCnAuditResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر جلب حالة تدقيق Cn
عند استدعاء الأمر get cn audit status، يجب تضمين المعاملات التالية:
معامل طلب الحصول على حالة تدقيق Cnشرح
معامل طلب الحصول على حالة تدقيق Cn
شرح
contact_idمعرّف سجل جهة الاتصال الذي تريد الحصول على حالة التدقيق له، يمكن إدخال contactId واحد فقط لكل طلب
gtldإذا كنت تستعلم عن نتيجة التدقيق لـ cnnic-gtld، عيّن هذه المعلمة إلى 1
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetCnAuditStatusResponse></GetCnAuditStatusResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetCnAuditStatusHeader></GetCnAuditStatusHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<CnAuditStatus></CnAuditStatus>حالة تدقيق سجل تدقيق cnnic. قد تحصل على 'قيد المعالجة' أو 'في انتظار cnnic' أو 'فشل'. إذا فشل، سنرسل لك بريدًا إلكترونيًا.
<FailedReason></FailedReason>إذا تعذّر اجتياز التدقيق, فسيتم عرض سبب الفشل
مثال على جلب حالة تدقيق Cn
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_cn_audit_status&contact_id=testcontactid
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
<GetCnAuditStatusHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<CnAuditStatus>pass</CnAuditStatus>
</GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_cn_audit_status&contact_id=testcontactid
الاستجابة (تنسيق JSON){
"GetCnAuditStatusResponse": {
"ResponseCode": "0",
"Status": "success",
"CnAuditStatus": "pass"
}
} أمر إنشاء جهة اتصال
عند استدعاء أمر إنشاء جهة اتصال، يجب تضمين المعلمات التالية:
معامل طلب إنشاء جهة اتصالشرح
معامل طلب إنشاء جهة اتصال
شرح
organization (optional)معلومات المنظمة
nameالمصطلح
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز الدولة لرقم الهاتف
faxnum (optional)رقم الفاكس
faxcc (optional)رمز الدولة للفاكس
address1العنوان1
address2 (optional)العنوان 2
cityالمدينة
state (optional)الحالة
zipالرمز البريدي
countryالبلد
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<CreateContactResponse></CreateContactResponse>العقدة الجذرية لمستند XML للاستجابة
<CreateContactHeader></CreateContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<CreateContactContent></CreateContactContent>معرّف جهة الاتصال الجديد, يُستخدم فقط عندما تكون الحالة "success"
مثال لإنشاء جهة اتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_contact&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_contact&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
الاستجابة (تنسيق XML)<CreateContactResponse>
<CreateContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CreateContactHeader>
<CreateContactContent>
<ContactId>1234</ContactId>
</CreateContactContent>
</CreateContactResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_contact&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_contact&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
الاستجابة (تنسيق JSON){
"CreateContactResponse":{
"ResponseCode":"0",
"Status":"success",
"CreateContactContent":{
"ContactId":"0"
}
}
} أمر تحرير جهة الاتصال
عند استدعاء أمر تعديل جهة الاتصال، يجب تضمين المعاملات التالية:
معلمة طلب تعديل جهة الاتصالشرح
معلمة طلب تعديل جهة الاتصال
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
organization (optional)معلومات المنظمة
nameالمصطلح
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز الدولة لرقم الهاتف
faxnum (optional)رقم الفاكس
faxcc (optional)رمز الدولة للفاكس
address1العنوان 1
address2 (optional)العنوان 2
cityالمدينة
stateالحالة
zipالرمز البريدي
countryالبلد
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<EditContactResponse></EditContactResponse>العقدة الجذرية لمستند XML للاستجابة
<EditContactHeader></EditContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<EditContactContent></EditContactContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال
مثال تعديل جهة الاتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<EditContactResponse>
<EditContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</EditContactHeader>
<EditContactContent>
<ContactId>0</ContactId>
</EditContactContent>
</EditContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
الاستجابة (تنسيق JSON){
"EditContactResponse": {
"ResponseCode": "0",
"Status": "success",
"EditContactContent": {
"ContactId": "0"
}
}
} طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
الاستجابة (تنسيق CSV)ok,
success,
,
أمر حذف جهة الاتصال
إذا كنت تستدعي أمر حذف جهة الاتصال، فيجب تضمين المعلمات التالية:
معامل طلب حذف جهة الاتصالشرح
معامل طلب حذف جهة الاتصال
شرح
contact_idمعرف جهة الاتصال التي تريد حذفها, تأكد من فصلها بفواصل
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DeleteContactResponse></DeleteContactResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteContactHeader></DeleteContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال حذف جهة الاتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_contact&contact_id=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_contact&contact_id=0
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<DeleteContactResponse>
<DeleteContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteContactHeader>
</DeleteContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_contact&contact_id=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_contact&contact_id=0
الاستجابة (تنسيق JSON){
"DeleteContactResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر قائمة جهات الاتصال
هذا الأمر متاح فقط بصيغة XML و JSON:
معامل طلب قائمة جهات الاتصالشرح
معامل طلب قائمة جهات الاتصال
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<ContactListResponse></ContactListResponse>العقدة الجذرية لمستند XML للاستجابة
<ContactListHeader></ContactListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ContactListContent></ContactListContent>محتوى الاستجابة
<ContactList></ContactList>قائمة جهات الاتصال
<Contact></Contact>معلومات الاتصال
<ContactId></ContactId>معرف جهة الاتصال
<Organization></Organization>منظمة جهة الاتصال
<Name></Name>المصطلح
<Email></Email>البريد الإلكتروني
<PhoneCc></PhoneCc>رمز الدولة لرقم الهاتف
<PhoneNum></PhoneNum>رقم الهاتف
<FaxCc></FaxCc>رمز الدولة للفاكس
<FaxNum></FaxNum>رقم الفاكس
<Address1></Address1>العنوان 1
<Address2></Address2>العنوان 2
<City></City>المدينة
<State></State>الحالة
<ZipCode></ZipCode>الرمز البريدي
<Country></Country>البلد
<GtldVerified></GtldVerified>حالة التحقق من gTLD
مثال قائمة جهات الاتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=contact_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=contact_list
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
<ContactListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ContactListHeader>
<ContactListContent>
<ContactList>
<Contact>
<ContactId>0</ContactId>
<Organization/>
<Name>Jack tester</Name>
<Email></Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>test street</Address1>
<Address2/>
<City>Los Angeles</City>
<State>CA</State>
<ZipCode>90068</ZipCode>
<Country>US</Country>
<GtldVerified>no</GtldVerified>
</Contact>
<Contact>
<ContactId>1</ContactId>
<Organization/>
<Name>John tester</Name>
<Email></Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>123.456.7890</PhoneNum>
<FaxCc>1</FaxCc>
<FaxNum>123.456.7890</FaxNum>
<Address1>high Way first</Address1>
<Address2/>
<City>San Francisco</City>
<State>CA</State>
<ZipCode>90068</ZipCode>
<Country>US</Country>
<GtldVerified>yes</GtldVerified>
</Contact>
</ContactList>
</ContactListContent>
</ContactListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=contact_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=contact_list
الاستجابة (تنسيق JSON){
"ContactListResponse": {
"ResponseCode": 0,
"Status": "success",
"ContactList": [
{
"ContactId": "0",
"Organization": "",
"Name": "Jack tester",
"Email": "",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "test street",
"Address2": "",
"City": "Los Angeles",
"State": "CA",
"ZipCode": "90068",
"Country": "US",
"GtldVerified": "no"
},
{
"ContactId": "1",
"Organization": "",
"Name": "John tester",
"Email": "",
"PhoneCc": "1",
"PhoneNum": "123.456.7890",
"FaxCc": "1",
"FaxNum": "123.456.7890",
"Address1": "high Way first",
"Address2": "",
"City": "San Francisco",
"State": "CA",
"ZipCode": "90068",
"Country": "US",
"GtldVerified": "yes"
}
]
}
} أمر جلب جهة الاتصال
هذا الأمر متاح فقط بصيغة XML و JSON:
الحصول على معلمة طلب جهة الاتصالشرح
الحصول على معلمة طلب جهة الاتصال
شرح
contact_idمعرّف جهة الاتصال
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetContactResponse></GetContactResponse>العقدة الجذرية لمستند XML للاستجابة
<GetContactHeader></GetContactHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetContactContent></GetContactContent>محتوى الاستجابة
<Contact></Contact>معلومات الاتصال
<ContactId></ContactId>معرف جهة الاتصال
<Organization></Organization>منظمة جهة الاتصال
<Name></Name>المصطلح
<Email></Email>البريد الإلكتروني
<PhoneCc></PhoneCc>رمز الدولة لرقم الهاتف
<PhoneNum></PhoneNum>رقم الهاتف
<FaxCc></FaxCc>رمز الدولة للفاكس
<FaxNum></FaxNum>رقم الفاكس
<Address1></Address1>العنوان 1
<Address2></Address2>العنوان 2
<City></City>المدينة
<State></State>الحالة
<ZipCode></ZipCode>الرمز البريدي
<Country></Country>البلد
<GtldVerified></GtldVerified>حالة التحقق من gTLD
مثال الحصول على جهة الاتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_contact&contact_id=10000
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_contact&contact_id=10000
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetContactResponse>
<GetContactHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetContactHeader>
<GetContactContent>
<GetContact>
<Contact>
<ContactId>12345</ContactId>
<Organization>org</Organization>
<Name>name</Name>
<Email></Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>address1</Address1>
<Address2>address2</Address2>
<City>city</City>
<State>state</State>
<ZipCode>zipcode</ZipCode>
<Country>country</Country>
<GtldVerified>no</GtldVerified>
</Contact>
</GetContact>
</GetContactContent>
</GetContactResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_contact&contact_id=10000
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_contact&contact_id=10000
الاستجابة (تنسيق JSON){
"GetContactResponse": {
"ResponseCode": 0,
"Status": "success",
"GetContact": {
"ContactId": "12345",
"Organization": "org",
"Name": "name",
"Email": "",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "address1",
"Address2": "address2",
"City": "city",
"State": "state",
"ZipCode": "zipcode",
"Country": "country",
"GtldVerified": "no"
}
}
} أمر تعيين إعداد الاتصال بالاتحاد الأوروبي
عند استدعاء أمر تعيين إعداد جهة الاتصال في الاتحاد الأوروبي, يجب تضمين المعلمات التالية:
معامل طلب إعداد جهة الاتصال للاتحاد الأوروبيشرح
معامل طلب إعداد جهة الاتصال للاتحاد الأوروبي
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
country_of_citizenshipيجب أن تكون دولة عضو في الاتحاد الأوروبي. تتضمن رموز الدول الأعضاء ما يلي:
AT, BE, BG, HR, CY, CZ, DK, EE, FI, FR, DE, GR, HU, IS, IE, IT, LV, LI, LT, LU, MT, NL, NO, PL, PT, RO, SK, SI, ES, SE
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetContactEUSettingResponse></SetContactEUSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetContactEUSettingHeader></SetContactEUSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetContactEUSettingContent></SetContactEUSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال
مثال على إعداد جهة اتصال الاتحاد الأوروبي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
<SetContactEUSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactEUSettingHeader>
<SetContactEUSettingContent>
<ContactId>0</ContactId>
</SetContactEUSettingContent>
</SetContactEUSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
الاستجابة (تنسيق JSON){
"SetContactEUSettingResponse": {
"ResponseCode: ": "0",
"Status": "Success",
"SetContactEUSettingContent": {
"ContactId: ": "0"
}
}
} أمر تعيين إعداد LV لجهة الاتصال
إذا قمت باستدعاء أمر تعيين إعداد contact lv، فيجب تضمين المعلمات التالية:
تعيين معامل طلب إعداد LV لجهة الاتصالشرح
تعيين معامل طلب إعداد LV لجهة الاتصال
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
registration_number- بالنسبة للأفراد، يرجى إدخال رقم الهوية اللاتفي.
- بالنسبة للشركات والكيانات القانونية الأخرى، يرجى إدخال رقم التسجيل الصادر من سجل المؤسسات اللاتفي.
vat_number (optional)رقم ضريبة القيمة المضافة للكيانات القانونية الأجنبية المسجلة في دول الاتحاد الأوروبي (يشمل ذلك أيضًا الشركات اللاتفية)
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetContactLvSettingResponse></SetContactLvSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetContactLvSettingHeader></SetContactLvSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetContactLvSettingContent></SetContactLvSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال
مثال على إعداد تعيين مستوى جهة الاتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
<SetContactLvSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactLvSettingHeader>
<SetContactLvSettingContent>
<ContactId>0</ContactId>
</SetContactLvSettingContent>
</SetContactLvSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
الاستجابة (تنسيق JSON){
"SetContactLvSettingResponse": {
"ResponseCode": 0,
"Status": "success",
"SetContactLvSettingContent": {
"ContactId: ": "0"
}
}
} مثال على إعداد إعدادات جهة الاتصال LV
طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
الاستجابة (تنسيق CSV)ok,success,0
أمر تعيين إعداد LT لجهة الاتصال
إذا كنت تستدعي أمر تعيين إعداد LT لجهة الاتصال، فيجب تضمين المعاملات التالية:
معامل طلب تعيين إعداد LT لجهة الاتصالشرح
معامل طلب تعيين إعداد LT لجهة الاتصال
شرح
contact_idمعرّف جهة الاتصال التي تريد تعديلها
organization_codeلا يمكنك تعيين رمز مؤسسة جهة الاتصال إلا بعد تعيين مؤسسة جهة الاتصال.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetContactLtSettingResponse></SetContactLtSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetContactLtSettingHeader></SetContactLtSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetContactLtSettingContent></SetContactLtSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرّف جهة الاتصال
مثال على تعيين إعداد LT لجهة الاتصال
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetContactLtSettingResponse>
<SetContactLtSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactLtSettingHeader>
<SetContactLtSettingContent>
<ContactId>0</ContactId>
</SetContactLtSettingContent>
</SetContactLtSettingResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_contact_lt_setting&contact_id=0&organization_code=testing_organization_code
الاستجابة (تنسيق JSON){
"SetContactLtSettingResponse": {
"ResponseCode:": "0",
"Status": "Success",
"SetContactLtSettingContent": {
"ContactId": "0"
}
}
} أمر الحصول على خادم الأسماء
إذا استدعيت أمر get name server، فيجب تضمين المعاملات التالية:
معلمة طلب الحصول على خادم الأسماءشرح
معلمة طلب الحصول على خادم الأسماء
شرح
domainالنطاق الذي تريد الحصول على معلومات خادم الأسماء الخاص به, يمكن جلب معلومات خادم الأسماء لنطاق واحد فقط في كل طلب.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetNsResponse></GetNsResponse>العقدة الجذرية لمستند XML للاستجابة
<GetNsHeader></GetNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<NsContent></NsContent>محتوى الاستجابة
<Host></Host>اسم مضيف الخادم
<NsName></NsName>اسم الخادم
مثال الحصول على خوادم الأسماء
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_ns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_ns&domain=mydomain.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetNsResponse>
<GetNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetNsHeader>
<NsContent>
<Host>ns1.mydomain.com</Host>
<Host>ns2.mydomain.com</Host>
</NsContent>
</GetNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_ns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_ns&domain=mydomain.com
الاستجابة (تنسيق JSON){
"GetNsResponse": {
"ResponseCode": 0,
"Status": "success",
"NsContent": {
"Host0": "ns1.mydomain.com",
"Host1": "ns2.mydomain.com"
}
}
} أمر إضافة خادم أسماء
عند استدعاء أمر إضافة خادم الأسماء, يجب تضمين المعلمات التالية:
معامل طلب إضافة خادم الأسماءشرح
معامل طلب إضافة خادم الأسماء
شرح
hostاسم المضيف لخادم الأسماء الذي تريد إضافته
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<AddNsResponse></AddNsResponse>العقدة الجذرية لمستند XML للاستجابة
<AddNsHeader></AddNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<AddNsContent></AddNsContent>محتوى الاستجابة
<Server></Server>الخادم الذي قمت بتعيينه
<Host></Host>اسم مضيف الخادم الجديد
<ServerId></ServerId>معرّف الخادم الجديد
مثال على إضافة Ns
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_ns&host=ns1.mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_ns&host=ns1.mydomain.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<AddNsResponse>
<AddNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</AddNsHeader>
<AddNsContent>
<Server>
<Host>ns1.mydomain.com</Host>
<ServerId>0</ServerId>
</Server>
</AddNsContent>
</AddNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_ns&host=ns1.mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_ns&host=ns1.mydomain.com
الاستجابة (تنسيق JSON){
"AddNsResponse": {
"ResponseCode": 0,
"Status": "success",
"AddNsContent": {
"Server": {
"Host": "ns1.mydomain.com",
"ServerId": 0
}
}
}
} أمر تسجيل خادم الأسماء
إذا كنت تستدعي أمر تسجيل خادم الأسماء، فيجب تضمين المعلمات التالية:
معامل طلب تسجيل خادم الأسماءشرح
معامل طلب تسجيل خادم الأسماء
شرح
hostاسم المضيف لخادم الأسماء الخاص بك
ipعنوان IP لخادم الأسماء الخاص بك
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<RegisterNsResponse></RegisterNsResponse>العقدة الجذرية لمستند XML للاستجابة
<RegisterNsHeader></RegisterNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<RegisterNsContent></RegisterNsContent>محتوى الاستجابة
<Server></Server>وسم الخادم
<Host></Host>اسم المضيف
<ServerId></ServerId>معرف الخادم
مثال تسجيل خادم الأسماء
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
الاستجابة (تنسيق XML)<RegisterNsResponse>
<RegisterNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RegisterNsHeader>
<RegisterNsContent>
<Server>
<Host>domain1.com</Host>
<ServerId>0</ServerId>
</Server>
</RegisterNsContent>
</RegisterNsResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
الاستجابة (تنسيق JSON){
"RegisterNsResponse":{
"ResponseCode":"0",
"Status":"success",
"RegisterNsContent":{
"Server":{
"Host":"ndomain1.com",
"ServerId":"0"
}
}
}
} أمر تعيين IP خادم الأسماء
عند استدعاء الأمر set name server IP، يجب تضمين المعاملات التالية:
معامل طلب تعيين IP خادم الأسماءشرح
معامل طلب تعيين IP خادم الأسماء
شرح
server_idمعرّف خادم الأسماء الذي تريد تعيينه
ip0 - ip9عنوان IP الذي تريد تعيينه لخادم الأسماء, يمكن تعيين 9 عناوين IP لكل طلب ويجب فصلها بفواصل
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetNsIpResponse></SetNsIpResponse>العقدة الجذرية لمستند XML للاستجابة
<SetNsIpHeader></SetNsIpHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين IP خادم الأسماء
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
الاستجابة (تنسيق XML)<SetNsIpResponse>
<SetNsIpHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNsIpHeader>
</SetNsIpResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
الاستجابة (تنسيق JSON){
"SetNsIpResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر حذف خادم الأسماء
إذا كنت تستدعي أمر حذف خادم الأسماء, فيجب تضمين المعلمات التالية:
معامل طلب حذف خادم الأسماءشرح
معامل طلب حذف خادم الأسماء
شرح
server_idمعرّف خوادم الأسماء التي تريد حذفها، تأكد من فصلها بفواصل
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteNsHeader></DeleteNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال حذف Ns
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns&server_id=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_ns&server_id=0
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<DeleteNsResponse>
<DeleteNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteNsHeader>
</DeleteNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns&server_id=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_ns&server_id=0
الاستجابة (تنسيق JSON){
"DeleteNsResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر حذف خادم الأسماء حسب النطاق
إذا استدعيت أمر حذف خادم الأسماء حسب النطاق, يجب تضمين المعلمات التالية:
حذف خادم الأسماء بواسطة معامل طلب النطاقشرح
حذف خادم الأسماء بواسطة معامل طلب النطاق
شرح
server_domainاسم خادم الأسماء. مثال: ns1.testnameserver.com
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteNsHeader></DeleteNsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال حذف خادم الأسماء حسب النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
الاستجابة (تنسيق XML)<DeleteNsResponse>
<DeleteNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteNsHeader>
</DeleteNsResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
الاستجابة (تنسيق JSON){
"DeleteNsResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر قائمة الخوادم
هذا الأمر متاح فقط بصيغة XML و JSON:
معامل طلب قائمة الخوادمشرح
معامل طلب قائمة الخوادم
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجةشرح
وسم 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>IP الخادم
مثال قائمة الخوادم
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=server_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=server_list
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<ServerListResponse>
<ServerListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ServerListHeader>
<ServerListContent>
<NameServerList>
<List>
<Server>
<ServerId>0</ServerId>
<ServerName>ns1.com</ServerName>
</Server>
<Server>
<ServerId>1</ServerId>
<ServerName>domain1.com</ServerName>
<ServerIp>192.168.1.1</ServerIp>
<ServerIp>1.1.1.1</ServerIp>
</Server>
</List>
</NameServerList>
</ServerListContent>
</ServerListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=server_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=server_list
الاستجابة (تنسيق JSON){
"ServerListResponse": {
"ResponseCode": 0,
"Status": "success",
"ServerList": [
{
"ServerId": "0",
"ServerName": "ns1.com"
},
{
"ServerId": "1",
"ServerName": "domain1.com",
"ServerIps": [
{
"Ip": "192.168.1.1"
},
{
"Ip": "1.1.1.1"
}
]
}
]
}
} أمر الحصول على إعدادات خادم أسماء النطاق
إذا قمت باستدعاء أمر الحصول على إعدادات خوادم أسماء النطاق، يجب تضمين المعلمات التالية:
معامل طلب جلب إعدادات خادم أسماء النطاقشرح
معامل طلب جلب إعدادات خادم أسماء النطاق
شرح
domainالنطاق الذي تريد الحصول على إعداد خادم الأسماء الخاص به, يمكن سحب إعداد خادم الأسماء لنطاق واحد فقط لكل طلب.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetDnsResponse></GetDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<GetDnsHeader></GetDnsHeader>ترويسة الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetDnsContent></GetDnsContent>محتوى الاستجابة
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء للنطاق
<Type></Type>نوع خادم الأسماء للنطاق
مثال على جلب إعدادات خادم أسماء النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_dns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_dns&domain=mydomain.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetDnsResponse>
<GetDnsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetDnsHeader>
<GetDnsContent>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
</GetDnsContent>
</GetDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_dns&domain=mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_dns&domain=mydomain.com
الاستجابة (تنسيق JSON){
"GetDnsResponse": {
"ResponseCode": 0,
"Status": "success",
"GetDns": {
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
}
}
}
} أمر معلومات الحساب
هذا الأمر متاح فقط بصيغة XML و JSON:
معامل طلب معلومات الحسابشرح
معامل طلب معلومات الحساب
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجةشرح
وسم 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>Whois الافتراضي
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرف جهة الاتصال
<DefaultAdmin></DefaultAdmin>مسؤول افتراضي
<DefaultTechnical></DefaultTechnical>تقني افتراضي
<DefaultBilling></DefaultBilling>الفوترة الافتراضية
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع إعلانات أم لا
مثال على معلومات الحساب
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=account_info
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=account_info
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
<AccountInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</AccountInfoHeader>
<AccountInfoContent>
<AccountInfo>
<Username>testname</Username>
<ForumName>test forum name</ForumName>
<AvatarUrl>test avatar url</AvatarUrl>
<Contact>
<Organization/>
<Name>testname test</Name>
<Email></Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>1 test road</Address1>
<Address2/>
<City>Los Angeles</City>
<State>CA</State>
<ZipCode>90000</ZipCode>
<Country>US</Country>
</Contact>
<CustomerSince>1364888735253</CustomerSince>
<AccountLock>on</AccountLock>
<TotalSpending>$0.00</TotalSpending>
<PriceLevel>Regular Pricing</PriceLevel>
<AccountBalance>$70.02</AccountBalance>
<CustomTimeZone>PST</CustomTimeZone>
<DefaultSettings>
<DefaultWhois>
<DefaultRegistrant>
<ContactId>0</ContactId>
</DefaultRegistrant>
<DefaultAdmin>
<ContactId>0</ContactId>
</DefaultAdmin>
<DefaultTechnical>
<ContactId>0</ContactId>
</DefaultTechnical>
<DefaultBilling>
<ContactId>0</ContactId>
</DefaultBilling>
</DefaultWhois>
<DefaultNameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>yes</WithAds>
</DefaultNameServerSettings>
</DefaultSettings>
</AccountInfo>
</AccountInfoContent>
</AccountInfoResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=account_info
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=account_info
الاستجابة (تنسيق JSON){
"AccountInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"AccountInfo": {
"Username": "testname",
"ForumName": "test forum name",
"AvatarUrl": "test avatar url",
"Contact": {
"Organization": "",
"Name": "testname test",
"Email": "",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "1 test road",
"Address2": "",
"City": "Los Angeles",
"State": "CA",
"ZipCode": "90000",
"Country": "US"
},
"CustomerSince": "1364888735253",
"AccountLock": "on",
"TotalSpending": "$0.00",
"PriceLevel": "Regular Pricing",
"AccountBalance": "$70.02",
"CustomTimeZone": "PST",
"DefaultSettings": {
"DefaultWhois": {
"DefaultRegistrant": {
"ContactId": "0"
},
"DefaultAdmin": {
"ContactId": "0"
},
"DefaultTechnical": {
"ContactId": "0"
},
"DefaultBilling": {
"ContactId": "0"
}
},
"DefaultNameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "yes"
}
}
}
}
} أمر الحصول على رصيد الحساب
هذا الأمر متاح فقط بصيغة XML و JSON:
معامل طلب الحصول على رصيد الحسابشرح
معامل طلب الحصول على رصيد الحساب
شرح
N/Aلا حاجة إلى معامل إضافي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetAccountBalanceResponse></GetAccountBalanceResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetAccountBalanceHeader></GetAccountBalanceHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAccountBalanceContent></GetAccountBalanceContent>محتوى الاستجابة
<Balance></Balance>رصيد الحساب
مثال الحصول على رصيد الحساب
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_account_balance
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_account_balance
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetAccountBalanceResponse>
<GetAccountBalanceHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAccountBalanceHeader>
<GetAccountBalanceContent>
<BalanceList>
<Balance>
<Currency>USD</Currency>
<Amount>300.00</Amount>
</Balance>
</BalanceList>
</GetAccountBalanceContent>
</GetAccountBalanceResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_account_balance
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_account_balance
الاستجابة (تنسيق JSON){
"GetAccountBalanceResponse": {
"ResponseCode": 0,
"Status": "success",
"BalanceList": [
{
"Currency": "USD",
"Amount": "300.00"
}
]
}
} تعيين Whois الافتراضي
إذا تم استدعاء أمر تعيين Whois الافتراضي، فيجب تضمين المعلمات التالية:
تعيين معامل طلب Whois الافتراضيشرح
تعيين معامل طلب Whois الافتراضي
شرح
registrant_contactمعلومات المُسجِّل الخاصة بالنطاق
admin_contactمعلومات المسؤول عن النطاق
technical_contactالمعلومات التقنية للنطاق
billing_contactمعلومات الفوترة الخاصة بالنطاق
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultWhoisResponse></SetDefaultWhoisResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultWhoisHeader></SetDefaultWhoisHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين Whois الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق XML)<SetDefaultWhoisResponse>
<SetDefaultWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultWhoisHeader>
</SetDefaultWhoisResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق JSON){
"SetDefaultWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين خوادم الأسماء الافتراضية
عند استدعاء أمر تعيين خوادم الأسماء الافتراضية، يجب تضمين المعاملات التالية:
معامل طلب تعيين خوادم الأسماء الافتراضيةشرح
معامل طلب تعيين خوادم الأسماء الافتراضية
شرح
ns0 - ns12خوادم الأسماء التي تريد تعيينها
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultNsResponse></SetDefaultNsResponse>وسم استجابة تعيين خوادم الأسماء الافتراضية, إنه العقدة الجذرية لمستند XML للاستجابة
<SetDefaultNsHeader></SetDefaultNsHeader>وسم ترويسة تعيين خوادم الأسماء الافتراضية
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetDefaultNsContent></SetDefaultNsContent>وسم محتوى تعيين خوادم الأسماء الافتراضية, يُستخدم فقط عندما تكون الحالة "success"
<Servers></Servers>معلومات الخوادم التي قمت بتعيينها
<Server></Server>كل خادم
<ServerName></ServerName>اسم الخادم
<ServerId></ServerId>معرف الخادم
مثال تعيين Ns الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultNsResponse>
<SetDefaultNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultNsHeader>
<SetDefaultNsContent>
<Servers>
<Server>
<ServerName>ns1.hosts.com</ServerName>
<ServerId>0</ServerId>
</Server>
<Server>
<ServerName>ns2.hosts.com</ServerName>
<ServerId>1</ServerId>
</Server>
</Servers>
</SetDefaultNsContent>
</SetDefaultNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
الاستجابة (تنسيق JSON){
"SetDefaultNsResponse": {
"ResponseCode": 0,
"Status": "success",
"SetDefaultNsContent": {
"Servers": [
{
"ServerName": "ns1.hosts.com",
"ServerId": "0"
},
{
"ServerName": "ns2.hosts.com",
"ServerId": "1"
}
]
}
}
} أمر تعيين الباركينغ الافتراضي
إذا كنت تستدعي أمر تعيين الباركينغ الافتراضي، فيجب تضمين المعاملات التالية:
تعيين معلمة طلب الركن الافتراضيشرح
تعيين معلمة طلب الركن الافتراضي
شرح
with_ads (optional)إذا كنت لا تريد إعلانات طرف ثالث، يمكنك استخدام هذه المعلمة مع "no"، والقيمة الافتراضية هي "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultParkingResponse></SetDefaultParkingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultParkingHeader></SetDefaultParkingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين الإيقاف الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق XML)<SetDefaultParkingResponse>
<SetDefaultParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultParkingHeader>
</SetDefaultParkingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق JSON){
"SetDefaultParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين إعادة التوجيه الافتراضي
إذا كنت تستدعي أمر تعيين إعادة التوجيه الافتراضي، فيجب تضمين المعاملات التالية:
معامل طلب تعيين إعادة التوجيه الافتراضيشرح
معامل طلب تعيين إعادة التوجيه الافتراضي
شرح
forward_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح. is_temp (optional)حالة إعادة التوجيه للنطاق الذي تريده، القيمة الافتراضية هي "temporary"، وإذا كنت تريد إعادة التوجيه بشكل دائم، استخدم هذه المعلمة مع "no"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إعادة التوجيه الافتراضية
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
الاستجابة (تنسيق XML)<SetDefaultForwardingResponse>
<SetDefaultForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultForwardingHeader>
</SetDefaultForwardingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
الاستجابة (تنسيق JSON){
"SetDefaultForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين التخفي الافتراضي
عند استدعاء أمر تعيين التخفي الافتراضي، يجب تضمين المعاملات التالية:
تعيين معامل طلب التخفي الافتراضيشرح
تعيين معامل طلب التخفي الافتراضي
شرح
stealth_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح. stealth_title (optional)عنوان الصفحة
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultStealthResponse></SetDefaultStealthResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultStealthHeader></SetDefaultStealthHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال لتعيين Stealth الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق XML)<SetDefaultStealthResponse>
<SetDefaultStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultStealthHeader>
</SetDefaultStealthResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
الاستجابة (تنسيق JSON){
"SetDefaultStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين الاستضافة الافتراضية
عند استدعاء أمر تعيين الاستضافة الافتراضية، يجب تضمين المعلمات التالية:
تعيين معلمة طلب الاستضافة الافتراضيةشرح
تعيين معلمة طلب الاستضافة الافتراضية
شرح
hosting_typeنوع الاستضافة الافتراضية التي تريدها، يمكنك الاختيار ضمن "advanced" و"basic"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultHostingResponse></SetDefaultHostingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultHostingHeader></SetDefaultHostingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين الاستضافة الافتراضية
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_hosting&hosting_type=advanced
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_hosting&hosting_type=advanced
الاستجابة (تنسيق XML)<SetDefaultHostingResponse>
<SetDefaultHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultHostingHeader>
</SetDefaultHostingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_hosting&hosting_type=advanced
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_hosting&hosting_type=advanced
الاستجابة (تنسيق JSON){
"SetDefaultHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين DNS الافتراضي
إذا كنت تستدعي أمر تعيين DNS الافتراضي، فيجب تضمين المعلمات التالية:
( هذا الأمر قديم وغير موصى به، يُرجى استخدام أمر تعيين DNS2 الافتراضي بدلاً منه )
تعيين معامل طلب DNS الافتراضيشرح
تعيين معامل طلب DNS الافتراضي
شرح
main_record_typeنوع السجل الرئيسي
main_recordحدد سجل DNS لنطاقك
main_txt (optional)حدد سجل TXT لنطاقك. إذا كان main_record_type الخاص بك هو aaaa وحددت main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2, يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (optional)عنوان IP أو المضيف الهدف
mx_host0 - mx_host2 (optional)حدد مضيف البريد لنطاقك, distance0 هي الأولوية الأعلى.
mx_distance0 - mx_distance2 (optional)Distance0 له الأولوية القصوى
ttl (optional)مدة البقاء
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultDnsResponse></SetDefaultDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultDnsHeader></SetDefaultDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين DNS الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)<SetDefaultDnsResponse>
<SetDefaultDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultDnsHeader>
</SetDefaultDnsResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON){
"SetDefaultDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين DNS2 الافتراضي
إذا كنت تستدعي أمر تعيين DNS الافتراضي، فيجب تضمين المعلمات التالية:
معامل طلب تعيين DNS2 الافتراضيشرح
معامل طلب تعيين DNS2 الافتراضي
شرح
main_record_type0 - main_record_type19نوع السجل الرئيسي
main_record0 - main_record19حدد سجل DNS لنطاقك
main_recordx0 - main_recordx19مسافة Mx، ونوع التوجيه، وعنوان التوجيه المخفي أو اسم بريد إلكتروني مستعار، مطلوبة عندما تكون main_record هي "a", "aaaa", "cname", "forward", "txt", "mx", "stealth", "email"
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (optional)عنوان IP للنطاق الفرعي أو المضيف الهدف
sub_recordx0 - subdo_recordx99مسافة Mx، نوع إعادة التوجيه، عنوان إعادة التوجيه الخفي أو اسم بريد إلكتروني مستعار، ضروري عندما يكون sub_record_type هو "a"، "aaaa"، "cname"، "forward"، "txt"، "srv"، "mx"، "stealth"، "email"
ttl (optional)مدة البقاء
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultDnsResponse></SetDefaultDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultDnsHeader></SetDefaultDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين DNS2 الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)<SetDefaultDnsResponse>
<SetDefaultDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultDnsHeader>
</SetDefaultDnsResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON){
"SetDefaultDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين إعادة توجيه البريد الإلكتروني الافتراضي
عند استدعاء الأمر set default email forward، يجب تضمين المعاملات التالية:
معامل طلب تعيين إعادة توجيه البريد الإلكتروني الافتراضيشرح
معامل طلب تعيين إعادة توجيه البريد الإلكتروني الافتراضي
شرح
forward_typeنوع التحويل, يمكن أن يكون "donot": عدم تحويل البريد الإلكتروني, "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX), "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم, يُستخدم فقط عندما تكون "forward_type" هي "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الموجود، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هو أعلى أولوية، يُستخدم فقط عندما يكون "forward_type" هو "mx"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultEmailForwardingResponse></SetDefaultEmailForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultEmailForwardingHeader></SetDefaultEmailForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين إعادة توجيه البريد الإلكتروني الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&
[email protected] طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_email_forward&forward_type=forward&username0=test&
[email protected] الاستجابة (تنسيق XML)<SetDefaultEmailForwardingResponse>
<SetDefaultEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&
[email protected] طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_email_forward&forward_type=forward&username0=test&
[email protected] الاستجابة (تنسيق JSON){
"SetDefaultEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر Set Clear Default Setting
إذا قمت باستدعاء الأمر set clear default setting، فيجب تضمين المعلمات التالية:
تعيين معلمة طلب مسح الإعداد الافتراضيشرح
تعيين معلمة طلب مسح الإعداد الافتراضي
شرح
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، و "nameservers"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين مسح الإعداد الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_default_setting&service=nameservers
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_default_setting&service=nameservers
الاستجابة (تنسيق XML)<SetClearDefaultSettingResponse>
<SetClearDefaultSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_default_setting&service=nameservers
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_default_setting&service=nameservers
الاستجابة (تنسيق JSON){
"SetClearDefaultSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين خيار التجديد الافتراضي
إذا كنت تستدعي أمر تعيين خيار التجديد الافتراضي، يجب تضمين المعلمات التالية:
معامل طلب تعيين خيار التجديد الافتراضيشرح
معامل طلب تعيين خيار التجديد الافتراضي
شرح
renew_optionيمكن أن يكون "donot"، "auto"، "reset"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetDefaultRenewOptionResponse></SetDefaultRenewOptionResponse>العقدة الجذرية لمستند XML للاستجابة
<SetDefaultRenewOptionHeader></SetDefaultRenewOptionHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين خيار التجديد الافتراضي
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_renew_option&renew_option=auto
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_default_renew_option&renew_option=auto
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultRenewOptionResponse>
<SetDefaultRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_renew_option&renew_option=auto
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_default_renew_option&renew_option=auto
الاستجابة (تنسيق JSON){
"SetDefaultRenewOptionResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر إنشاء مجلد
عند استدعاء أمر إنشاء مجلد، يجب تضمين المعلمات التالية:
معلمة طلب إنشاء مجلدشرح
معلمة طلب إنشاء مجلد
شرح
folder_nameاسم المجلد الذي تريد إنشاؤه
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<FolderCreateResponse></FolderCreateResponse>العقدة الجذرية لمستند XML للاستجابة
<FolderCreateHeader></FolderCreateHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<FolderCreateContent></FolderCreateContent>محتوى الاستجابة
<FolderName></FolderName>اسم المجلد
<FolderId></FolderId>معرّف المجلد الجديد
مثال على إنشاء مجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=create_folder&folder_name=new
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=create_folder&folder_name=new
الاستجابة (تنسيق XML)<FolderCreateResponse>
<FolderCreateHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</FolderCreateHeader>
<FolderCreateContent>
<FolderName>new</FolderName>
<FolderId>1</FolderId>
</FolderCreateContent>
</FolderCreateResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=create_folder&folder_name=new
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=create_folder&folder_name=new
الاستجابة (تنسيق JSON){
"FolderCreateResponse":{
"ResponseCode":"0",
"Status":"success",
"FolderCreateContent":{
"FolderName":"new",
"FolderId":"1"
}
}
} أمر حذف المجلد
إذا قمت باستدعاء أمر set Whois، فيجب تضمين المعاملات التالية:
معامل طلب حذف المجلدشرح
معامل طلب حذف المجلد
شرح
folder_idمعرف المجلدات التي تريد حذفها، تأكد من أنها مفصولة بفواصل
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DeleteFolderResponse></DeleteFolderResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteFolderHeader></DeleteFolderHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال حذف مجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_folder&folder_id=0,1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_folder&folder_id=0,1
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<DeleteFolderResponse>
<DeleteFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteFolderHeader>
</DeleteFolderResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_folder&folder_id=0,1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_folder&folder_id=0,1
الاستجابة (تنسيق JSON){
"DeleteFolderResponse": {
"SuccessCode": 0,
"Status": "success"
}
} أمر تعيين Whois للمجلد
عند استدعاء أمر تعيين مجلد Whois، يجب تضمين المعاملات التالية:
معلمة طلب Whois لتعيين المجلدشرح
معلمة طلب Whois لتعيين المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
registrant_contactمعلومات المُسجِّل الخاصة بالنطاق
admin_contactمعلومات المسؤول عن النطاق
technical_contactالمعلومات التقنية للنطاق
billing_contactمعلومات الفوترة الخاصة بالنطاق
enable (optional)إذا كنت تريد تطبيق إعداد Whois هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد Whois هذا لجميع النطاقات في هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderWhoisResponse></SetFolderWhoisResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderWhoisHeader></SetFolderWhoisHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين Whois للمجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق XML)<SetFolderWhoisResponse>
<SetFolderWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderWhoisHeader>
</SetFolderWhoisResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
الاستجابة (تنسيق JSON){
"SetFolderWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين خوادم أسماء المجلد
عند استدعاء أمر set folder name servers, يجب تضمين المعلمات التالية:
معامل طلب تعيين خوادم أسماء المجلدشرح
معامل طلب تعيين خوادم أسماء المجلد
شرح
fold_idمعرف المجلد الذي تريد تعيينه، يمكن تعيين مجلد واحد فقط لكل طلب
ns0 - ns12خوادم الأسماء التي تريد تعيين نطاقك لاستخدامها، يمكنك تحديد حتى 13 خادم أسماء، ولكن يجب أن تكون موجودة بالفعل في حسابك
enable (optional)إذا كنت تريد تطبيق إعداد خوادم الأسماء هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد خادم الأسماء لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderNsResponse></SetFolderNsResponse>وسم استجابة خادم تعيين اسم المجلد، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة.
<SetFolderNsHeader></SetFolderNsHeader>علامة تعيين رأس استجابة خادم أسماء المجلد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<SetFolderNsContent></SetFolderNsContent>وسم محتوى استجابة خادم الأسماء للمجلد المحدد، يُستخدم فقط عندما تكون الحالة "success"
<Servers></Servers>معلومات الخوادم التي قمت بتعيينها
<Server></Server>كل خادم
<ServerName></ServerName>اسم الخادم
<ServerId></ServerId>معرف الخادم
مثال تعيين Ns للمجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetFolderNsResponse>
<SetFolderNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderNsHeader>
<SetFolderNsContent>
<Servers>
<Server>
<ServerName>ns1.hosts.com</ServerName>
<ServerId>0</ServerId>
</Server>
<Server>
<ServerName>ns2.hosts.com</ServerName>
<ServerId>1</ServerId>
</Server>
</Servers>
</SetFolderNsContent>
</SetFolderNsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
الاستجابة (تنسيق JSON){
"SetFolderNsResponse": {
"ResponseCode": 0,
"Status": "success",
"SetFolderNsContent": {
"Servers": [
{
"ServerName": "ns1.hosts.com",
"ServerId": "0"
},
{
"ServerName": "ns2.hosts.com",
"ServerId": "1"
}
]
}
}
} أمر تعيين إيقاف المجلد
إذا كنت تستدعي أمر تعيين مجلد الإيقاف, فيجب تضمين المعاملات التالية:
تعيين معامل طلب باركينغ المجلدشرح
تعيين معامل طلب باركينغ المجلد
شرح
folder_idمعرف المجلد الذي تريد تعيينه، يمكن تعيين مجلد واحد فقط لكل طلب
with_ads (optional)إذا كنت لا تريد إعلانات طرف ثالث، يمكنك استخدام هذه المعلمة مع "no"، والقيمة الافتراضية هي "yes"
enable (optional)إذا كنت تريد تطبيق إعداد الـ parking هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد الباركينغ لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderParkingResponse></SetFolderParkingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderParkingHeader></SetFolderParkingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على إعداد باركينغ المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق XML)<SetFolderParkingResponse>
<SetFolderParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderParkingHeader>
</SetFolderParkingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_parking&folder_id=0&with_ads=no
الاستجابة (تنسيق JSON){
"SetFolderParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين إعادة توجيه المجلد
عند استدعاء أمر تعيين إعادة توجيه المجلد، يجب تضمين المعلمات التالية:
معامل طلب تعيين إعادة توجيه المجلدشرح
معامل طلب تعيين إعادة توجيه المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
forward_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح. is_temp (optional)حالة إعادة التوجيه للنطاق الذي تريده، القيمة الافتراضية هي "temporary"، وإذا كنت تريد إعادة التوجيه بشكل دائم، استخدم هذه المعلمة مع "no"
enable (optional)إذا كنت تريد تطبيق إعداد إعادة التوجيه هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد, يمكنك استخدام هذا المعامل مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد إعادة التوجيه لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderForwardingResponse></SetFolderForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderForwardingHeader></SetFolderForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين إعادة توجيه المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
الاستجابة (تنسيق XML)<SetFolderForwardingResponse>
<SetFolderForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderForwardingHeader>
</SetFolderForwardingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
الاستجابة (تنسيق JSON){
"SetFolderForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين تخفي المجلد
إذا قمت باستدعاء أمر set folder stealth, فيجب تضمين المعلمات التالية:
تعيين معلمة طلب إخفاء المجلدشرح
تعيين معلمة طلب إخفاء المجلد
شرح
folder_idمعرف المجلد الذي تريد تعيينه
stealth_urlعنوان URL الذي تريد إعادة توجيه نطاقك إليه. يرجى ملاحظة أن المعامل يجب أن يكون مشفّر حتى يتم تفسير استدعاء API بشكل صحيح. stealth_title (optional)عنوان الصفحة
enable (optional)إذا كنت تريد تطبيق إعداد التخفي هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل بالقيمة "yes"
sync (optional)إذا كنت تريد مزامنة إعداد التخفي لجميع النطاقات في هذا المجلد, يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderStealthResponse></SetFolderStealthResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderStealthHeader></SetFolderStealthHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين التخفي للمجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
الاستجابة (تنسيق XML)<SetFolderStealthResponse>
<SetFolderStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderStealthHeader>
</SetFolderStealthResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
الاستجابة (تنسيق JSON){
"SetFolderStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين استضافة المجلد
إذا كنت تستدعي أمر تعيين مجلد الاستضافة، فيجب تضمين المعاملات التالية:
تعيين معلمة طلب استضافة المجلدشرح
تعيين معلمة طلب استضافة المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
hosting_typeنوع الاستضافة التي تريدها، يمكنك الاختيار بين "advanced" و"basic"
enable (optional)إذا كنت تريد تطبيق إعداد الاستضافة هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
even (optional)إذا كنت تريد مزامنة إعداد الاستضافة لجميع النطاقات في هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderHostingResponse></SetFolderHostingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderHostingHeader></SetFolderHostingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين استضافة المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
الاستجابة (تنسيق XML)<SetFolderHostingResponse>
<SetFolderHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHostingHeader>
</SetFolderHostingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
الاستجابة (تنسيق JSON){
"SetFolderHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين DNS للمجلد
عند استدعاء أمر تعيين DNS للمجلد، يجب تضمين المعلمات التالية:
( هذا الأمر قديم وغير موصى به, يُرجى استخدام الأمر Set Folder DNS2 بدلاً من ذلك )
معامل طلب تعيين DNS للمجلدشرح
معامل طلب تعيين DNS للمجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
main_record_typeنوع السجل الرئيسي
main_recordحدد سجل DNS لنطاقك
main_recordحدد سجل DNS لنطاقك
with_ads (optional)حدد سجل TXT لنطاقك. إذا كان main_record_type الخاص بك هو aaaa وحددت main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2, يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي (اختياري)
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي
sub_record0 - sub_record99 (optional)عنوان IP أو المضيف الهدف
mx_host0 - mx_host2 (optional)حدد مضيف البريد لنطاقك, distance0 هي الأولوية الأعلى.
mx_distance0 - mx_distance2 (optional)Distance0 هي أعلى أولوية
ttl (optional)مدة البقاء
enable (optional)إذا كنت تريد تطبيق إعداد DNS هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد, يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد خادم DNS هذا لكل النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderDnsHeader></SetFolderDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين DNS للمجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)<SetFolderDnsResponse>
<SetFolderDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderDnsHeader>
</SetFolderDnsResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON){
"SetFolderDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين مجلد DNS2
إذا كنت تستدعي الأمر set folder DNS2, فيجب تضمين المعاملات التالية:
تعيين معلمة طلب DNS2 للمجلدشرح
تعيين معلمة طلب DNS2 للمجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
main_record_type0 - main_record_type19نوع السجل الرئيسي، يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email"
main_record0 - main_record19حدد سجل DNS لنطاقك
main_recordx0 - main_recordx19مسافة Mx, نوع التحويل, عنوان التحويل المتخفي أو الاسم المستعار للبريد الإلكتروني, مطلوب عندما يكون main_record_type هو "forward","mx","stealth","email"
subdomain0 - subdomain99 (optional)سجلات النطاق الفرعي (اختياري)
sub_record_type0 - sub_record_type99 (optional)نوع سجلات النطاق الفرعي, يجب أن يكون "a", "aaaa", "cname", "forward", "txt", "srv", "mx", "stealth", "email"
sub_record0 - sub_record99 (optional)عنوان IP أو المضيف الهدف
sub_recordx0 - sub_recordx99 (optional)مسافة Mx، ونوع التوجيه، وعنوان التوجيه المخفي أو اسم بريد إلكتروني مستعار، مطلوبة عندما تكون sub_record_type هي "forward","mx","stealth","email"
ttl (optional)مدة البقاء
enable (optional)إذا كنت تريد تطبيق إعداد DNS هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد, يمكنك استخدام هذه المعلمة مع "yes"
sync (optional)إذا كنت تريد مزامنة إعداد خادم DNS هذا لكل النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderDnsHeader></SetFolderDnsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين مجلد Dns2
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetFolderDnsResponse>
<SetFolderDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderDnsHeader>
</SetFolderDnsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
الاستجابة (تنسيق JSON){
"SetFolderDnsResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر تعيين إعادة توجيه البريد الإلكتروني للمجلد
عند استدعاء أمر set folder email forward, يجب تضمين المعلمات التالية:
معامل طلب تعيين إعادة توجيه البريد الإلكتروني للمجلدشرح
معامل طلب تعيين إعادة توجيه البريد الإلكتروني للمجلد
شرح
domainاسم النطاق الذي تريد تعيينه, يمكن تعيين 100 نطاق في كل طلب, تأكد من فصلها بفواصل
folder_idمعرّف المجلد الذي تريد تعيينه
forward_typeنوع التحويل, يمكن أن يكون "donot": عدم تحويل البريد الإلكتروني, "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX), "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم, يُستخدم فقط عندما تكون "forward_type" هي "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الموجود، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هو أعلى أولوية، يُستخدم فقط عندما يكون "forward_type" هو "mx"
enable (optional)إذا كنت تريد تطبيق هذا الإعداد على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل بالقيمة "yes"
sync (optional)إذا كنت تريد مزامنة هذا الإعداد لجميع النطاقات في هذا المجلد، يمكنك استخدام هذا المعامل مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إعادة توجيه البريد الإلكتروني للمجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&
[email protected] طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&
[email protected] الاستجابة (تنسيق XML)<SetFolderEmailForwardingResponse>
<SetFolderEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&
[email protected] طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&
[email protected] الاستجابة (تنسيق JSON){
"SetFolderEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين إعداد مسح المجلد
إذا قمت باستدعاء الأمر set clear folder setting، فيجب تضمين المعلمات التالية:
تعيين معلمة طلب إعداد مسح المجلدشرح
تعيين معلمة طلب إعداد مسح المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
serviceالخدمة التي تريد مسحها، يمكن أن تكون "forward"، "stealth"، "email_forwarding"، "dns"، و "nameservers"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>العقدة الجذرية لمستند XML للاستجابة
<SetClearFolderSettingHeader></SetClearFolderSettingHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إعداد تفريغ المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
الاستجابة (تنسيق XML)<SetClearFolderSettingResponse>
<SetClearFolderSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearFolderSettingHeader>
</SetClearFolderSettingResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
الاستجابة (تنسيق JSON){
"SetClearFolderSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين اسم المجلد
إذا كنت تستدعي أمر تعيين اسم المجلد، يجب تضمين المعلمات التالية:
تعيين معامل طلب اسم المجلدشرح
تعيين معامل طلب اسم المجلد
شرح
folder_idمعرّف المجلد الذي تريد تعيينه
folder_nameاسم المجلد الجديد
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetFolderNameResponse></SetFolderNameResponse>العقدة الجذرية لمستند XML للاستجابة
<SetFolderNameHeader></SetFolderNameHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال تعيين اسم المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_name&folder_id=0&folder_name=new
الاستجابة (تنسيق XML)<SetFolderNameResponse>
<SetFolderNameHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderNameHeader>
</SetFolderNameResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_name&folder_id=0&folder_name=new
الاستجابة (تنسيق JSON){
"SetFolderNameResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر تعيين خيار تجديد المجلد
عند استدعاء أمر تعيين خيار تجديد المجلد، يجب تضمين المعاملات التالية:
معامل طلب تعيين خيار تجديد المجلدشرح
معامل طلب تعيين خيار تجديد المجلد
شرح
folder_idمعرف المجلد الذي تريد تعيينه، يمكن تعيين مجلد واحد فقط لكل طلب
renew_optionخيار التجديد الذي تريد تعيينه للمجلد؛ يمكن أن يكون "donot" أو "auto" أو "reset"
enable (optional)إذا كنت تريد تطبيق إعداد التجديد هذا على النطاقات المستقبلية التي تنقلها إلى هذا المجلد، يمكنك استخدام هذا المعامل بالقيمة "yes"
sync (optional)إذا كنت تريد مزامنة إعداد التجديد لجميع النطاقات في هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<Response></Response>العقدة الجذرية لمستند XML للاستجابة
<ResponseHeader></ResponseHeader>ResponseHeader
<ResponseCode></ResponseCode>رمز الاستجابة, "0" للنجاح, "-1" للفشل
<Error></Error>معلومات الخطأ، تُستخدم فقط عندما يكون رمز الاستجابة هو "-1"
مثال تعيين خيار تجديد المجلد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
الاستجابة (تنسيق XML)<SetFolderRenewOptionResponse>
<SetFolderRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
الاستجابة (تنسيق JSON){
"SetFolderRenewOptionResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر عرض قائمة المجلدات
هذا الأمر متاح فقط بصيغة XML و JSON:
معامل طلب قائمة المجلداتشرح
معامل طلب قائمة المجلدات
شرح
N/Aلا حاجة إلى معامل إضافي
<FolderListResponse></FolderListResponse>العقدة الجذرية لمستند XML للاستجابة
<FolderListHeader></FolderListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<FolderListContent></FolderListContent>محتوى الاستجابة
<FolderList></FolderList>قائمة المجلدات
<List></List>
<Folder></Folder>
<FolderId></FolderId>معرّف المجلد
<FolderName></FolderName>اسم المجلد
<DefaultWhois></DefaultWhois>Whois الافتراضي
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>حالة تمكين Whois الافتراضية
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرّف جهة الاتصال
<DefaultAdmin></DefaultAdmin>مسؤول افتراضي
<DefaultTechnical></DefaultTechnical>معلومات تقنية افتراضية
<DefaultBilling></DefaultBilling>معلومات الفوترة الافتراضية
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>حالة تفعيل خادم الأسماء الافتراضي
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع إعلانات أم لا
<DefaultRenewOption></DefaultRenewOption>خيار التجديد الافتراضي
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>حالة تفعيل خيار التجديد الافتراضي
<RenewOption></RenewOption>خيار التجديد
<DefaultTransferLock></DefaultTransferLock>قفل النقل الافتراضي
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>حالة تمكين قفل النقل الافتراضي
<LockStatus></LockStatus>حالة القفل
مثال على قائمة المجلدات
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=folder_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=folder_list
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<FolderListResponse>
<FolderListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</FolderListHeader>
<FolderListContent>
<FolderList>
<List>
<Folder>
<FolderId>0</FolderId>
<FolderName>new</FolderName>
<DefaultWhois>
<DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
<DefaultRegistrant>
<ContactId>0</ContactId>
</DefaultRegistrant>
<DefaultAdmin>
<ContactId>0</ContactId>
</DefaultAdmin>
<DefaultTechnical>
<ContactId>0</ContactId>
</DefaultTechnical>
<DefaultBilling>
<ContactId>0</ContactId>
</DefaultBilling>
</DefaultWhois>
<DefaultNameServers>
<DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
</DefaultNameServers>
<DefaultRenewOption>
<DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
<RenewOption>no renew option</RenewOption>
</DefaultRenewOption>
<DefaultTransferLock>
<DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
<LockStatus>locked</LockStatus>
</DefaultTransferLock>
</Folder>
</List>
</FolderList>
</FolderListContent>
</FolderListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=folder_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=folder_list
الاستجابة (تنسيق JSON){
"FolderListResponse": {
"ResponseCode": 0,
"Status": "success",
"FolderList": [
{
"FolderId": "0",
"FolderName": "new",
"DefaultWhois": {
"DefaultWhoisEnableStatus": "disable",
"DefaultRegistrant": {
"ContactId": "0"
},
"DefaultAdmin": {
"ContactId": "0"
},
"DefaultTechnical": {
"ContactId": "0"
},
"DefaultBilling": {
"ContactId": "0"
}
},
"DefaultNameServers": {
"DefaultTransferLockEnableStatus": "disable",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
}
},
"DefaultRenewOption": {
"DefaultRenewOptionEnableStatus": "disable",
"RenewOption": "no renew option"
},
"DefaultTransferLock": {
"DefaultTransferLockEnableStatus": "disable",
"LockStatus": "locked"
}
}
]
}
} أمر إضافة طلب الحجز المسبق
إذا قمت باستدعاء أمر طلب إضافة backorder، فيجب تضمين المعلمات التالية:
معامل طلب إضافة طلب الحجز المسبقشرح
معامل طلب إضافة طلب الحجز المسبق
شرح
domainالنطاق (النطاقات) التي تريد إضافتها وتوافق على الدفع مقابلها إذا التقطها Dynadot، يمكن إضافة 100 نطاق لكل طلب، ويجب فصلها بفواصل.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<AddBackorderRequestResponse></AddBackorderRequestResponse>العقدة الجذرية لمستند XML للاستجابة
<AddBackorderRequestHeader></AddBackorderRequestHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال طلب إضافة حجز مسبق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
الاستجابة (تنسيق XML)<AddBackorderRequestResponse>
<AddBackorderRequestHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</AddBackorderRequestHeader>
</AddBackorderRequestResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
الاستجابة (تنسيق JSON){
"AddBackorderRequestResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر حذف طلب الحجز المسبق
عند استدعاء أمر حذف طلب الحجز المسبق, يجب تضمين المعلمات التالية:
معامل طلب حذف طلب الحجز المسبقشرح
معامل طلب حذف طلب الحجز المسبق
شرح
domainالنطاق (النطاقات) التي تريد إزالتها من قائمة طلبات الحجز المسبق الخاصة بك، يمكن إزالة 100 نطاق لكل طلب، ويجب فصلها بفواصل
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>العقدة الجذرية لمستند XML للاستجابة
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على طلب حذف الحجز المسبق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=delete_backorder_request&domain=domaindropp.com
الاستجابة (تنسيق XML)<DeleteBackorderRequestResponse>
<DeleteBackorderRequestHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=delete_backorder_request&domain=domaindropp.com
الاستجابة (تنسيق JSON){
"DeleteBackorderRequestResponse":{
"ResponseCode":"0",
"Status":"success"
}
} أمر قائمة طلبات الحجز المسبق
استدعاء أمر قائمة طلبات الحجز المسبق سيرجع قائمة طلبات الحجز المسبق للحساب المحدد. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب قائمة طلبات الحجز المسبقشرح
معامل طلب قائمة طلبات الحجز المسبق
شرح
start_dateتاريخ بدء الإسقاط للمزاد الذي تريد طلبه, yyyy-mm-dd, مثل 2015-05-05
end_dateتاريخ انتهاء الإسقاط للمزاد الذي تريد طلبه, yyyy-mm-dd, مثل 2015-05-05
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<BackorderRequestListResponse></BackorderRequestListResponse>العقدة الجذرية لمستند XML للاستجابة
<BackorderRequestListHeader></BackorderRequestListHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<BackorderRequestListContent></BackorderRequestListContent>محتوى الاستجابة
<BackorderRequestList></BackorderRequestList>قائمة طلبات الحجز المسبق
<BackorderRequest></BackorderRequest>طلب حجز مسبق
<Domain></Domain>النطاق الموجود في قائمتك
<CutoffTime></CutoffTime>تاريخ القطع لحذف طلب بتوقيت Unix (مللي ثانية منذ منتصف الليل UTC في 1 يناير 1970)
<BackorderRequestStatus></BackorderRequestStatus>الحالة في عملية التقاط النطاقات الساقطة
مثال على قائمة طلبات الحجز المسبق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<BackorderRequestListResponse>
<BackorderRequestListHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</BackorderRequestListHeader>
<BackorderRequestListContent>
<BackorderRequestList>
<BackorderRequest>
<DomainName>testdrop.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop3.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop4.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop5.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
</BackorderRequestList>
</BackorderRequestListContent>
</BackorderRequestListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
الاستجابة (تنسيق JSON){
"BackorderRequestListResponse": {
"ResponseCode": 0,
"Status": "success",
"BackorderRequestList": [
{
"DomainName": "testdrop.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop3.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop4.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop5.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
}
]
}
} طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
الاستجابة (تنسيق CSV)ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
أمر جلب المزادات المفتوحة
استدعاء أمر جلب المزادات المفتوحة سيعيد قائمة بالمزادات الجارية. إذا استدعيت هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب جلب المزادات المفتوحةشرح
معامل طلب جلب المزادات المفتوحة
شرح
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
type (optional)نوع المزاد الذي تريد رؤيته, يجب أن يكون "expired", "user", "backorder", أو "registry_expired", "registrar", إذا كنت تريد الحصول على أكثر من نوع مزاد, يمكنك استخدام "," لفصل كل نوع مزاد
count_per_pageكم عدد الكيانات المعروضة في الصفحة (بحد أقصى 1000)
page_index كيانات أي صفحة تريد عرضها؟
has_bids (optional)عندما تكون هذه المعلمة صحيحة، فسيتم إرجاع المزادات التي تم تقديم عروض عليها فقط. إذا كانت خاطئة، فسيتم إرجاع المزادات التي ليس بها عروض. إذا لم يتم تمريرها، فسيتم إرجاع جميع المزادات.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>وسم استجابة الحصول على المزادات المفتوحة، إنه العقدة الجذرية لمستند XML الخاص بالاستجابة
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>الحصول على عنوان المزادات المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetOpenAuctionsContent></GetOpenAuctionsContent>Tag of get open auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار النطاق
<Links></Links>الروابط الواردة للنطاق
<Age></Age>عمر النطاق
مثال على جلب المزادات المفتوحة
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1
الاستجابة (تنسيق XML)<GetOpenAuctionsResponse>
<GetOpenAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenAuctionsHeader>
<GetOpenAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
.
.
.
</GetOpenAuctionsContent>
</GetOpenAuctionsResponse> طلب(تنسيق csv)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1
الاستجابة
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_open_auctions¤cy=usd&type=expired&count_per_page=20&page_index=1
الاستجابة (تنسيق JSON){
"status": "success",
"auction_list": [
{
"auction_id": 11,
"domain": "domain.com",
"utf_name": "domain.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "124.00",
"bids": 4,
"bidders": 2,
"time_left": "1 day, 23 hours",
"start_time": "2022/03/28 02:20 PST",
"start_time_stamp": 1648459234033,
"end_time": "2022/04/04 02:20 PST",
"end_time_stamp": 1649064034033,
"visitors": 223,
"links": "-",
"age": 0,
"dyna_appraisal": "-"
},
{
"auction_id": 12,
"domain": "domain0.com",
"utf_name": "domain0.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "44.99",
"bids": 1,
"bidders": 1,
"time_left": "2 days, 23 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"visitors": 245,
"links": "-",
"age": 0,
"dyna_appraisal": "-"
}
...
]
} أمر الحصول على تفاصيل المزاد
استدعاء الأمر get auction details سيعيد تفاصيل المزاد المحدد. هذا الأمر متاح فقط بصيغة XML و JSON. إذا قمت باستدعاء هذا الأمر، يجب تضمين المعلمات التالية:
معلمة طلب الحصول على تفاصيل المزادشرح
معلمة طلب الحصول على تفاصيل المزاد
شرح
domainاسم النطاق للمزاد، يجب أن يستخدم IDN (اسم النطاق الدولي) punycode، مثل "xn--wkccg.com". يمكنك الحصول على أكثر من مزاد واحد، ويجب فصل كل نطاق بواسطة ","
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>وسم استجابة الحصول على تفاصيل المزاد، إنه العقدة الجذرية لمستند XML للاستجابة
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>ترويسة تفاصيل مزاد الطلب المسبق
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Tag of get auction details content, it's only used when status is "success"
<AuctionStatusId></AuctionStatusId>معرف حالة المزاد : '0' قيد التقدم، '1' ملغي بواسطة المستخدم، '2' ملغي بواسطة المشرف، '3' ملغي بواسطة التجديد، '4' مكتمل، '5' ملغي بواسطة النقل بعيداً
<AuctionStatus></AuctionStatus>حالة المزاد
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو صاحب أعلى مزايدة
<YourCurrentBid></YourCurrentBid>سعر مزايدتك الحالي للمزاد المحدد. إذا لم تقدم مزايدة، فسيكون '-1'
<YourProxyBid></YourProxyBid>لك مزايدة بالوكالة للمزاد المحدد. إذا لم تكن قد قدمت عرضًا, فستكون '-1' <AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<IsPremium></IsPremium>ما إذا كان نطاقًا مميزًا
<RenewalPrice></RenewalPrice>سعر التجديد
مثال للحصول على تفاصيل المزاد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetAuctionDetailsResponse>
<GetAuctionDetailsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionDetailsHeader>
<GetAuctionDetailsContent>
<Auction>
<AuctionStatusId>0</AuctionStatusId>
<AuctionStatus>1</AuctionStatus>
<AuctionId>0</AuctionId>
<Domain>test.biz</Domain>
<BidPrice>46.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>1970/01/01 00:00 UTC</EndTime>
<EndTimestamp>0</EndTimestamp>
<Revenue>1</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>1</Links>
<Age>10</Age>
<isPremium>false</isPremium>
<RenewalPrice>-0.1</RenewalPrice>
<UserIsHighBid>false</UserIsHighBid>
<YourCurrentBid>-1</YourCurrentBid>
<YourProxyBid>-1</YourProxyBid>
</Auction>
</GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
الاستجابة (تنسيق JSON){
"status": "success",
"size": 1,
"auction_details": [
{
"auction_json": {
"auction_id": 0,
"domain": "test.biz",
"utf_name": "test.biz",
"is_idn": false,
"auction_type": "expired",
"current_bid_price": "46.99",
"accepted_bid_price": "46.99",
"currency": "USD",
"is_high_bidder": false,
"bids": 0,
"bidders": 0,
"auction_status_id": 0,
"time_left": "1",
"start_time": "1",
"start_time_stamp": 0,
"end_time": "",
"end_time_stamp": 0,
"revenue": "1",
"visitors": -1,
"links": "1",
"age": 10,
"estibot_appraisal": "",
"dyna_appraisal": "",
"bidder_name": "",
"bid_price": "",
"timestamp": 0,
"bid_status": "",
"is_proxy_auto_bid": false,
"auction_ended": false,
"customer_bided": false,
"customer_bid": "1",
"customer_proxy_bid": "1",
"is_premium": false,
"renewal_price": "-0.1"
},
"bid_history": []
}
]
} أمر الحصول على مزايدات المزاد
استدعاء أمر get auction bids سيجلب قائمة مزايداتك التي شاركت فيها. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:
معامل طلب جلب مزايدات المزادشرح
معامل طلب جلب مزايدات المزاد
شرح
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
count_per_pageكم عدد الكيانات المعروضة في كل صفحة (بحد أقصى 50)
page_index كيانات أي صفحة تريد عرضها؟
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetAuctionBidsResponse></GetAuctionBidsResponse>علامة استجابة الحصول على مزايدات المزاد، إنها العقدة الجذرية لمستند XML للاستجابة
<GetAuctionBidsHeader></GetAuctionBidsHeader>ترويسة Get auction bids
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAuctionBidsContent></GetAuctionBidsContent>Tag of get auction bids content, it's only used when status is "success"
<BidList></BidList> قائمة المزايدات
<Bid></Bid> عنصر المزايدة
<BidId></BidId> معرّف المزايدة
<AuctionId></AuctionId> معرّف المزاد
<AccountId></AccountId>معرّف الحساب
<Domain></Domain>اسم نطاق المزاد
<DomainUtf></DomainUtf>اسم utf للنطاق الخاص بالمزاد
<AuctionType></AuctionType>نوع المزاد
<IsIdn></IsIdn>إذا كان هذا النطاق اسم نطاق دولي
<CurrentBid></CurrentBid>سعر العرض الحالي للمزاد
<YourStatus></YourStatus>حالة مزايدتك في المزاد
<ProxyBid></ProxyBid>سعر مزايدتك الوكيلية للمزاد
<ActiveBidders></ActiveBidders>عدد المزايدين المشاركين في هذا المزاد
<TimeLeft></TimeLeft>الوقت المتبقي للمزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>الطابع الزمني لانتهاء المزاد
مثال الحصول على مزايدات المزاد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_auction_bids¤cy=usd&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_auction_bids¤cy=usd&count_per_page=20&page_index=1
الاستجابة (تنسيق XML)<GetAuctionBidsResponse>
<GetAuctionBidsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionBidsHeader>
<GetAuctionBidsContent>
<BidList>
<Bid>
<BidId>0</BidId>
<AuctionId>11</AuctionId>
<AccountId>1</AccountId>
<Domain>domain.com</Domain>
<DomainUtf>domain.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$124.00</CurrentBid>
<YourStatus>Out Bid</YourStatus>
<ProxyBid>$119.00</ProxyBid>
<ActiveBidders>2</ActiveBidders>
<TimeLeft>1 day, 6 hours</TimeLeft>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Bid>
<Bid>
<BidId>9</BidId>
<AuctionId>12</AuctionId>
<AccountId>1</AccountId>
<Domain>domain0.com</Domain>
<DomainUtf>domain0.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$44.99</CurrentBid>
<YourStatus>High Bidder</YourStatus>
<ProxyBid>$121.00</ProxyBid>
<ActiveBidders>1</ActiveBidders>
<TimeLeft>2 days, 6 hours</TimeLeft>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Bid>
</BidList>
</GetAuctionBidsContent>
</GetAuctionBidsResponse> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_auction_bids¤cy=usd&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_auction_bids¤cy=usd&count_per_page=20&page_index=1
الاستجابة (تنسيق JSON){
"status": "success",
"auction_bids": [
{
"bid_id": 0,
"auction_id": 11,
"account_id": "1",
"domain": "domain.com",
"domain_utf": "domain.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "1 day, 23 hours",
"end_time": "2022/04/04 02:20:34 PST",
"end_time_stamp": 1649064034033
},
{
"bid_id": 2,
"auction_id": 12,
"account_id": "1",
"domain": "domain0.com",
"domain_utf": "domain0.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "2 days, 23 hours",
"end_time": "2022/04/05 02:20:34 PST",
"end_time_stamp": 1649150434049
}
...
]
} أمر تقديم مزايدة في المزاد
سيؤدي استدعاء أمر تقديم مزايدة المزاد إلى تقديم مزايدة للمزاد المحدد. عند استدعاء هذا الأمر, يجب تضمين المعاملات التالية:
معامل طلب تقديم مزايدة في المزادشرح
معامل طلب تقديم مزايدة في المزاد
شرح
domainاسم النطاق للمزاد، يجب أن يستخدم اسم النطاق الدولي (IDN) ترميز punycode، مثل "xn--wkccg.com"
bid_amountمبلغ عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها بواسطة معلمة العملة أدناه
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<PlaceAuctionBidResponse></PlaceAuctionBidResponse>وسم استجابة عرض مزاد المكان، إنها العقدة الجذرية لمستند XML للاستجابة
<PlaceAuctionBidHeader></PlaceAuctionBidHeader>عنوان تقديم عرض المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال النطاق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة (تنسيق XML)<PlaceAuctionBidResponse>
<PlaceAuctionBidHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</PlaceAuctionBidHeader>
</PlaceAuctionBidResponse> طلب(تنسيق csv)
https://api.dynadot.com/api3.html?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة
ok,success
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة (تنسيق JSON){
"status": "success",
"auction_details": {
"auction_json": {
"auction_id": 12,
"domain": "example.com",
"utf_name": "example.com",
"is_idn": false,
"auction_type": "expired",
"current_bid_price": "44.99",
"accepted_bid_price": "45.99",
"currency": "USD",
"is_high_bidder": true,
"bids": 3,
"bidders": 2,
"time_left": "2 days, 22 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"revenue": "$26.50",
"visitors": 245,
"links": "-",
"age": 0,
"dyna_appraisal": "-",
"auction_ended": false,
"customer_bided": true,
"customer_bid": "44.99",
"customer_proxy_bid": "$121.00"
},
"bid_history": [
{
"bidder_name": "You",
"bid_price": "44.99",
"currency": "USD",
"timestamp": 1648892255084,
"bid_status": "High Bidder",
"is_proxy_auto_bid": false
}
... ]
}
} أمر جلب المزادات المغلقة
استدعاء الأمر get closed auctions سيُرجع قائمة بالمزادات المغلقة لحساب محدّد. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب الحصول على المزادات المغلقةشرح
معامل طلب الحصول على المزادات المغلقة
شرح
start_dateالطابع الزمني الذي يشير إلى بداية وقت انتهاء المزاد, yyyy-mm-dd, مثل 2015-05-05
end_dateالطابع الزمني الذي يشير إلى نهاية وقت انتهاء المزاد, yyyy-mm-dd, مثل 2015-05-05
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>وسم استجابة الحصول على المزادات المغلقة، إنه العقدة الجذرية لمستند XML للاستجابة
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>الحصول على ترويسة المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>Tag of get closed auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "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=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetClosedAuctionsResponse>
<GetClosedAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetClosedAuctionsHeader>
<GetClosedAuctionsContent>
<Auction>
<AuctionId>2</AuctionId>
<Domain>testdomain1.test</Domain>
<AuctionStatusId>4</AuctionStatusId>
<AuctionStatus>Closed by Timeout</AuctionStatus>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>89.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
</Auction>
<Auction>
<AuctionId>3</AuctionId>
<Domain>testdomain2.test</Domain>
<AuctionStatusId>4</AuctionStatusId>
<AuctionStatus>Closed by Timeout</AuctionStatus>
<BidPrice>28.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>28.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
</Auction>
</GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق JSON){
"GetClosedAuctionsResponse": {
"ResponseCode": 0,
"Status": "success",
"Auctions": [
{
"AuctionId": "2",
"Domain": "testdomain1.test",
"AuctionStatusId": "4",
"AuctionStatus": "Closed by Timeout",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"AuctionWonStatus": "won",
"YourHighBid": "89.99",
"YourProxyBid": "1000.0"
},
{
"AuctionId": "3",
"Domain": "testdomain2.test",
"AuctionStatusId": "4",
"AuctionStatus": "Closed by Timeout",
"BidPrice": "28.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"AuctionWonStatus": "won",
"YourHighBid": "28.99",
"YourProxyBid": "1000.0"
}
]
}
} طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق CSV)ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
أمر الحصول على مزادات الحجز المسبق المفتوحة
سيؤدي استدعاء الأمر get open backorder auctions إلى إرجاع قائمة بمزادات الحجز المسبق الجارية. إذا قمت باستدعاء هذا الأمر، فيجب تضمين المعاملات التالية:
معامل طلب الحصول على مزادات الطلبات المسبقة المفتوحةشرح
معامل طلب الحصول على مزادات الطلبات المسبقة المفتوحة
شرح
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>وسم استجابة get open backorder auctions, إنه العقدة الجذرية لمستند XML الخاص بالاستجابة
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>الحصول على عنوان مزادات الحجز المسبق المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>Tag of get open backorder auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "success"
<AuctionId></AuctionId>معرّف المزاد
<Domain></Domain>اسم نطاق المزاد
<BidPrice></BidPrice>سعر المزايدة الحالي للمزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد مزايدات المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
مثال على جلب مزادات الحجز المسبق المفتوحة
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_backorder_auctions¤cy=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_open_backorder_auctions¤cy=usd
الاستجابة (تنسيق XML)<GetOpenBackorderAuctionsResponse>
<GetOpenBackorderAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenBackorderAuctionsHeader>
<GetOpenBackorderAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
</Auction>
.
.
.
</GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse> طلب(تنسيق csv)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_backorder_auctions¤cy=usd
الاستجابة
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp
10000,backorder0.com,6.35,USD,0,2017/08/29 17:53 UTC,1504029194453
10001,backorder1.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
10002,backorder2.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
.
.
.
أمر الحصول على تفاصيل مزاد الحجز المسبق
استدعاء الأمر get backorder auction details سيُعيد تفاصيل المزاد المحدد. هذا الأمر متاح فقط في تنسيق XML و JSON. إذا استدعيت هذا الأمر، يجب تضمين المعاملات التالية:
معلمة طلب الحصول على تفاصيل المزادشرح
معلمة طلب الحصول على تفاصيل المزاد
شرح
domainاسم النطاق للمزاد المطلوب مسبقًا، يجب أن يستخدم IDN (اسم النطاق الدولي) punycode، مثل "xn--wkccg.com"
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>وسم استجابة الحصول على تفاصيل المزاد، إنه العقدة الجذرية لمستند XML للاستجابة
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>ترويسة الحصول على تفاصيل المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>Tag of get auction details content, it's only used when status is "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>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار النطاق
<Links></Links>الروابط الواردة للنطاق
<Age></Age>عمر النطاق
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو صاحب أعلى مزايدة
<YourCurrentBid></YourCurrentBid>سعر مزايدتك الحالي للمزاد المحدد. إذا لم تقدم مزايدة، فسيكون '-1'
<YourProxyBid></YourProxyBid>لك مزايدة بالوكالة للمزاد المحدد. إذا لم تكن قد قدمت عرضًا, فستكون '-1' مثال على Get Backorder Auction Details
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetBackorderAuctionDetailsResponse>
<GetBackorderAuctionDetailsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetBackorderAuctionDetailsHeader>
<GetBackorderAuctionDetailsContent>
<AuctionStatusId>0</AuctionStatusId>
<AuctionStatus>In Progress</AuctionStatus>
<UserIsHighBid>no</UserIsHighBid>
<YourCurrentBid>-1</YourCurrentBid>
<YourProxyBid>-1</YourProxyBid>
<Auction>
<AuctionId>10001</AuctionId>
<Domain>example.com</Domain>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 18:16 UTC</EndTime>
<EndTimestamp>1430244969779</EndTimestamp>
</Auction>
</GetBackorderAuctionDetailsContent>
</GetBackorderAuctionDetailsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd
الاستجابة (تنسيق JSON){
"GetBackorderAuctionDetailsResponse": {
"ResponseCode": 0,
"Status": "success",
"GetBackorderAuctionDetails": {
"AuctionStatusId": "0",
"AuctionStatus": "In Progress",
"UserIsHighBid": "no",
"YourCurrentBid": "-1",
"YourProxyBid": "-1",
"Auction": {
"AuctionId": "10001",
"Domain": "example.com",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "0",
"EndTime": "2015/04/28 18:16 UTC",
"EndTimestamp": "1430244969779"
}
}
}
} أمر تقديم مزايدة في مزاد الطلب المسبق
سيؤدي استدعاء أمر تقديم عرض مزاد backorder إلى تقديم عرض للمزاد المحدد. إذا قمت باستدعاء هذا الأمر، فيجب تضمين المعلمات التالية:
معلمة طلب تقديم مزايدة في مزاد الحجز المسبقشرح
معلمة طلب تقديم مزايدة في مزاد الحجز المسبق
شرح
domainاسم النطاق للمزاد، يجب أن يستخدم اسم النطاق الدولي (IDN) ترميز punycode، مثل "xn--wkccg.com"
bid_amountمبلغ عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها بواسطة معلمة العملة أدناه
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<PlaceBakcorderAuctionBidResponse></PlaceBakcorderAuctionBidResponse>وسم استجابة عرض مزاد المكان، إنها العقدة الجذرية لمستند XML للاستجابة
<PlaceBackorderAuctionBidHeader></PlaceBackorderAuctionBidHeader>عنوان تقديم عرض المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تقديم عرض في مزاد الحجز المسبق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة (تنسيق XML)<PlaceBakcorderAuctionBidResponse>
<PlaceBackorderAuctionBidHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة (تنسيق JSON){
"PlaceBakcorderAuctionBidResponse":{
"ResponseCode":"0",
"Status":"success"
}
} طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة (تنسيق CSV)ok,success
أمر جلب مزادات الحجز المسبق المغلقة
استدعاء الأمر get closed backorder auctions سيعيد قائمة بالمزادات المغلقة للطلبات المسبقة للحساب المحدد. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:
معامل طلب جلب مزادات الطلبات المسبقة المغلقةشرح
معامل طلب جلب مزادات الطلبات المسبقة المغلقة
شرح
start_dateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
end_dateتاريخ انتهاء المزاد, yyyy-mm-dd, مثل 2015-05-05
currency (optional)عملة عرضك، يجب أن تكون "usd" أو "eur" أو "cny"، والعملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>وسم استجابة الحصول على المزادات المغلقة، إنه العقدة الجذرية لمستند XML للاستجابة
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>الحصول على ترويسة المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>Tag of get closed auctions content, it's only used when status is "success"
<Auction></Auction>Tag of auction item, it's only used when status is "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=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetClosedBackorderAuctionsResponse>
<GetClosedBackorderAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetClosedBackorderAuctionsHeader>
<GetClosedBackorderAuctionsContent>
<Auction>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>89.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
<AuctionId>2</AuctionId>
<Domain>testdomain1.test</Domain>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Auction>
<Auction>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>28.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
<AuctionId>3</AuctionId>
<Domain>testdomain2.test</Domain>
<BidPrice>28.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Auction>
</GetClosedBackorderAuctionsContent>
</GetClosedBackorderAuctionsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق JSON){
"GetClosedBackorderAuctionsResponse": {
"ResponseCode": 0,
"Status": "success",
"Auctions": [
{
"AuctionWonStatus": "won",
"YourHighBid": "89.99",
"YourProxyBid": "1000.0",
"AuctionId": "2",
"Domain": "testdomain1.test",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"EndTime": "2022/04/04 02:20:34 PST",
"EndTimestamp": "1649064034033"
},
{
"AuctionWonStatus": "won",
"YourHighBid": "28.99",
"YourProxyBid": "1000.0",
"AuctionId": "3",
"Domain": "testdomain2.test",
"BidPrice": "28.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"EndTime": "2022/04/05 02:20:34 PST",
"EndTimestamp": "1649150434049"
}
]
}
} طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
الاستجابة (تنسيق CSV)ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
أمر الحصول على النطاقات المنتهية الصلاحية والمغلقة
استدعاء أمر جلب النطاقات المنتهية للإغلاق سيجلب النطاقات المنتهية للإغلاق. هذا الأمر متاح فقط بصيغة XML وJSON. إذا تم استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب الحصول على النطاقات المنتهية والمغلقةشرح
معامل طلب الحصول على النطاقات المنتهية والمغلقة
شرح
currency(optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
domain(optional)أضف هذه المعلمة إذا كنت تريد الاستعلام عن نطاق إغلاق
count_per_page (optional)كم عدد الكيانات التي تُعرض في كل صفحة
page_index (optional)كيانات أي صفحة تريد عرضها؟
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>وسم استجابة Get Expired Closeout Domains، وهو العقدة الجذرية لمستند XML الخاص بالاستجابة
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>الحصول على ترويسة النطاقات المنتهية الصلاحية للتصفية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>Tag of content, it's only used when status is "success"
<CloseoutItem></CloseoutItem>عنصر الإغلاق
<DomainName></DomainName>اسم النطاق
<DomainNameUtf></DomainNameUtf>اسم النطاق بتنسيق utf
<CurrentPrice></CurrentPrice>السعر الحالي
<isIdn></isIdn>ما إذا كان اسم النطاق IDN
<EndTimeStamp></EndTimeStamp>تاريخ انتهاء المزاد بتوقيت Unix (مللي ثانية منذ منتصف ليل UTC في 1 يناير 1970)
<RenewalPrice></RenewalPrice>سعر التجديد
<ExpiredRevenue></ExpiredRevenue>إيرادات الإغلاق
<DynaAppraisal></DynaAppraisal>DynaAppraisal
<InboundLinks></InboundLinks>الروابط الواردة للنطاق
<MonthlyVisitors></MonthlyVisitors>زوار النطاق
<Currency></Currency>العملة
مثال الحصول على النطاقات المنتهية الصلاحية للتصفية
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
<GetExpiredCloseoutDomainsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetExpiredCloseoutDomainsHeader>
<GetExpiredCloseoutDomainsContent>
<CloseoutItem>
<DomainName>test.biz</DomainName>
<DomainNameUtf>test.biz</DomainNameUtf>
<CurrentPrice>9.91</CurrentPrice>
<IsIDN>false</IsIDN>
<EndTimeStamp>0</EndTimeStamp>
<RenewalPrice>9.99</RenewalPrice>
<ExpiredRevenue>9.90</ExpiredRevenue>
<EstibotAppraisal>1223</EstibotAppraisal>
<InboundLinks>-1</InboundLinks>
<MonthlyVisitors>-1</MonthlyVisitors>
<Currency>usd</Currency>
</CloseoutItem>
</GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
الاستجابة (تنسيق JSON){
"GetExpiredCloseoutDomainsResponse": {
"ResponseCode": 0,
"Status": "success",
"Size": 1,
"CloseoutDomains": [
{
"closeoutItem": {
"domainName": "test.biz",
"domainNameUtf": "test.biz",
"currentPrice": "9.91",
"isIdn": false,
"endTimeStamp": 0,
"renewalPrice": "9.99",
"expiredRevenue": "9.90",
"estibotAppraisal": "1223",
"inboundLinks": -1,
"monthlyVisitors": -1,
"currency": "usd"
}
}
]
}
} أمر شراء نطاق منتهي الصلاحية من نوع Closeout
استدعاء أمر شراء النطاق المنتهي للتصفية سيؤدي إلى شراء اسم النطاق المحدد. هذا الأمر متاح فقط بصيغة XML و JSON. إذا قمت باستدعاء هذا الأمر، فيجب تضمين المعاملات التالية:
معامل طلب شراء نطاق منتهي الصلاحية للإغلاقشرح
معامل طلب شراء نطاق منتهي الصلاحية للإغلاق
شرح
domainالنطاق الذي تريد شراءه، يمكن إدخال نطاق واحد فقط لكل طلب
currency(optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>وسم استجابة شراء نطاق Closeout منتهي الصلاحية, إنه العقدة الجذرية لمستند XML للاستجابة
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>عنوان شراء نطاق منتهي الصلاحية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال شراء نطاق منتهي الصلاحية ومغلق
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
<BuyExpiredCloseoutDomainHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com
الاستجابة (تنسيق JSON){
"BuyExpiredCloseoutDomainResponse": {
"ResponseCode": "0",
"Status": "success"
}
} أمر جلب الإدراجات
إذا كنت تستدعي الأمر get listings, فيجب تضمين المعاملات التالية:
معلمة طلب جلب القوائمشرح
معلمة طلب جلب القوائم
شرح
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
exclude_pending_sale (optional)If you don't want to get pending sale lock listings, it should be "yes", default is "no"
show_other_registrar (optional)إذا كنت تريد الحصول على قوائم المسجلين الآخرين، يجب أن تكون "yes"، الافتراضي هو "no"
count_per_pageكم عدد الكيانات المعروضة في كل صفحة. (الحد الأقصى 20000)
page_indexأي كيانات الصفحة تريد عرضها.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetListingsResponse></GetListingsResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetListingsHeader></GetListingsHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetListingsContent></GetListingsContent>محتوى الإدراج
<Listing></Listing>محتوى عنصر الإدراج
<ListingId></ListingId>معرّف القائمة
<Domain></Domain>اسم النطاق
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر
مثال على الحصول على القوائم
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]¤cy=usd&command=get_listings&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]¤cy=usd&command=get_listings&count_per_page=20&page_index=1
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetListingsResponse>
<GetListingsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetListingsHeader>
<GetListingsContent>
<Listing>
<ListingId>id1</ListingId>
<Domain>domain_name1</Domain>
<Price>1</Price>
<InboundLinks>1</InboundLinks>
<Age>1</Age>
<PendingSaleLocked>No</PendingSaleLocked>
<Type>BIN</Type>
<RegistrationDate>1791875010217</RegistrationDate>
<ExpirationDate>1791875010217</ExpirationDate>
</Listing>
<Listing>
<ListingId>id2</ListingId>
<Domain>domain_name2</Domain>
<Price>2</Price>
<InboundLinks>2</InboundLinks>
<Age>2</Age>
<PendingSaleLocked>No</PendingSaleLocked>
<Type>MAKE_OFFER</Type>
<RegistrationDate>1791875010217</RegistrationDate>
<ExpirationDate>1791875010217</ExpirationDate>
</Listing>
</GetListingsContent>
</GetListingsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]¤cy=usd&command=get_listings&count_per_page=20&page_index=1
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]¤cy=usd&command=get_listings&count_per_page=20&page_index=1
الاستجابة (تنسيق JSON){
"GetListingsResponse": {
"ResponseCode": 0,
"Status": "success",
"Total": 2,
"Listing": [
{
"ListingId": "id1",
"Domain": "domain_name1",
"Price": "1",
"InboundLinks": "1",
"Age": "1",
"PendingSaleLocked": "No",
"RegistrationDate": 1791875010217,
"ExpirationDate": 1791875010217,
"Type": "BIN"
},
{
"ListingId": "id2",
"Domain": "domain_name2",
"Price": "2",
"InboundLinks": "2",
"Age": "2",
"PendingSaleLocked": "No",
"RegistrationDate": 1791875010217,
"ExpirationDate": 1791875010217,
"Type": "MAKE_OFFER"
}
]
}
} أمر الحصول على عنصر القائمة
عند استدعاء الأمر get listing item، يجب تضمين المعلمات التالية:
معامل طلب جلب عنصر القائمةشرح
معامل طلب جلب عنصر القائمة
شرح
domainاسم النطاق الذي تريد الحصول على تفاصيله, يمكن إدخال نطاق واحد فقط لكل طلب
currency (optional)عملة نتيجة الإرجاع, يجب أن تكون "usd", "eur", أو "cny", العملة الافتراضية هي الدولار الأمريكي
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetListingItemResponse></GetListingItemResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<GetListingItemHeader></GetListingItemHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetListingsItemContent></GetListingsItemContent>محتوى الإدراج
<Listing></Listing>محتوى عنصر الإدراج
<ListingId></ListingId>معرّف القائمة
<Domain></Domain>اسم النطاق
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر
مثال الحصول على عنصر الإدراج
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_listing_item¤cy=usd&domain=domain_name
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_listing_item¤cy=usd&domain=domain_name
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetListingsItemResponse>
<GetListingsItemHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetListingsItemHeader>
<GetListingsItemContent>
<Listing>
<ListingId>id</ListingId>
<Domain>domain_name</Domain>
<Price>0</Price>
<InboundLinks>0</InboundLinks>
<Age>0</Age>
<PendingSaleLocked>No</PendingSaleLocked>
<Type>BIN</Type>
<RegistrationDate>1791875010218</RegistrationDate>
<ExpirationDate>1791875010218</ExpirationDate>
</Listing>
</GetListingsItemContent>
</GetListingsItemResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_listing_item¤cy=usd&domain=domain_name
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_listing_item¤cy=usd&domain=domain_name
الاستجابة (تنسيق JSON){
"GetListingsItemResponse": {
"ResponseCode": 0,
"Status": "success",
"Listing": {
"ListingId": "id",
"Domain": "domain_name",
"Price": "0",
"InboundLinks": "0",
"Age": "0",
"PendingSaleLocked": "No",
"RegistrationDate": 1791875010218,
"ExpirationDate": 1791875010218,
"Type": "BIN"
}
}
} أمر اشترِ الآن
إذا كنت تستدعي أمر الشراء الآن، يجب تضمين المعاملات التالية:
معامل طلب الشراء الفوريشرح
معامل طلب الشراء الفوري
شرح
domainالنطاق الذي تريد شراءه، يمكن إدخال نطاق واحد فقط لكل طلب
currency (optional)عملة نتيجة الإرجاع، يجب أن تكون "usd" أو "eur" أو "cny"، إذا لم يتم إدخال عملة، سيتم تطبيق العملة الافتراضية للحساب.
price_to_verify (optional)سعر buy_it_now المتوقع الذي يجب التحقق منه قبل الشراء. إذا لم يتطابق سعر الإدراج الفعلي مع هذه القيمة، سيفشل الطلب.
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<BuyItNowResponse></BuyItNowResponse>العقدة الجذرية لمستند XML للاستجابةمستند XML
<BuyItNowHeader></BuyItNowHeader>ترويسة الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<Message></Message>يجب أن يكون "domain order created"، ويُستخدم فقط عندما تكون الحالة "success".
مثال على الشراء الآن
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=buy_it_now&domain=domain¤cy=usd&price_to_verify=1234
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=buy_it_now&domain=domain¤cy=usd&price_to_verify=1234
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<BuyItNowResponse>
<BuyItNowHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</BuyItNowHeader>
<BuyItNowContent>
<OrderId>1</OrderId>
</BuyItNowContent>
</BuyItNowResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=buy_it_now&domain=domain¤cy=usd&price_to_verify=1234
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=buy_it_now&domain=domain¤cy=usd&price_to_verify=1234
الاستجابة (تنسيق JSON){
"BuyItNowResponse": {
"ResponseCode": 0,
"Status": "success",
"OrderId": 1
}
} أمر إضافة عميل محتمل جديد
سيؤدي استدعاء أمر إضافة عميل محتمل جديد إلى استيراد العملاء المحتملين الخاصين بك إلى نظام Dynadot بعمولة قدرها 5%.
ملاحظة: سيتم إلغاء قفل النطاق لتمكين المشتري من إتمام الشراء فورًا عند القبول.
هذا الأمر متاح فقط بتنسيق XML وJSON. إذا كنت تستدعي هذا الأمر، فيجب تضمين المعاملات التالية:
معامل طلب إضافة عميل محتمل جديدشرح
معامل طلب إضافة عميل محتمل جديد
شرح
domain_nameاسم النطاق الذي تريد إضافة عميل محتمل له, يمكن إدخال نطاق واحد فقط لكل طلب
lead_typeنوع العميل المحتمل الذي تريد تعيين هذا العميل المحتمل له. القيم المقبولة هي "buy_now"، "make_offer"
priceالسعر الذي تريد تعيينه للعميل المحتمل
buyer_nameاسم المشترين
buyer_emailالبريد الإلكتروني للمشترين
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<AddNewLeadResponse></AddNewLeadResponse>العقدة الجذرية للاستجابة
<AddNewLeadHeader></AddNewLeadHeader>عنوان إضافة عميل محتمل جديد
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال إضافة عميل محتمل جديد
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&
[email protected] طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&
[email protected] الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<AddNewLeadResponse>
<AddNewLeadHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</AddNewLeadHeader>
</AddNewLeadResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&
[email protected] طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=add_new_lead&domains=test.com&lead_type=buy_now&price=1000&buyer_name=test_buyer_name&
[email protected] الاستجابة (تنسيق JSON){
"AddNewLeadResponse": {
"ResponseCode": 0,
"Status": "success"
}
} أمر التعيين للبيع
يدعم هذا الأمر تعدد الخيوط.
سيؤدي استدعاء الأمر Set For Sale إلى عرض نطاقك للبيع في سوق النطاقات. هذا الأمر متاح فقط بصيغة XML وJSON. إذا استدعيت هذا الأمر، فيجب تضمين المعلمات التالية:
تعيين معامل طلب العرض للبيعشرح
تعيين معامل طلب العرض للبيع
شرح
domainsالنطاق الذي تريد إدراج نطاقك للبيع به في سوق النطاقات, يمكن إدخال نطاق واحد فقط لكل طلب
for_sale_typeيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك:
> السوق:
أدرج نطاقك للبيع في سوق النطاقات. سيتم تعيين إدراجات النطاقات الجديدة إلى الفئة, والفئة الفرعية, والسعر المُدخل أدناه. إذا تم تعيين سعر فعلي, فسيصبح النطاق متاحاً للشراء الفوري وسيُدفع إلى المشتري.
مزيد من المعلومات حول عملية بيع النطاق >
> ليس للبيع:
إلغاء الإدراج
listing_type (optional)يمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك عبر السوق: (إلزامي إذا كان for_sale_type هو marketplace)
> buy_now
سيؤدي تحديد سعر ثابت إلى جعل النطاق متاحًا للشراء الفوري ودفعه إلى المشتري.
ملاحظة: بالنسبة للنطاق في فترة السماح للإضافة, إذا كان هناك بيع, فقد لا يعود من الممكن حذفه خلال فترة السماح. مزيد من المعلومات حول الحذف خلال فترة السماح
> make_offer
يمكنك اختيار تعيين سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ عرض.
ملاحظة: بالنسبة للنطاق في فترة السماح للإضافة, إذا كان هناك بيع, فقد لا يعود من الممكن حذفه خلال فترة السماح. مزيد من المعلومات حول الحذف خلال فترة السماح
> buy_now_and_make_offer سيؤدي تعيين سعر ثابت إلى جعل النطاق متاحًا للشراء الفوري ودفعه إلى المشتري.
يمكنك اختيار تعيين سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ عرض.
ملاحظة: بالنسبة للنطاق في فترة السماح للإضافة, إذا كان هناك بيع, فقد لا يعود من الممكن حذفه خلال فترة السماح. مزيد من المعلومات حول الحذف خلال فترة السماح
price (optional)السعر الذي تريد بيع نطاقك به. (إلزامي إذا كان for_sale_type هو marketplace)
minimum_offer (optional)الحد الأدنى للعرض الذي ستقبله لنطاقك. (إلزامي إذا كان for_sale_type هو marketplace)
installment (optional)هل يُسمح بالدفع بالتقسيط. إذا كنت تريد تمكين الدفع بالتقسيط, قم بتعيينه إلى "Yes"
maximum_installments (optional)الحد الأقصى لعدد الأقساط المسموح به يُستخدم فقط عندما تكون قيمة installment هي "true"
يمكنك اختيار قيمة من 2 إلى 12 لتمثيل الحد الأقصى للأشهر للدفع بالتقسيط
category (optional)اختر فئة لنطاقك، يمكنك الرجوع إلى جدول مقارنة الفئات والفئات الفرعية أدناه للتعبئة الاختيارية.
Sub-category (optional)اختر فئة فرعية لنطاقك، يمكنك الرجوع إلى جدول مقارنة الفئات والفئات الفرعية أدناه للاختيار.
ملاحظة: يجب أن تكون قيمة المعامل هي الرقم المقابل للفئة الفرعية.
| الفئة | فئة فرعية |
|---|
| advertising | marketing retail sales |
| automotive | cars_trucks enthusiasts motorsports |
| business | investment law money professions services |
| careers_education | No subCategory |
| consumer_goods_services | apparel electronics |
| entertainment | games pop_culture |
| fashion | No subCategory |
| finance | No subCategory |
| gambling | casino sports |
| health | fitness medicine |
| internet | blogs ecommerce domains web_design web_hosting |
| other | No subCategory |
| places | africa asia europe north_america south_america |
| real_estate | No subCategory |
| science | No subCategory |
| society | culture news politics religion |
| sports | leisure_activities professional |
| technology | computers |
| uncategorized | No subCategory |
| adult | No subCategory |
| home | No subCategory |
| ai | No subCategory |
| aerospace | No subCategory |
| agency | No subCategory |
| agriculture_company | No subCategory |
| analytics | No subCategory |
| alcohol | No subCategory |
| babies_kids | No subCategory |
| biotech | No subCategory |
| clean_energy | No subCategory |
| cleaning | No subCategory |
| community | No subCategory |
| construction_organization | No subCategory |
| cryptocurrency_blockchain | No subCategory |
| dating_relationship | No subCategory |
| daycare | No subCategory |
| dental | No subCategory |
| drone | No subCategory |
| e_commerce | No subCategory |
| food_drink | No subCategory |
| furniture | No subCategory |
| games | No subCategory |
| insurance | No subCategory |
| interior_design | No subCategory |
| legal_law | No subCategory |
| motivational | No subCategory |
| manufacturing | No subCategory |
| marketing | No subCategory |
| medical | No subCategory |
| metaverse | No subCategory |
| movies_tv | No subCategory |
| music_audio | No subCategory |
| news_media | No subCategory |
| nft | No subCategory |
| outdoor | No subCategory |
| payment | No subCategory |
| pets | No subCategory |
| politics | No subCategory |
| property_management | No subCategory |
| recruitment_staffing | No subCategory |
| services | No subCategory |
| security | No subCategory |
| social | No subCategory |
| transportation | No subCategory |
| travel | No subCategory |
| video_books_magazines | No subCategory |
| virtual_reality | No subCategory |
| website_design | No subCategory |
Description (optional)وصف نطاقك
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetForSaleResponse></SetForSaleResponse>العقدة الجذرية للاستجابة
<SetForSaleHeader></SetForSaleHeader>تعيين ترويسة For Sale
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على الإعداد للبيع
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetForSaleResponse>
<SetForSaleHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetForSaleHeader>
</SetForSaleResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
الاستجابة (تنسيق JSON){
"SetForSaleResponse": {
"ResponseCode: ": "0",
"Status": "Success"
}
} أمر قائمة النطاقات المنقولة للخارج
استدعاء أمر قائمة النطاقات المحوّلة للخارج سيعطيك قائمة النطاقات قيد المعالجة للتحويل للخارج. هذا الأمر متاح فقط بصيغة XML و JSON.إذا قمت باستدعاء هذا الأمر
معامل طلب قائمة النطاقات المنقولة للخارجشرح
معامل طلب قائمة النطاقات المنقولة للخارج
شرح
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<TransferOutDomainListResponse></TransferOutDomainListResponse>العقدة الجذرية للاستجابة
<TransferOutDomainListHeader></TransferOutDomainListHeader>رأس قائمة نقل النطاقات الخارجية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<TransferOutDomainListContent></TransferOutDomainListContent>رأس قائمة نقل النطاقات الخارجية
<TransferOutDomainList></TransferOutDomainList>قائمة النطاقات المنقولة للخارج
<Domain></Domain>اسم النطاق
<OrderId></OrderId>معرّف الطلب الخاص بنقل النطاق إلى الخارج
<ItemStatus></ItemStatus>حالة نقل النطاق للخارج
مثال قائمة النطاقات المحوّلة للخارج
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer_domain_list
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=transfer_domain_list
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<TransferOutDomainListResponse>
<TransferOutDomainListHeader>
<ResponseCode>200</ResponseCode>
<Status>success</Status>
</TransferOutDomainListHeader>
<TransferOutDomainListContent>
<TransferOutDomainList>
<TransferOutDomain>
<OrderId>1</OrderId>
<Domain>domain1.com</Domain>
<ItemStatus>Pending</ItemStatus>
</TransferOutDomain>
</TransferOutDomainList>
</TransferOutDomainListContent>
</TransferOutDomainListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer_domain_list
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=transfer_domain_list
الاستجابة (تنسيق JSON){
"TransferOutDomainListResponse": {
"ResponseCode": 200,
"Status": "success",
"TransferOutDomainList": [
{
"orderId": 1,
"domain": "domain1.com",
"itemStatus": "Pending"
}
]
}
} تعيين أمر تأكيد إجراء Afternic
استدعاء أمر تعيين إجراء تأكيد Afternic سيضبط النطاق للموافقة أو عدم الموافقة على النقل السريع على Afternic. هذا الأمر متاح فقط بصيغة XML و JSON. عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب تعيين إجراء تأكيد Afternicشرح
معامل طلب تعيين إجراء تأكيد Afternic
شرح
domainالنطاق الذي تريد تعيين إجراء تأكيد النقل السريع Afternic له، يمكن إدخال نطاق واحد فقط في كل طلب
actionالإجراء الذي تريد ضبط تأكيد Afternic عليه، يجب أن يكون "confirm_afternic"، أو "delete_from_afternic"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetAfternicConfirmActionResponse></SetAfternicConfirmActionResponse>وسم استجابة Set Afternic Confirm Action, إنها العقدة الجذرية لمستند XML للاستجابة
<SetAfternicConfirmActionHeader></SetAfternicConfirmActionHeader>تعيين ترويسة إجراء تأكيد Afternic
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إجراء تأكيد Afternic
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetAfternicConfirmActionResponse>
<SetAfternicConfirmActionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetAfternicConfirmActionHeader>
</SetAfternicConfirmActionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
الاستجابة (تنسيق JSON){
"SetAfternicConfirmActionResponse": {
"ResponseCode": "0",
"Status": "success"
}
} تعيين أمر إجراء تأكيد Sedo
استدعاء أمر تعيين إجراء تأكيد Sedo سيقوم بتعيين النطاق للموافقة أو عدم الموافقة على النقل السريع على Sedo. هذا الأمر متاح فقط بصيغة XML و JSON. إذا تم استدعاء هذا الأمر, يجب تضمين المعاملات التالية:
تعيين معلمة طلب إجراء تأكيد Sedoشرح
تعيين معلمة طلب إجراء تأكيد Sedo
شرح
domainالنطاق الذي تريد تعيين إجراء النقل السريع لتأكيد Sedo له، يمكن إدخال نطاق واحد فقط لكل طلب
actionالإجراء الذي تريد تعيين تأكيد sedo إليه, يجب أن يكون "confirm_sedo", أو "delete_from_sedo"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<SetSedoConfirmActionResponse></SetSedoConfirmActionResponse>وسم استجابة Set Sedo Confirm Action, إنه العقدة الجذرية لمستند XML الخاص بالاستجابة
<SetSedoConfirmActionHeader></SetSedoConfirmActionHeader>تعيين ترويسة إجراء تأكيد Sedo
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
مثال على تعيين إجراء تأكيد Sedo
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<SetSedoConfirmActionResponse>
<SetSedoConfirmActionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetSedoConfirmActionHeader>
</SetSedoConfirmActionResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
الاستجابة (تنسيق JSON){
"SetSedoConfirmActionResponse": {
"ResponseCode": "0",
"Status": "success"
}
} أمر الحصول على إحصائيات Whois
سيؤدي استدعاء أمر الحصول على إحصائيات Whois إلى الحصول على إحصائيات Whois. هذا الأمر متاح فقط بتنسيق XML وJSON. عند استدعاء هذا الأمر، يجب تضمين المعلمات التالية:
معامل طلب الحصول على إحصاءات Whoisشرح
معامل طلب الحصول على إحصاءات Whois
شرح
domain_nameاسم النطاق الذي تحتاج إلى إعداد DNSSEC له
date_typeيمكنك اختيار حقل من القائمة التالية لتمثيل نوع التاريخ الخاص بك:
last_7_days, last_30_days, current_year, last_year
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetWhoisStatsResponse></GetWhoisStatsResponse>العقدة الجذرية للاستجابة
<GetWhoisStatsHeader></GetWhoisStatsHeader>ترويسة الحصول على إحصاءات Whois
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetWhoisStatsContent></GetWhoisStatsContent>محتوى الاستجابة
<WhoisStats></WhoisStats>يحتوي على مجموعات متعددة من بيانات إحصاءات whois
<WhoisStat></WhoisStat>بيانات إحصاء Whois محددة
<Date></Date>الحد الأدنى للفاصل الزمني
<Count></Count>عدد Whois خلال الفترة الزمنية الحالية
مثال على الحصول على إحصاءات Whois
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetWhoisStatsResponse>
<GetWhoisStatsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetWhoisStatsHeader>
<GetWhoisStatsContent>
<WhoisStats>
<WhoisStat>
<Date>2023-11-04</Date>
<Count>200</Count>
</WhoisStat>
<WhoisStat>
<Date>2023-11-05</Date>
<Count>300</Count>
</WhoisStat>
<WhoisStat>
<Date>2023-11-06</Date>
<Count>100</Count>
</WhoisStat>
<WhoisStat>
<Date>2023-11-07</Date>
<Count>200</Count>
</WhoisStat>
<WhoisStat>
<Date>2023-11-08</Date>
<Count>300</Count>
</WhoisStat>
<WhoisStat>
<Date>2023-11-09</Date>
<Count>100</Count>
</WhoisStat>
<WhoisStat>
<Date>2023-11-10</Date>
<Count>200</Count>
</WhoisStat>
</WhoisStats>
</GetWhoisStatsContent>
</GetWhoisStatsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=get_whois_stats&domain_name=domain1.com&date_type=last_7_days
الاستجابة (تنسيق JSON){
"GetWhoisStatsResponse": {
"ResponseCode": 0,
"Status": "success",
"WhoisStats": [
{
"Date": "2023-11-04",
"Count": 200
},
{
"Date": "2023-11-05",
"Count": 300
},
{
"Date": "2023-11-06",
"Count": 100
},
{
"Date": "2023-11-07",
"Count": 200
},
{
"Date": "2023-11-08",
"Count": 300
},
{
"Date": "2023-11-09",
"Count": 100
},
{
"Date": "2023-11-10",
"Count": 200
}
]
}
} أمر قائمة الطلبات
استدعاء أمر قائمة الطلبات سيجلب قائمة الطلبات. هذا الأمر متاح فقط بصيغة XML و JSON.عند استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
معامل طلب قائمة الطلباتشرح
معامل طلب قائمة الطلبات
شرح
search_byيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع البحث الخاص بك: date_range, domain, order_id
start_dateتاريخ بدء استعلامك بتنسيق yyyy/MM/dd
end_dateتاريخ انتهاء استعلامك بتنسيق yyyy/MM/dd
payment_methodيمكنك اختيار عدة قيم من القائمة التالية لتمثيل طريقة الدفع الخاصة بك:
لا يوجد رصيد
رصيد الحساب
بطاقة_ائتمان
money_order
Paypal
Moneybooker
تحويل بنكي
علي باي
payflow_credit_card2 (لم يعد مستخدمًا)
wechat_pay
إيكاش
تحويل بنكي
apple_pay
حساب_جاري
بيع
union_pay
حساب باي بال
mercado_pago
Payoneer
لكن يرجى استخدام الفاصلة لفصل القيم المتعددة, على سبيل المثال: account_balance,credit_card
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<OrderListResponse></OrderListResponse>العقدة الجذرية للاستجابة
<OrderListHeader></OrderListHeader>ترويسة قائمة الطلبات
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<OrderListContent></OrderListContent>ترويسة قائمة الطلبات
<OrderList></OrderList>يحتوي على مجموعات متعددة من بيانات سجل الطلبات
<OrderItem></OrderItem>يحتوي على بيانات سجل طلب واحد
<OrderItemDomain></OrderItemDomain>اسم النطاق الذي يتضمن العناصر في هذا الطلب
<OrderId></OrderId>يحتوي على معرّف الطلب
<SubmittedDate></SubmittedDate>يحتوي على تاريخ تقديم الطلب
<Cost></Cost>يتضمن تكلفة الطلب
<Status></Status>يحتوي على حالة الطلب
مثال قائمة الطلبات
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<OrderListResponse>
<OrderListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</OrderListHeader>
<OrderListContent>
<OrderList>
<Order>
<OrderId>123456</OrderId>
<SubmittedDate>1791875010219</SubmittedDate>
<Currency>USD</Currency>
<PaymentMethod>Account Balance</PaymentMethod>
<TotalCost>$8.00</TotalCost>
<TotalPaid>$8.00</TotalPaid>
<Status>Problem</Status>
<OrderItem>
<ItemType>Domain Registration</ItemType>
<Name>test.com</Name>
<Duration>1</Duration>
<Cost>2.99</Cost>
<Status>Completed</Status>
</OrderItem>
<OrderItem>
<ItemType>Domain Renewal</ItemType>
<Name>test1.ac</Name>
<Duration>1</Duration>
<Cost>3.99</Cost>
<Status>Completed</Status>
</OrderItem>
<OrderItem>
<ItemType>Domain Transfer</ItemType>
<Name>test2.de</Name>
<Duration>1</Duration>
<Cost>4.99</Cost>
<Status>Completed</Status>
</OrderItem>
<OrderItem>
<ItemType>Domain Registration</ItemType>
<Name>test3.gg</Name>
<Duration>1</Duration>
<Cost>5.99</Cost>
<Status>Completed</Status>
</OrderItem>
<OrderItem>
<ItemType>Domain Renewal</ItemType>
<Name>test4.uk</Name>
<Duration>1</Duration>
<Cost>6.99</Cost>
<Status>Completed</Status>
</OrderItem>
<OrderItem>
<ItemType>Domain Transfer</ItemType>
<Name>test5.net</Name>
<Duration>1</Duration>
<Cost>7.99</Cost>
<Status>Completed</Status>
</OrderItem>
</Order>
<Order>
<OrderId>123457</OrderId>
<SubmittedDate>1791875010219</SubmittedDate>
<Currency>EUR</Currency>
<PaymentMethod>Paypal</PaymentMethod>
<TotalCost>$100.00</TotalCost>
<TotalPaid>$100.00</TotalPaid>
<Status>Submitted</Status>
</Order>
</OrderList>
</OrderListContent>
</OrderListResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
الاستجابة (تنسيق JSON){
"OrderListResponse": {
"ResponseCode": 0,
"Status": "success",
"OrderList": [
{
"OrderId": "123456",
"SubmittedDate": "2026/10/13",
"Currency": "USD",
"PaymentMethod": "Account Balance",
"TotalCost": "$8.00",
"TotalPaid": "$8.00",
"Status": "Problem",
"ItemList": [
{
"ItemType": "Domain Registration",
"Name": "test.com",
"Duration": 1,
"Cost": "2.99",
"Status": "Completed"
},
{
"ItemType": "Domain Renewal",
"Name": "test1.ac",
"Duration": 1,
"Cost": "3.99",
"Status": "Completed"
},
{
"ItemType": "Domain Transfer",
"Name": "test2.de",
"Duration": 1,
"Cost": "4.99",
"Status": "Completed"
},
{
"ItemType": "Domain Registration",
"Name": "test3.gg",
"Duration": 1,
"Cost": "5.99",
"Status": "Completed"
},
{
"ItemType": "Domain Renewal",
"Name": "test4.uk",
"Duration": 1,
"Cost": "6.99",
"Status": "Completed"
},
{
"ItemType": "Domain Transfer",
"Name": "test5.net",
"Duration": 1,
"Cost": "7.99",
"Status": "Completed"
}
]
},
{
"OrderId": "123457",
"SubmittedDate": "2026/10/13",
"Currency": "EUR",
"PaymentMethod": "Paypal",
"TotalCost": "$100.00",
"TotalPaid": "$100.00",
"Status": "Submitted",
"ItemList": []
}
]
}
} أمر الحصول على حالة الطلب
استدعاء أمر الحصول على حالة الطلب سيجلب حالة الطلب. هذا الأمر متاح فقط بصيغة XML و JSON. إذا قمت باستدعاء هذا الأمر، يجب تضمين المعلمات التالية:
معلمة طلب الحصول على حالة الطلبشرح
معلمة طلب الحصول على حالة الطلب
شرح
order_idمعرّف الطلب المراد الاستعلام عنه
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<GetOrderStatusResponse></GetOrderStatusResponse>العقدة الجذرية للاستجابة
<GetOrderStatusHeader></GetOrderStatusHeader>الحصول على ترويسة حالة الطلب
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<GetOrderStatusContent></GetOrderStatusContent>محتوى الاستجابة
<OrderId></OrderId>معرف الطلب
<OrderStatus></OrderStatus>حالة الطلب( Shopping, Submitted, Waitpay, Processing, Completed, Problem, Deleted, Cancelled )
<ItemTypeName></ItemTypeName>نوع العنصر
<ItemName></ItemName>اسم العنصر
<ItemStatus></ItemStatus>حالة العنصر(مكتمل, ملغي, مشكلة)
مثال Get Order Status
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
طلب البيئة التجريبية (تنسيق XML)https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<GetOrderStatusResponse>
<GetOrderStatusHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetOrderStatusHeader>
<GetOrderStatusContent>
<OrderId>0</OrderId>
<OrderStatus>Completed</OrderStatus>
<Item>
<ItemTypeName>domain transfer away</ItemTypeName>
<ItemName>&</ItemName>
<ItemStatus>transfer.com</ItemStatus>
</Item>
<Item>
<ItemTypeName>domain</ItemTypeName>
<ItemName>&</ItemName>
<ItemStatus>register.com</ItemStatus>
</Item>
</GetOrderStatusContent>
</GetOrderStatusResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
طلب البيئة التجريبية (تنسيق JSON)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
الاستجابة (تنسيق JSON){
"GetOrderStatusResponse": {
"ResponseCode": 0,
"Status": "success",
"OrderStatus": {
"OrderId": 0,
"OrderStatus": "Completed",
"ItemList": [
{
"ItemTypeName": "domain transfer away",
"ItemName": "transfer.com",
"ItemStatus": "Completed"
},
{
"ItemTypeName": "domain",
"ItemName": "register.com",
"ItemStatus": "Completed"
}
]
}
}
} أمر قيد المعالجة
استدعاء الأمر is_processing سيخبرك ما إذا كان من الآمن إرسال طلب جديد
Is-Processing معلمة الطلبشرح
Is-Processing معلمة الطلب
شرح
لا حاجة إلى معلمة إضافية
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<Response></Response>وسم استجابة is_processing
<ResponseHeader></ResponseHeader>علامة ترويسة is_processing
<ResponseMsg></ResponseMsg>Tag of is_processing response message. It should be "yes"(There is a process in the system. You shouldn't sent another request.) or "no"(There is no any process for you account. It is safe to submit a new request.)
مثال على قيد المعالجة
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=is_processing
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=is_processing
الاستجابة (تنسيق XML)<Response>
<ResponseHeader>
<ResponseCode>0</ResponseCode>
<ResponseMsg>yes</ResponseMsg>
</ResponseHeader>
</Response> طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=is_processing
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=is_processing
الاستجابة (تنسيق JSON){
"Response":{
"ResponseCode":"0",
"ResponseMsg":"no"
}
} طلب (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=is_processing
طلب البيئة التجريبية (تنسيق CSV)https://api-sandbox.dynadot.com/api3.html?key=[Sandbox API Key]&command=is_processing
الاستجابة (تنسيق CSV)ok,yes
أمر سرد القسائم
سيؤدي استدعاء أمر قائمة الكوبونات إلى الحصول على جميع الكوبونات. هذا الأمر متاح فقط بصيغة XML و JSON. عند استدعاء هذا الأمر, يجب تضمين المعلمات التالية:
معلمة طلب قائمة الكوبوناتشرح
معلمة طلب قائمة الكوبونات
شرح
coupon_typeيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع البحث لديك: "registration" , "renewal" , أو "transfer"
وسم XML للنتيجةشرح
وسم XML للنتيجة
شرح
<ListCouponsResponse></ListCouponsResponse>العقدة الجذرية للاستجابة
<ListCouponsHeader></ListCouponsHeader>ترويسة قائمة الكوبونات
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما تكون الحالة "error"
<ListCouponsContent></ListCouponsContent>محتوى قائمة الكوبونات
<Coupons></Coupons>يحتوي على مجموعات متعددة من بيانات القسائم
<Coupon></Coupon>يحتوي على بيانات قسيمة واحدة
<Code></Code>رمز الكوبون
<Description></Description>وصف القسيمة
<CouponType></CouponType>نوع الكوبون
<DiscountType></DiscountType>نوع الخصم الذي تقدمه القسيمة
<DiscountInfo></DiscountInfo>معلومات الخصم الخاصة بالكوبون
<Percentage></Percentage>نسبة الخصم
<AUD></AUD>مبلغ الخصم بالدولار الأسترالي
<MXN></MXN>مبلغ الخصم بالبيزو المكسيكي
<EUR></EUR>مبلغ الخصم باليورو
<GBP></GBP>مبلغ الخصم بالجنيه الإسترليني
<IDR></IDR>مبلغ الخصم بالروبية الإندونيسية
<USD></USD>مبلغ الخصم بالدولار الأمريكي
<CAD></CAD>مبلغ الخصم بالدولار الكندي
<INR></INR>مبلغ الخصم بالروبية الهندية
<BRL></BRL>مبلغ الخصم بالريال البرازيلي
<CNY></CNY>مبلغ الخصم باليوان الصيني
<Restriction></Restriction>قيود الكوبون
<PriceLevels></PriceLevels>مجموعة من مستويات الأسعار التي تدعم استخدام الكوبونات
<UsesPerAccount></UsesPerAccount>عدد المرات التي يمكن فيها استخدام القسيمة لكل حساب
<UsesSystemWide></UsesSystemWide>عدد المرات التي يمكن استخدام القسيمة فيها على مستوى النظام
<UsesPerIp></UsesPerIp>عدد المرات التي يمكن فيها استخدام القسيمة لكل عنوان IP
<ItemsPerAccount></ItemsPerAccount>عدد العناصر التي يمكن استخدام الكوبون من أجلها لكل حساب
<ItemsSystemWide></ItemsSystemWide>عدد العناصر التي يمكن استخدام الكوبون لها على مستوى النظام
<ItemsPerOrder></ItemsPerOrder>عدد العناصر التي يمكن استخدام القسيمة من أجلها لكل طلب
<ItemsPerDay></ItemsPerDay>عدد العناصر التي يمكن استخدام القسيمة لها يومياً
<IdnRestriction></IdnRestriction>قيود IDN للكوبون
<DomainDurationMin></DomainDurationMin>الحد الأدنى لمدة النطاق
<DomainDurationMax></DomainDurationMax>الحد الأقصى لمدة النطاق
<Tlds></Tlds>مجموعة من نطاقات المستوى الأعلى التي تدعم استخدام الكوبونات
<Tld></Tld>نطاق من المستوى الأعلى واحد يدعم استخدام القسائم
<Currencies></Currencies>مجموعة من أنواع العملات التي تدعم استخدام القسائم
<Currency></Currency>نوع عملة واحد يدعم استخدام الكوبونات
<StartDate></StartDate>تاريخ بدء صلاحية القسيمة
<EndDate></EndDate>تاريخ انتهاء صلاحية القسيمة
مثال على قائمة الكوبونات
طلب (تنسيق XML)https://api.dynadot.com/api3.xml?key=[API Key]&command=list_coupons&coupon_type=renewal
طلب البيئة التجريبية (تنسيق XML)https://api-sandbox.dynadot.com/api3.xml?key=[Sandbox API Key]&command=list_coupons&coupon_type=renewal
الاستجابة (تنسيق XML)<?xml version="1.0" encoding="UTF-8"?>
<ListCouponsResponse>
<ListCouponsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</ListCouponsHeader>
<ListCouponsContent>
<Coupons>
<Coupon>
<Code>DOMAINRENEW1</Code>
<Description>Domain Renew Coupon</Description>
<CouponType>Hosting/SSL Coupons</CouponType>
<DiscountType>PERCENTAGE_OFF</DiscountType>
<DiscountInfo>
<Percentage>10%</Percentage>
</DiscountInfo>
<Restriction>
<PriceLevels>Any</PriceLevels>
<IdnRestriction>None</IdnRestriction>
<DomainDurationMin>1</DomainDurationMin>
<DomainDurationMax>1</DomainDurationMax>
<Tlds>
<Tld>.com</Tld>
<Tld>.net</Tld>
<Tld>.org</Tld>
</Tlds>
<Currencies>
<Currency>US Dollar USD ($)</Currency>
</Currencies>
</Restriction>
<StartDate>1476811260000</StartDate>
<EndDate>1483257540000</EndDate>
</Coupon>
</Coupons>
</ListCouponsContent>
</ListCouponsResponse>
طلب (تنسيق JSON)https://api.dynadot.com/api3.json?key=[API Key]&command=list_coupons&coupon_type=renewal
طلب البيئة التجريبية (تنسيق JSON)https://api-sandbox.dynadot.com/api3.json?key=[Sandbox API Key]&command=list_coupons&coupon_type=renewal
الاستجابة (تنسيق JSON){
"ListCouponsResponse": {
"ResponseCode": 0,
"Status": "success",
"Coupons": [
{
"Code": "DOMAINRENEW1",
"Description": "Domain Renew Coupon",
"CouponType": "Hosting/SSL Coupons",
"DiscountType": "PERCENTAGE_OFF",
"DiscountInfo": {
"Percentage": "10%"
},
"Restriction": {
"PriceLevels": "Any",
"IdnRestriction": "None",
"DomainDurationMin": "1",
"DomainDurationMax": "1",
"Tlds": [
".com",
".net",
".org"
],
"Currencies": [
"US Dollar USD ($)"
]
},
"StartDate": "1476811260000",
"EndDate": "1483257540000"
}
]
}
}