طلب المعلمةالشرح
طلب المعلمة
الشرح
Keyمفتاحك للوصول إلى واجهة برمجة التطبيقات، متاح في لوحة تحكم حساب داينادوت الخاص بك تحت قائمة الأدوات الجانبية 'الأدوات' -> 'واجهة برمجة التطبيقات'.
CommandDomain:
, , , , , ,
, , , , , , , , , , , , , , , , , , ,
, , , ,
, contact:
, , , , , ,
, , Nameserver:
, , , , , , , Account:
, , , , , , , , , , , , Folder:
, , , , , , , , , , , , , , Aftermarket:
, ,
, , , ,
, , , , , , , , Other:
, , , , , , XML التنسيق. يجب أن يحتوي الرد الذي تتلقاه على اثنين أو ثلاثة من الحقول التالية:
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
أمر البحث
إذا تم استدعاء أمر البحث، يجب تضمين المعايير التالية:
طلب بحث المعاملاتالشرح
طلب بحث المعاملات
الشرح
domain0 - domain99اسم المجال الذي تبحث عنه، يمكن للحساب العادي تحديد مجال واحد لكل أمر، بينما يمكن للحساب الجملة والحساب الجملة الفائق تحديد حتى 100 مجالات
language0 - language99 (اختياري)علامة اللغة الخاصة ب المجال المعني، استخدم هذا فقط لأسماء المجالات الدولية
show_price (اختياري)إذا كنت ترغب في عرض السعر بعملة حسابك، قم بضبطها لتتساوى مع "1".
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<Results></Results>عقدة الجذر لاستجابة XML الخاصة بأمر البحث
<SearchResponse></SearchResponse>علامة استجابة البحث
<SearchHeader></SearchHeader>علامة رأس البحث
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<DomainName></DomainName>اسم المجال الذي بحثت عنه للتو
<Available></Available>إذا كان اسم المجال متاحًا
<Price></Price>إذا قمت بضبط عرض_السعر على 1، فسيخبرك ذلك بمعلومات السعر إذا كان هذا المجال متاحًا.
<Language></Language>معلومات اللغة عن اسم المجال
Search ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
Response (XML format)
<Results>
<SearchResponse>
<SearchHeader>
<SuccessCode>0</SuccessCode>
<DomainName>mydomain.com</DomainName>
<Available>yes</Available>
<Price>77.00 in USD</Price>
</SearchHeader>
</SearchResponse>
<SearchResponse>
<SearchHeader>
<SuccessCode>0</SuccessCode>
<DomainName>mydomain.net</DomainName>
<Available>yes</Available>
<Price>44.00 in USD</Price>
</SearchHeader>
</SearchResponse>
</Results>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1¤cy=USD
Response (JSON format){
"SearchResponse":{
"ResponseCode":"0",
"SearchResults":[
{
"DomainName":"mydomain.com",
"Available":"yes",
"Price":"77.00 in USD"
},
{
"DomainName":"mydomain.net",
"Available":"yes",
"Price":"44.00 in USD"
}
]
}
}
أمر التسجيل
إن استدعاء أمر التسجيل سيقوم بإنشاء ومعالجة طلب تسجيل. يجب أن يكون لديك رصيد كافٍ في الحساب لدفع قيمة الطلب. إذا تم استدعاء أمر التسجيل، يجب تضمين البارامترات التالية:
طلب تسجيل المعلمةالشرح
طلب تسجيل المعلمة
الشرح
domainاسم المجال الذي ترغب في تسجيله، يمكن تسجيل مجال 1 واحد فقط لكل طلب
language (اختياري)علامة اللغة لل مجال المطلوب، مطلوبة فقط إذا كان المجال هو مجال ذو أسماء دولية.
durationكم من الوقت يستغرق تسجيل المجال؟
registrant_contact (اختياري)المسجل الذي تريد استخدامه للاتصال في المجال
admin_contact (اختياري)الجهة الإدارية التي ترغب في استخدامها على المجال
technical_contact (اختياري)الاتصال الفني الذي ترغب في استخدامه على المجال
billing_contact (اختياري)جهة الاتصال الخاصة بالفوترة التي ترغب في استخدامها على المجال
option0 (إذا لزم الأمر)
اسم المسجل .AT, .BE,
option1 (إذا لزم الأمر)منظمة المسجل .AT, .BE, (اختياري)
لـ .AT، يمكنك تحديد option0, option1, أو كلاهما
premium (اختياري)إذا كنت ترغب في تسجيل مجال مميز، قم بضبطه مساوياً لـ "1" (اختياري)
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<RegisterResponse></RegisterResponse>علامة استجابة التسجيل
<RegisterHeader></RegisterHeader>علامة تسجيل الرأس
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<RegisterContent></RegisterContent>علامة محتوى التسجيل
<Expiration></Expiration>تاريخ انتهاء الصلاحية بتوقيت يونكس (مللي ثانية منذ منتصف الليل بتوقيت UTC من يناير 1، 1970)، يستخدم فقط عندما يكون النتيجة "success"
<Registration></Registration>تاريخ التسجيل بتوقيت Unix (بالميلي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)، يُستخدم فقط عندما يكون النتيجة "success"
تسجيل مثال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=register&domain=domain1.net&duration=3¤cy=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<RegisterResponse>
<RegisterHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RegisterHeader>
<RegisterContent>
<Expiration>1458379145266</Expiration>
</RegisterContent>
</RegisterResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=register&domain=domain1.net&duration=3¤cy=USD
Response (JSON format){
"RegisterResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainName": "domain1.net",
"Expiration": 1458379145266
}
}
أمر الحذف
تنفيذ أمر الحذف سيؤدي إلى حذف دومين لا يزال في فترة السماح. سيتم إعادة رصيد حسابك برسوم التسجيل. لا يمكن حذف الدومينات التي تم تجديدها، أو التي تم انتقالها إلى حساب جديد من خلال واجهة برمجة التطبيقات. إذا تم تنفيذ أمر الحذف، فيجب تضمين العوامل التالية:
حذف معامل الطلبالشرح
حذف معامل الطلب
الشرح
domain المجال الذي ترغب في حذفه، يمكن حذف مجال 1 واحد فقط لكل طلب
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<DeleteResponse></DeleteResponse>علامة استجابة الحذف
<DeleteHeader></DeleteHeader>علامة حذف الرأس
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال حذف
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=delete&domain=domain1.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteResponse>
<DeleteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteHeader>
</DeleteResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete&domain=domain1.com
Response (JSON format){
"DeleteResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainName": "domain1.com"
}
}
تجديد الأمر
استدعاء أمر التجديد سيقوم بإنشاء ومعالجة أمر تجديد. يجب أن يكون لديك رصيد كاف في الحساب لدفع ثمن الطلب. إذا كنت تستدعي أمر التجديد، يجب تضمين البارامترات التالية:
طلب تجديد البارامترالشرح
طلب تجديد البارامتر
الشرح
domainاسم المجال الذي تريد تجديده، يمكن تجديد مجال 1 واحد فقط لكل طلب
durationكم عدد السنوات لتجديد المجال ل؟
year (اختياري)السنة الحالية التي ينتهي فيها تسجيل المجال
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
price_check (اختياري)يمكنك إضافة هذه الباراميتر إلى الأمر لفحص تفاصيل السعر لتجديد هذا المجال. ملاحظة: عند إضافة هذه الباراميتر إلى الأمر، لن يقوم واجهة برمجة التطبيقات الخاصة بنا بتجديد المجال، ولكن ستعرض فقط معلومات السعر.
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
no_renew_if_late_renew_fee_needed (اختياري)يمكنك إضافة هذا المعامل إلى الأمر لتجنب التجديد إذا كان المجال يتطلب رسوم تجديد متأخرة. إذا كان المجال يتطلب رسوم تجديد متأخرة للتجديد، وتم تمرير "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"
Renew ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
Response (XML format)
<RenewResponse>
<RenewHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RenewHeader>
<RenewContent>
<Expiration>73984579834</Expiration>
</RenewContent>
</RenewResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&domain=domian1.com&command=renew&duration=1¤cy=USD&coupon=testcoupon
Response (JSON format){
"RenewResponse":{
"ResponseCode":"0",
"Status":"success",
"DomainName":"domain1.com",
"Expiration":"73984579834"
}
}
أمر الدفع
استدعاء أمر الدفع سيقوم بإنشاء ومعالجة أمر دفع. يجب فتح قفل مجالك وحسابك للأمر. يجب على حساب المستقبل رفض أو قبول المجال لإكمال الأمر. إذا تم استدعاء أمر الدفع، يجب تضمين العوامل التالية:
طلب الدفع للمعاملةالشرح
طلب الدفع للمعاملة
الشرح
domainاسم المجال الذي ترغب في دفعه. نحن ندعم أيضاً الدفع الجماعي، يمكنك استخدام ";" لتقسيم المجالات. مثال: domain1.com;domain2.com
receiver_push_usernameاسم المستخدم لحساب المستقبل
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
unlock_domain_for_push(optional)قم بضبط هذه القيمة بما يعادل "1". إذا كان المجال مغلقًا، سنقوم بفتحه تلقائيًا، لذا لا تحتاج إلى فتح المجال يدويًا.
receiver_email(optional)بريد دفع لحساب المستقبل
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<PushResponse></PushResponse>علامة استجابة الدفع، إنها العقدة الجذرية لمستند الاستجابة XML
<PushHeader></PushHeader>رأس الدفع
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Push ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
Response (XML format)
<PushResponse>
<PushHeader>
<SuccessCode>0</SuccessCode>
<Status>order created</Status>
</PushHeader>
</PushResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=push&domain=domian1.com&receiver_push_username=username¤cy=USD
Response (JSON format){
"PushResponse":{
"ResponseCode":"0",
"Status":"order created"
}
}
أمر ال انتقال
استدعاء أمر ال انتقال سيؤدي إلى إنشاء ومعالجة طلب ال انتقال. قد تتطلب بعض مجالات المستوى الأعلى من المسجل المفقود تأكيد الطلب لإتمامه. في حال استدعاء أمر ال انتقال، يجب تضمين المعايير التالية:
طلب انتقال المعاملةالشرح
طلب انتقال المعاملة
الشرح
domainاسم المجال الذي ترغب في انتقاله إلى Dynadot، يمكن انتقال مجال 1 واحد فقط لكل طلب
authرمز التفويض لطلب ال انتقال.
currency (اختياري)يمكنك تحديد نوع العملة والمعلمات المدعومة هي دولار أمريكي، يوان صيني، جنيه بريطاني، يورو، روبية هندية، دولار كندي وغيرها. إذا لم تحدد هذه المعلمة، سنستخدم العملة الافتراضية للحساب.
registrant_contact (اختياري)جهة الاتصال المسجلة التي ترغب في استخدامها عند اكتمال ال انتقال. (لا تدعم جميع مجالات المستوى الأعلى هذه الميزة)
admin_contact (اختياري)جهة الاتصال الإدارية التي ترغب في استخدامها عند اكتمال ال انتقال. (لا تدعم جميع أسماء المجالات العليا هذه الميزة)
technical_contact (اختياري)الجهة الفنية التي ترغب باستخدامها عند اكتمال ال انتقال. (لا تدعم جميع أسماء المجالات العليا هذه الميزة)
billing_contact (اختياري)جهة الاتصال الخاصة بالفوترة التي ترغب في استخدامها عند اكتمال عملية ال انتقال. (لا تدعم جميع مجالات tld هذه الميزة)
premium (اختياري)إذا كنت ترغب في نقل نطاق مميز، قم بضبطه على "1" (اختياري)
privacy (اختياري)حالة الخصوصية للنطاق الذي تريد تعيينه، يمكن أن تكون "on" أو "off". . سيتم تطبيق مستوى الخصوصية الافتراضي للحساب إذا تم إعطاء إدخال خاطئ أو لم يتم إعطاء أي إدخال.
name_servers (اختياري)قائمة خوادم الأسماء التي سيتم تطبيقها على النطاق بمجرد اكتمال عملية النقل. يمكنك استخدام "," لفصل خوادم الأسماء. مثال: ns1.domain1.com,ns2.domain2.com
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<TransferResponse></TransferResponse>علامة استجابة ال انتقال، إنها العقدة الجذرية لوثيقة الاستجابة XML
<TransferHeader></TransferHeader> انتقال العنوان
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال على التحويل
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<TransferResponse>
<TransferHeader>
<SuccessCode>0</SuccessCode>
<Status>order created</Status>
<DomainName>domain1.com</DomainName>
<OrderId>1234567</OrderId>
</TransferHeader>
</TransferResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=transfer&domain=domian1.com&auth=testauth¤cy=USD&coupon=testcoupon
Response (JSON format){
"TransferResponse": {
"ResponseCode": 0,
"Status": "order created",
"DomainName": "domain1.com",
"OrderId": "1234567"
}
}
أمر التسجيل الجماعي
استدعاء أمر التسجيل الجماعي سينشئ ويعالج أوامر التسجيل. يجب أن يكون لديك رصيد كافٍ في الحساب لدفع ثمن الطلبات. إذا تم استدعاء أمر التسجيل الجماعي، يجب تضمين المعايير التالية:
طلب تسجيل بالجملةالشرح
طلب تسجيل بالجملة
الشرح
domain0-domain99الأسماء المجالية التي ترغب في تسجيلها، يمكن تسجيل 100 مجالات كحد أقصى لكل طلب
premium (اختياري)إذا كنت ترغب في تسجيل مجال مميز، قم بضبطه مساوياً لـ "1" (اختياري)
currency (اختياري)يمكنك تحديد نوع العملة والمعايير المدعومة هي "USD"، "CNY"، "GBP"، "EUR"، "INR"، "CAD" وغيرها. إذا لم تحدد هذه المعايير، سنستخدم العملة الافتراضية للحساب.
coupon (اختياري)رمز القسيمة الذي ترغب في تطبيقه على هذا الأمر
نتيجة علامة 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"
مثال على التسجيل الجماعي
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BulkRegisterResponse>
<BulkRegisterHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BulkRegisterHeader>
<BulkRegisterContent>
<BulkRegister>
<RegisterResult>
<DomainName>domain0.com</DomainName>
<Expiration>1234567890</Expiration>
<Result>success</Result>
<Message>-</Message>
</RegisterResult>
<RegisterResult>
<DomainName>domain1.com</DomainName>
<Expiration>-</Expiration>
<Result>error</Result>
<Message>not_available</Message>
</RegisterResult>
</BulkRegister>
</BulkRegisterContent>
</BulkRegisterResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=bulk_register&domain0=domain0.com&domain1=domain1.com¤cy=USD
Response (JSON format){
"BulkRegisterResponse": {
"ResponseCode": 0,
"Status": "success",
"BulkRegister": [
{
"DomainName": "domain0.com",
"Expiration": "1234567890",
"Result": "success",
"Message": "-"
},
{
"DomainName": "domain1.com",
"Expiration": "-",
"Result": "error",
"Message": "not_available"
}
]
}
}
معلومات المجال
هذا الأمر متاح فقط بصيغة XML و JSON:
طلب معلومات المجالالشرح
طلب معلومات المجال
الشرح
domainفقط نطاق 1 مسموح به في كل طلب
نتيجة علامة 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 (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Registration></Registration>تاريخ تسجيل المجال بتوقيت يونيكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1، 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم اسم المجال
<Type></Type>نوع خادم اسم المجال
<WithAds></WithAds>إذا كنت تريد صفحة انتظار ل مجالك
<Whois></Whois>معلومات الاستعلام عن المالك
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرف الاتصال
<Admin></Admin>معلومات الإدارة
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>تمكين الحالة
<UdrpLocked></UdrpLocked>مقفل بموجب الإجراء الموحد لتسوية نزاعات المجالات أم لا
<UdrpLocked></UdrpLocked>مقفل بموجب الإجراء الموحد لتسوية نزاعات المجالات أم لا
<RegistrantUnverified></RegistrantUnverified>المسجل غير مؤكد
<Hold></Hold>يمسك
<Privacy></Privacy>حالة الخصوصية
<isForSale></isForSale>حالة البيع
<RenewOption></RenewOption>خيار التجديد
<Note></Note>ملاحظة
<Folder></Folder>معلومات المجلد
<FolderId></FolderId>معرف المجلد
<FolderName></FolderName>اسم المجلد
Domain Information ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=domain_info&domain=domain1.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DomainInfoResponse>
<DomainInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</DomainInfoHeader>
<DomainInfoContent>
<Domain>
<Name>domain1.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>0</ContactId>
</Registrant>
<Admin>
<ContactId>0</ContactId>
</Admin>
<Technical>
<ContactId>0</ContactId>
</Technical>
<Billing>
<ContactId>0</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>yes</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
</Domain>
</DomainInfoContent>
</DomainInfoResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=domain_info&domain=domain1.com
Response (JSON format){
"DomainInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"DomainInfo": {
"Name": "domain1.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "0"
},
"Admin": {
"ContactId": "0"
},
"Technical": {
"ContactId": "0"
},
"Billing": {
"ContactId": "0"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "yes",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
}
}
}
}
تعيين أمر الويز
إذا تم استدعاء أمر 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"
Set Whois ExampleRequest (XML format)
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
Response (XML format)
<SetWhoisResponse>
<SetWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetWhoisHeader>
</SetWhoisResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_whois&domain=domain4.com®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format){
"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
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetNsResponse>
<SetNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNsHeader>
</SetNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns&domain=domain1.com,domain2.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com
Response (JSON format){
"SetNsResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
تعيين أمر وقوف السيارات
إذا تم استدعاء أمر تعيين موقف السيارات، يجب تضمين المعايير التالية:
تعيين معامل طلب ركن السيارةالشرح
تعيين معامل طلب ركن السيارة
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
with_ads (اختياري)إذا كنت لا ترغب في الإعلانات من طرف ثالث، يمكنك استخدام هذه الباراميتر مع "no"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetParkingResponse></SetParkingResponse>علامة تعيين استجابة المواقف، إنها العقدة الجذرية لوثيقة الاستجابة XML
<SetParkingHeader></SetParkingHeader>تعيين عنوان مجلد وقوف السيارات
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Parking ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
Response (XML format)
<SetParkingResponse>
<SetParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetParkingHeader>
</SetParkingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_parking&domain=domain1.com&with_ads=no
Response (JSON format){
"SetParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر التوجيه
إذا كنت تستدعي أمر تعيين التوجيه، فيجب تضمين البارامترات التالية:
تعيين معامل طلب التوجيهالشرح
تعيين معامل طلب التوجيه
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
forward_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه المجال الخاص بك التي تريدها، القيمة الافتراضية هي "temporary", إذا كنت ترغب في التوجيه الدائم، استخدم هذا المعامل مع "no"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetForwardingResponse></SetForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetForwardingHeader></SetForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Forwarding ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Response (XML format)
<SetForwardingResponse>
<SetForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetForwardingHeader>
</SetForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_forwarding&forward_url=http://www.mydomain.com&domain=domain1.com,domain2.com
Response (JSON format){
"SetForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر التخفي
إذا كان الأمر المستخدم هو تعيين الوضع الخفي، يجب أن تتضمن البارامترات التالية:
تعيين معامل طلب الخفاءالشرح
تعيين معامل طلب الخفاء
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
stealth_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (اختياري)عنوان الصفحة
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetStealthResponse></SetStealthResponse>العقدة الجذرية لمستند الاستجابة XML
<SetStealthHeader></SetStealthHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Stealth ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (XML format)
<SetStealthResponse>
<SetStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetStealthHeader>
</SetStealthResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_stealth&domain=domain1.com&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (JSON format){
"SetStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر الاستضافة
إذا تم استدعاء أمر تعيين الاستضافة، فيجب تضمين المعاملات التالية:
تعيين معلمة طلب الاستضافةالشرح
تعيين معلمة طلب الاستضافة
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
hosting_typeنوع الاستضافة التي ترغب بها، يمكنك اختياره في "advanced" و "basic"
mobile_view_onفقط عندما يكون نوع الاستضافة "advanced", يمكنك استخدام هذه البارامتر كـ "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetHostingResponse></SetHostingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetHostingHeader></SetHostingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Hosting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Response (XML format)
<SetHostingResponse>
<SetHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetHostingHeader>
</SetHostingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_hosting&domain=domain8.com&hosting_type=advanced&mobile_view_on=yes
Response (JSON format){
"SetHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر تعيين DNS2
إذا تم استدعاء أمر تعيين 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حدد سجل نظام أسماء المجالات ل مجالك
main_recordx0 - main_recordx19مسافة خادم البريد، نوع التوجيه (301 كـ "1"، 302 كـ "2")، عنوان التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون main_record_type هو "forward"،"mx"،"stealth"،"email".
subdomain0 - subdomain99 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type99نوع سجل المجال الفرعي، يجب أن يكون A، AAAA، CNAME، FORWARD، TXT، SRV، MX، STEALTH، EMAIL.
sub_record0 - sub_record99عنوان IP الفرعي أو الخادم المستهدف
sub_recordx0 - sub_recordx99مسافة Mx، نوع الإعادة، عنوان إعادة السرية أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون main_record_type هو إعادة، mx، سرية، بريد.
ttl (اختياري)وقت العيش
add_dns_to_current_setting (اختياري)إذا كنت ترغب في إضافة إعدادات DNS الجديدة إلى إعدادات DNS الحالية، قم بتعيينها بما يعادل "1" (اختياري)
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDnsResponse></SetDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDnsHeader></SetDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set DNS2 ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnsResponse>
<SetDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDnsHeader>
</SetDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dns2&domain=domain1.com&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1&main_record_type1=mx&main_record1=mail1.myisp.com&main_recordx1=0&subdomain0=www&sub_record_type0=a&sub_record0=192.168.1.1
Response (JSON format){
"SetDnsResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
أمر تعيين Dnssec
استدعاء أمر تعيين Dnssec سيقوم بتعيين dnssec لل مجال. هذا الأمر متاح فقط بصيغة XML و JSON. إذا تم استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
يمكنك اختيار ملء قيم المعاملات المقابلة في الخيار استنادًا إلى اسم المجال الخاص بك.
الخيار 1: domain_name، key_tag، digest_type، digest، algorithm
الخيار 2: domain_name، flags، public_key، algorithm
ملاحظات: يُرجى اختيار رقم العلامة المقابلة كقيمة لمعاملك إن وجد.
تعيين معامل طلب Dnssecالشرح
تعيين معامل طلب Dnssec
الشرح
domain_nameاسم المجال الذي تحتاج إلى إعداد dnssec له
key_tagعلامة رئيسية
digest_typeيمكنك اختيار رقم من القائمة التالية لتمثيل نوع توقيعك الرقمي:
SHA-1(1)
SHA-256(2)
GOSTR 34.11-94 (3)
SHA-384(4)
digestيرجى إدخال القيمة المقابلة لنوع الهضم الذي قمت باختياره
algorithmيمكنك اختيار رقم من القائمة التالية لتمثيل خوارزمية التوقيع الرقمي الخاصة بك:
RSA/MD5(1)
ديفي-هيلمان(2)
DSA/SHA-1(3)
المنحنى الإهليلجي(4)
RSA/SHA-1(5)
DSA-NSEC3-SHA1(6)
RSASHA1-NSEC3-SHA1(7)
RSA/SHA-256(8)
RSA/SHA-512(10)
GOSTR 34.10-2001(12)
ECDSA منحنى P-256 مع SHA-256(13)
ECDSA منحنى P-384 مع SHA-384(14)
ED25519(15)
ED448(16)
غير مباشر(252)
DNS خاص(253)
OID خاص(254)
flagsيمكنك اختيار رقم من القائمة التالية ليمثل رمز توقيعك الرقمي:
ZSK(256)
KSK(257)
public_keyيجب أن يكون المفتاح العام مشفرًا بترميز base64.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDnssecResponse></SetDnssecResponse>عقدة الجذر للاستجابة
<SetDnssecHeader></SetDnssecHeader>تعيين رأس Dnssec
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
تعيين مثال لنظام أمان نظام أسماء المجالات
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDnssecResponse>
<SetDnssecHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDnssecHeader>
<SetDnssecContent/>
</SetDnssecResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_dnssec&domain_name=domain-haha1.com&flags=257&public_key=123&algorithm=1
Response (JSON format){
"SetDnssecResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
تعيين أمر توجيه البريد الإلكتروني
إذا كنت تقوم بتعيين أمر تحويل البريد الإلكتروني، يجب أن يشتمل على البارامترات التالية:
تعيين معامل طلب توجيه البريد الإلكترونيالشرح
تعيين معامل طلب توجيه البريد الإلكتروني
الشرح
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"
Set Email Forward ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&
[email protected] Response (XML format)
<SetEmailForwardingResponse>
<SetEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetEmailForwardingHeader>
</SetEmailForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_email_forward&domain=testdomain.com&forward_type=forward&username0=testusername&
[email protected] Response (JSON format){
"SetEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر إعدادات المجال الواضحة
إذا كنت تقوم بتنفيذ أمر إعداد مجال مسح البيانات، يجب تضمين البارامترات التالية:
تعيين معلمة طلب إعداد المجال بوضوحالشرح
تعيين معلمة طلب إعداد المجال بوضوح
الشرح
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"
Set Clear Domain Setting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Response (XML format)
<SetClearDomainSettingResponse>
<SetClearDomainSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearDomainSettingHeader>
</SetClearDomainSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_domain_setting&domain=domain1.com&service=nameservers
Response (JSON format){
"SetClearDomainSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر المجلد
إذا تم استدعاء أمر تعيين المجلد، يجب تضمين البارامترات التالية:
تعيين معلمة طلب المجلدالشرح
تعيين معلمة طلب المجلد
الشرح
domainاسم المجال المطلوب تحديثه، يمكن تعيين مجال 1 واحد فقط لكل طلب
folderاسم المجلد الذي ترغب في انتقال مجالك إليه. استخدم "Default" كاسم للمجلد إذا كنت تريد انتقال المجال إلى المجلد الافتراضي. اسم المجلد حساس لحالة الأحرف. على سبيل المثال، "Folder1" و "folder1" هما اسمان مختلفان للمجلدات.
folder_id (اختياري)المجلد المعرّف الذي ترغب في انتقال مجالك إليه
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderResponse></SetFolderResponse>علامة استجابة مجموعة المجلد، وهي العقدة الجذرية لمستند الاستجابة XML
<SetFolderHeader></SetFolderHeader>تعيين عنوان المجلد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Response (XML format)
<SetFolderResponse>
<SetFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHeader>
</SetFolderResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder&domain=domian1.com&folder=folder1
Response (JSON format){
"SetFolderResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر تعيين الملاحظة
إذا كنت تستخدم أمر تعيين ملاحظة، يجب تضمين البارامترات التالية:
تعيين معلمة طلب الملاحظةالشرح
تعيين معلمة طلب الملاحظة
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين مجال 1 فقط لكل طلب
noteملاحظة: تريد إعداد المجال، يمكن أن يكون فارغًا
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetNoteResponse></SetNoteResponse>العقدة الجذرية لمستند الاستجابة XML
<SetNoteHeader></SetNoteHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Note ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_note&domain=domain1.com¬e=Do not modify any information
Response (XML format)
<SetNoteResponse>
<SetNoteHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNoteHeader>
</SetNoteResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_note&domain=domain1.com¬e=Do not modify any information
Response (JSON format){
"SetNoteResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر تعيين معرف العميل (للموزعين فقط)
إذا كنت تستخدم أمر تعيين معرف العميل، يجب تضمين المعايير التالية:
تعيين معامل طلب معرف العميلالشرح
تعيين معامل طلب معرف العميل
الشرح
domain المجال الذي ترغب في تعيينه, يتم فصل المجالات المتعددة بفواصل (الحد الأقصى:100)
customer_idلا يمكن أن يكون معرف العميل الذي تريد تعيينه لل مجال فارغًا
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetCustomerIdResponse></SetCustomerIdResponse>العقدة الجذرية لمستند الاستجابة XML
<SetCustomerIdHeader></SetCustomerIdHeader>رأس الاستجابة
<SetCustomerIdContent></SetCustomerIdContent>محتوى الاستجابة
<SetCustomerIdSuccess></SetCustomerIdSuccess>تعيين محتوى استجابة نجاح معرف العميل
<SetCustomerIdFailed></SetCustomerIdFailed>محتوى رد فشل تعيين معرف العميل
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل، "1" للمشكلة
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال تعيين معرف العميل
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetCustomerIdResponse>
<SetCustomerIdHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetCustomerIdHeader>
<SetCustomerIdContent>
<SetCustomerIdSuccess>
<content>
<Domain>domain1.com</Domain>
<CustomerId>123456</CustomerId>
</content>
<content>
<Domain>domain2.com</Domain>
<CustomerId>123456</CustomerId>
</content>
</SetCustomerIdSuccess>
</SetCustomerIdContent>
</SetCustomerIdResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_customer_id&domain=domain1.com,domain2.com&customer_id=123456
Response (JSON format){
"SetCustomerIdResponse": {
"ResponseCode": 0,
"Status": "success",
"SetCustomerIdSuccess": [
{
"Domain": "domain1.com",
"CustomerId": 123456
},
{
"Domain": "domain2.com",
"CustomerId": 123456
}
]
}
}
خيار التجديد
إذا تم استدعاء أمر تعيين خيار التجديد، فيجب تضمين البارامترات التالية:
خيار تجديد طلب المعلمةالشرح
خيار تجديد طلب المعلمة
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
renew_optionيمكن أن يكون "donot", "auto", "reset"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetRenewOptionResponse></SetRenewOptionResponse>العقدة الجذرية لمستند الاستجابة XML
<SetRenewOptionHeader></SetRenewOptionHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال على خيار التجديد
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetRenewOptionResponse>
<SetRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetRenewOptionHeader>
</SetRenewOptionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_renew_option&domain=domain1.com&renew_option=auto
Response (JSON format){
"SetRenewOptionResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
أمر تعيين الخصوصية
إذا كنت تقوم بتنفيذ أمر تعيين الخصوصية، يجب تضمين العناصر التالية:
تعيين معلمة طلب الخصوصيةالشرح
تعيين معلمة طلب الخصوصية
الشرح
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"
Set Privacy ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Response (XML format)
<SetPrivacyResponse>
<SetPrivacyHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetPrivacyHeader>
</SetPrivacyResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_privacy&domain=domain1.com&whois_privacy_option=yes&option=off
Response (JSON format){
"SetPrivacyResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أسعار مجالات TLD
هذه الميزة متاحة فقط بتنسيق XML و JSON:
طلب معلمات أسعار مجالات المستوى الأعلىالشرح
طلب معلمات أسعار مجالات المستوى الأعلى
الشرح
currency (اختياري)عملة نتيجة الإرجاع، يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي العملة الافتراضية لإعدادات حساب Api.
count_per_page (optional)كم عدد الكيانات المعروضة في كل صفحة؟
page_index (optional)أي كيانات الصفحة تريد عرضها?
sort (optional)يرجى اختيار إحدى الخيارات التالية كقيمة لمعامل الترتيب:
* إذا لم تقم باختياره، سنستخدم الترتيب الافتراضي.
1) RankAsc (الافتراضي)
2) RankDesc
3) NameAsc
4) NameDesc
5) SalesAsc
6) SalesDesc
7) LaunchDateAsc
8) LaunchDateDesc
9) CountAsc
10) CountDesc
11) RegistryAsc
12) RegistryDesc
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<TldPriceResponse></TldPriceResponse>العقدة الجذرية لمستند الاستجابة XML
<TldPriceResponseHeader></TldPriceResponseHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<TldPriceContent></TldPriceContent>محتوى الاستجابة
<TldContent></TldContent>معلومات مجال المستوى الأعلى
<Tld></Tld> المجالات العليا
<Usage></Usage>استخدام مجال المستوى الأعلى
<Price></Price>معلومات السعر لهذا المجال العلوي المستوى. يحتوي على علامات فرعية:
: وحدة السعر
: سعر التسجيل
: سعر التجديد
: سعر ال انتقال
<Privacy></Privacy>إذا كان هذا المجال العلوي يدعم خصوصية الويز
<GracePeriod></GracePeriod>معلومات فترة السماح لهذا المجال العلوي. يحتوي على العلامات الفرعية:
: وحدة معلومات فترة السماح
: فترة سماح التجديد
: فترة سماح الحذف
<IDN></IDN>إذا كان مجال tld يدعم أسماء المجالات الدولية
<Restrictions></Restrictions>اسم المجال
TLD Prices ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=tld_price¤cy=USD
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<TldPriceResponse>
<TldPriceResponseHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<PriceLevel>Regular Pricing</PriceLevel>
<Currency>USD</Currency>
</TldPriceResponseHeader>
<TldPriceContent>
<TldContent>
<Tld>com</Tld>
<Usage>General</Usage>
<Price>
<Unit>(Price/1 year)</Unit>
<Register>15.00</Register>
<Renew>15.00</Renew>
<Transfer>15.00</Transfer>
<Restore>10.00</Restore>
</Price>
<Privacy>10.00</Privacy>
<GracePeriod>
<Unit>10.00</Unit>
<Renew>10.00</Renew>
<Delete>30</Delete>
<Restore>YES</Restore>
</GracePeriod>
<IDN>YES</IDN>
<Restrictions>--</Restrictions>
</TldContent>
</TldPriceContent>
</TldPriceResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=tld_price¤cy=USD
Response (JSON format){
"TldPriceResponse": {
"ResponseCode": 0,
"Status": "success",
"PriceLevel": "Regular Pricing",
"Currency": "USD",
"TldPrice": [
{
"Tld": "com",
"Usage": "General",
"IDN": "YES",
"Restrictions": "--",
"Privacy": "10.00",
"Price": {
"Unit": "(Price/1 year)",
"Register": "15.00",
"Renew": "15.00",
"Transfer": "15.00",
"Restore": "10.00"
},
"GracePeriod": {
"Unit": "10.00",
"Renew": "10.00",
"Delete": "30",
"Restore": "YES"
}
}
]
}
}
قائمة أوامر المجال
هذه الميزة متاحة فقط بتنسيق XML و JSON:
قائمة معاملات طلب المجالالشرح
قائمة معاملات طلب المجال
الشرح
customer_id (اختياري)تصفية البيانات حسب معرف العميل (يمكن لموزعين فقط استخدام هذه البارامتر)
count_per_page (optional)كم عدد الكيانات المعروضة في كل صفحة؟
page_index (optional)أي كيانات الصفحة تريد عرضها?
sort (optional)يرجى اختيار إحدى الخيارات التالية كقيمة لمعامل الترتيب:
* إذا لم تقم باختياره، سنستخدم الترتيب الافتراضي.
1) CountAsc (الافتراضي)
2) CountDesc
3) NameAsc
4) NameDesc
نتيجة علامة 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 (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Registration></Registration>تاريخ تسجيل المجال بتوقيت يونيكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1، 1970)
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع إعداد خادم الأسماء
<WithAds></WithAds>مع الإعلانات أم لا
<Whois></Whois>معلومات الاستعلام عن المالك
<Registrant></Registrant>معلومات المسجل
<ContactId></ContactId>معرف الاتصال
<Admin></Admin>معلومات الإدارة
<Technical></Technical>معلومات تقنية
<Billing></Billing>معلومات الفوترة
<Locked></Locked>مقفل أم لا
<Disabled></Disabled>تمكين الحالة
<Hold></Hold>يمسك
<Privacy></Privacy>حالة الخصوصية
<isForSale></isForSale>حالة البيع
<RenewOption></RenewOption>خيار التجديد
<Note></Note>ملاحظة
<Folder></Folder>معلومات المجلد
<FolderId></FolderId>معرف المجلد
<FolderName></FolderName>اسم المجلد
قائمة أمثلة المجالات
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=list_domain
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ListDomainInfoResponse>
<ListDomainInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ListDomainInfoHeader>
<ListDomainInfoContent>
<DomainInfoList>
<DomainInfo>
<Domain>
<Name>domain-exp140.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>0</ContactId>
</Registrant>
<Admin>
<ContactId>0</ContactId>
</Admin>
<Technical>
<ContactId>0</ContactId>
</Technical>
<Billing>
<ContactId>0</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>no</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
</Domain>
<Domain>
<Name>domain-exp141.com</Name>
<Expiration>1361430589062</Expiration>
<Registration>1234567890123</Registration>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
<Whois>
<Registrant>
<ContactId>1</ContactId>
</Registrant>
<Admin>
<ContactId>2</ContactId>
</Admin>
<Technical>
<ContactId>3</ContactId>
</Technical>
<Billing>
<ContactId>4</ContactId>
</Billing>
</Whois>
<Locked>yes</Locked>
<Disabled>no</Disabled>
<UdrpLocked>no</UdrpLocked>
<RegistrantUnverified>no</RegistrantUnverified>
<Hold>no</Hold>
<Privacy>none</Privacy>
<isForSale>no</isForSale>
<RenewOption>no renew option</RenewOption>
<Note/>
<Folder>
<FolderId>-1</FolderId>
<FolderName>(no folder)</FolderName>
</Folder>
</Domain>
</DomainInfo>
</DomainInfoList>
</ListDomainInfoContent>
</ListDomainInfoResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=list_domain
Response (JSON format){
"ListDomainInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"MainDomains": [
{
"Name": "domain-exp140.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "0"
},
"Admin": {
"ContactId": "0"
},
"Technical": {
"ContactId": "0"
},
"Billing": {
"ContactId": "0"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "no",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
}
},
{
"Name": "domain-exp141.com",
"Expiration": "1361430589062",
"Registration": "1234567890123",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
},
"Whois": {
"Registrant": {
"ContactId": "1"
},
"Admin": {
"ContactId": "2"
},
"Technical": {
"ContactId": "3"
},
"Billing": {
"ContactId": "4"
}
},
"Locked": "yes",
"Disabled": "no",
"UdrpLocked": "no",
"RegistrantUnverified": "no",
"Hold": "no",
"Privacy": "none",
"isForSale": "no",
"RenewOption": "no renew option",
"Note": "",
"Folder": {
"FolderId": "-1",
"FolderName": "(no folder)"
}
}
]
}
}
أمر قفل المجال
إذا تم استدعاء أمر قفل المجال، فيجب تضمين البارامترات التالية:
طلب قفل معلمات المجالالشرح
طلب قفل معلمات المجال
الشرح
domainاسم المجال الذي ترغب في قفله، يمكن إدخال مجال 1 واحد فقط لكل طلب
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<LockDomainResponse></LockDomainResponse>جذر العقدة لمستند XML الاستجابة
<LockDomainHeader></LockDomainHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Lock Domain ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=lock_domain&domain=domain4.com
Response (XML format)
<LockDomainResponse>
<LockDomainHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</LockDomainHeader>
</LockDomainResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=lock_domain&domain=domain4.com
Response (JSON format){
"LockDomainResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
إلغاء أمر ال انتقال
الأمر يتيح لك إلغاء عنصر انتقال في الطلب. عند استدعاء أمر إلغاء ال انتقال، يجب تضمين البارامترات التالية:
إلغاء معاملة طلب ال انتقالالشرح
إلغاء معاملة طلب ال انتقال
الشرح
domainاسم المجال الذي ترغب في إلغاء تحويله، يمكن إدخال مجال 1 واحد فقط لكل طلب
order_idيمكنك الحصول على معرف أمر ال انتقال من خلال واجهة برمجة التطبيقات الأخرى لاستعلام حالة ال انتقال.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<CancelTransferResponse></CancelTransferResponse>جذر العقدة لمستند XML الاستجابة
<CancelTransferHeader></CancelTransferHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال على إلغاء التحويل
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=cancel_transfer&domain=domain4.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<CancelTransferResponse>
<CancelTransferHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CancelTransferHeader>
</CancelTransferResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=cancel_transfer&domain=domain4.com
Response (JSON format){
"CancelTransferResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
أمر الحصول على حالة ال انتقال
إذا كنت تستدعي أمر الحصول على حالة ال انتقال، يجب تضمين البارامترات التالية:
طلب معلمة حالة ال انتقالالشرح
طلب معلمة حالة ال انتقال
الشرح
domainاسم المجال الذي تريد الحصول على حالة انتقاله، يمكن إدخال مجال 1 واحد فقط لكل طلب
transfer_typeنوع التحويل الذي ترغب في الحصول على حالة التحويل له ( انتقال داخلي أو انتقال خارجي)
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetTransferStatusResponse></GetTransferStatusResponse>جذر العقدة لمستند XML الاستجابة
<GetTransferStatusHeader></GetTransferStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetTransferStatusContent></GetTransferStatusContent>محتوى الاستجابة
<TransferList></TransferList>قائمة ال انتقال
<Transfer></Transfer>معلومات ال انتقال
<OrderId></OrderId>رقم الطلب
<TransferStatus></TransferStatus>حالة انتقال المجال. إذا حصلت على "none" أو "approved"، يمكنك إلغاء ال انتقال. إذا حصلت على "waiting"، يعني أن ال انتقال قد بدأ بالفعل. إذا حصلت على "auth code needed"، يعني أن رمز المصادقة غير صحيح، يمكنك استخدام واجهة برمجة تطبيقات أخرى SET_TRANSFER_AUTH لإعادة تقديم رمز المصادقة. هناك أيضا بعض الحالات الأخرى، سنرسل لك بريدًا إلكترونيًا أو قد يحتاج الأمر للتحقق من قبل مهندسينا.
Get Transfer Status ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferStatusResponse>
<GetTransferStatusHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetTransferStatusHeader>
<GetTransferStatusContent>
<TransferList>
<Transfer>
<OrderId>testorderid</OrderId>
<TransferStatus>teststatus</TransferStatus>
</Transfer>
<Transfer>
<OrderId>testorderid2</OrderId>
<TransferStatus>teststatus2</TransferStatus>
</Transfer>
</TransferList>
</GetTransferStatusContent>
</GetTransferStatusResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_status&domain=domian1.com&transfer_type=in
Response (JSON format){
"GetTransferStatusResponse": {
"ResponseCode": 0,
"Status": "success",
"TransferList": [
{
"OrderId": "testorderid",
"TransferStatus": "teststatus"
},
{
"OrderId": "testorderid2",
"TransferStatus": "teststatus2"
}
]
}
}
تعيين رمز المصادقة لأمر انتقال المجال
الأمر الذي يتيح لك تحديث رمز التفويض لمعالجة أوامر ال انتقال. عند استدعاء أمر تعيين رمز تفويض ال انتقال، يجب تضمين البارامترات التالية:
طلب تعيين رمز تفويض ال انتقالالشرح
طلب تعيين رمز تفويض ال انتقال
الشرح
domainالاسم المُحدَّث ل انتقال الصلاحية ل مجال، يمكن إدخال مجال 1 واحد فقط لكل طلب
auth_codeالرمز التفويضي الذي ترغب في إعادة تقديمه
order_idيمكنك الحصول على معرف أمر ال انتقال من خلال واجهة برمجة التطبيقات الأخرى لاستعلام حالة ال انتقال.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetTransferStatusResponse></GetTransferStatusResponse>جذر العقدة لمستند XML الاستجابة
<GetTransferStatusHeader></GetTransferStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Transfer Auth Code ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Response (XML format)
<SetTransferAuthCodeResponse>
<SetTransferAuthCodeHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetTransferAuthCodeHeader>
</SetTransferAuthCodeResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_transfer_auth_code&domain=domain4.com&auth_code=testauthcode
Response (JSON format){
"SetTransferAuthCodeResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر تفويض انتقال المجال
طلب تفويض انتقال بعيدًاالشرح
طلب تفويض انتقال بعيدًا
الشرح
domain المجال الذي ترغب في تفويض انتقاله، يمكن إدخال مجال 1 واحد فقط لكل طلب
order_idرقم الطلب في Dynadot لل مجال الذي ترغب في انتقاله بعيدًا
authorizeلتفويض عملية ال انتقال، اضبطه على "approve". لرفض عملية ال انتقال، اضبطه على "deny".
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<AuthorizeTransferAwayResponse></AuthorizeTransferAwayResponse>جذر العقدة لمستند XML الاستجابة
<AuthorizeTransferAwayHeader></AuthorizeTransferAwayHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<Result></Result>نتيجة التفويض بال انتقال بعيدًا
مثال على تفويض انتقال المجال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AuthorizeTransferAwayResponse>
<AuthorizeTransferAwayHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<Result>away_approved</Result>
</AuthorizeTransferAwayHeader>
</AuthorizeTransferAwayResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=authorize_transfer_away&domain=domain.com&authorize=approve&order_id=123
Response (JSON format){
"AuthorizeTransferAwayResponse": {
"ResponseCode": 0,
"Status": "success",
"Result": "away_approved"
}
}
أمر الحصول على كود تفويض ال انتقال
يجب عليك فتح قفل مجالك وحسابك قبل طلب رمز التفويض.
طلب كود تفويض انتقال المجالالشرح
طلب كود تفويض انتقال المجال
الشرح
domainاسم المجال الذي تريد الحصول على رمز التفويض ل انتقاله، يمكن إدخال مجال 1 واحد فقط لكل طلب
new_code (optional)إنشاء رمز تفويض انتقال جديد
unlock_domain_for_transfer (Optional. Requires api skip lock agreement to use)إذا أردت فتح قفل المجال لل انتقال، اضبطه على "1". إذا تمت معالجة الطلب بنجاح، سيتم فتح قفل المجال.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetTransferAuthCodeResponse></GetTransferAuthCodeResponse>جذر العقدة لمستند XML الاستجابة
<GetTransferAuthCodeHeader></GetTransferAuthCodeHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<AuthCode></AuthCode>رمز التفويض يُستخدم لبدء عملية انتقال المجال.
مثال على الحصول على رمز تفويض ال انتقال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetTransferAuthCodeResponse>
<GetTransferAuthCodeHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<AuthCode>testauthcode</AuthCode>
</GetTransferAuthCodeHeader>
</GetTransferAuthCodeResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_transfer_auth_code&domain=domian1.com&new_code=1&unlock_domain_for_transfer=1
Response (JSON format){
"GetTransferAuthCodeResponse": {
"ResponseCode": 0,
"Status": "success",
"AuthCode": "testauthcode"
}
}
احصل على أمر طلب دفع المجال
استدعاء أمر طلب دفع المجال سيحصل على طلب دفع المجال. هذا الأمر متوفر فقط بتنسيق XML و JSON.
احصل على طلب دفع المجالالشرح
احصل على طلب دفع المجال
الشرح
N/Aلا توجد معلمات إضافية مطلوبة
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetDomainPushRequestResponse></GetDomainPushRequestResponse>عقدة الجذر للاستجابة
<GetDomainPushRequestHeader></GetDomainPushRequestHeader>احصل على ترويسة طلب دفع المجال
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
<GetDomainPushRequestContent></GetDomainPushRequestContent>محتوى الرد
<PushDomain></PushDomain>دفع المجال
<PushDomainName></PushDomainName>دفع اسم المجال
Get Domain Push Request ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_domain_push_request
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetDomainPushRequestResponse>
<GetDomainPushRequestHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetDomainPushRequestHeader>
<GetDomainPushRequestContent>
<PushDomain>
<PushDomainName>haha.com</PushDomainName>
</PushDomain>
<PushDomain>
<PushDomainName>haha1.com</PushDomainName>
</PushDomain>
</GetDomainPushRequestContent>
</GetDomainPushRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_domain_push_request
Response (JSON format){
"GetDomainPushRequestResponse": {
"ResponseCode": 0,
"Status": "success",
"pushDomainName": "[haha.com,haha1.com]"
}
}
تعيين أمر طلب دفع المجال
استدعاء أمر طلب دفع المجال سيقوم بتعيين طلب دفع المجال. هذا الأمر متوفر فقط بتنسيق XML وJSON. إذا تم استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
تعيين معامل طلب دفع المجالالشرح
تعيين معامل طلب دفع المجال
الشرح
domainsاسم المجال الخاص بالطلب المراد معالجته
actionيمكنك اختيار "accept" أو "decline" لمعالجة أمر العمل.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDomainPushRequestResponse></SetDomainPushRequestResponse>عقدة الجذر للاستجابة
<SetDomainPushRequestHeader></SetDomainPushRequestHeader>تعيين عنوان طلب دفع المجال
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Set Domain Push Request ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDomainPushRequestResponse>
<SetDomainPushRequestHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetDomainPushRequestHeader>
<SetDomainPushRequestContent/>
</SetDomainPushRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_domain_push_request&domains=domain-haha1.com,domain-haha2.com,domain-haha3.com&action=accept
Response (JSON format){
"SetDomainPushRequestResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
إنشاء أمر تدقيق CN
الأمر يتيح لك إنشاء تدقيق CN لجهة اتصال. إذا كنت تقوم بإصدار أمر إنشاء تدقيق cn، يجب تضمين البارامترات التالية:
إنشاء معامل طلب تدقيق CNالشرح
إنشاء معامل طلب تدقيق CN
الشرح
contact_idالمعرف الخاص بسجل جهة الاتصال الذي ترغب في بدء التدقيق له، يمكن إدخال معرف جهة اتصال 1 فقط لكل طلب
contact_typeنوع الاتصال، يمكن أن يكون إما فرد أو مؤسسة
individual_id_typeنوع هوية الشخص الطبيعي، القيم المتوقعة (وصف القيمة) هي:
JGZ (Officer's identity card of the People's Republic of China)
SFZ (ID card of the People's Republic of China)
HZ (Passport)
GAJMTX (Exit-Entry Permit for Travelling to and from Hong Kong and Macao)
TWJMTX (Travel passes for Taiwan Residents to Enter or Leave the Mainland)
WJLSFZ (Foreign Permanent Resident ID Card of the People's Republic of China)
GAJZZ (Residence permit for Hong Kong, Macao)
TWJZZ (Residence permit for Taiwan residents)
QT (Others)
individual_license_idرقم الترخيص الخاص ببطاقة التعريف الشخصية للفرد
individual_urlوثيقة هوية ترخيص الشخص الطبيعي. عنوان الملف على الخادم. يُسمح فقط بصيغ jpg، gif، png، jpeg.
enterprise_id_type (Mandatory when contact type is "Enterprise")نوع معرف المؤسسة، القيم المتوقعة (وصف القيمة) هي:
ORG (Organization Code Certificate)
YYZZ (Business License)
TYDM (Certificate for Uniform Social Credit Code)
BDDM (Military Code Designation)
JDDWFW (Military Paid External Service License)
SYDWFR (Public Institution Legal Person Certificate)
WGCZJG (Resident Representative Offices of Foreign Enterprises Registration Form)
SHTTFR (Social Organization Legal Person Registration Certificate)
ZJCS (Religion Activity Site Registration Certificate)
MBFQY (Private Non-Enterprise Entity Registration Certificate)
JJHFR (Fund Legal Person Registration Certificate)
LSZY (Practicing License of Law Firm)
WGZHWH (Registration Certificate of Foreign Cultural Center in China)
WLCZJG (Resident Representative Office of Tourism Departments of Foreign Government Approval Registration Certificate)
SFJD (Judicial Expertise License)
JWJG (Overseas Organization Certificate)
SHFWJG (Social Service Agency Registration Certificate)
MBXXBX (Private School Permit)
YLJGZY (Medical Institution Practicing License)
GZJGZY (Notary Organization Practicing License)
BJWSXX (Beijing School for Children of Foreign Embassy Staff in China Permit)
QTTYDM (Others-Certificate for Uniform Social Credit Code)
QT (Others)
enterprise_license_id (Mandatory when contact type is "Enterprise")رقم ترخيص وثيقة المؤسسة
enterprise_url (Mandatory when contact type is "Enterprise")وثيقة ترخيص المؤسسة. رابط الملف على الخادم. يُسمح فقط بصيغ jpg، gif، png، jpeg.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<CreateCnAuditResponse></CreateCnAuditResponse>العقدة الجذرية لمستند الاستجابة XML
<CreateCnAuditHeader></CreateCnAuditHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
إنشاء مثال تدقيq لل Cn
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<CreateCnAuditResponse>
<CreateCnAuditHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CreateCnAuditHeader>
</CreateCnAuditResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=create_cn_audit&contact_id=testcontactid&contact_type=Enterprise&individual_id_type=SFZ&individual_license_id=testlicenseid&individual_url=url1&enterprise_id_type=ORG&enterprise_license_id=testlicenseid2&enterprise_url=url2
Response (JSON format){
"CreateCnAuditResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
الحصول على أمر حالة تدقيق شركة الاتصالات
إذا تم استدعاء أمر فحص حالة الشهادة، فيجب تضمين البارامترات التالية:
الحصول على معلمة طلب حالة تدقيق المجال الصينيالشرح
الحصول على معلمة طلب حالة تدقيق المجال الصيني
الشرح
contact_idالمُعرّف الخاص بسجل الاتصال الذي ترغب في الحصول على حالة التدقيق له، يمكن إدخال مُعرّف واحد فقط لكل طلب
gtldإذا قمت بالاستعلام عن نتيجة التدقيق الخاصة بـ cnnic-gtld، قم بتعيين هذه القيمة على 1
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetCnAuditStatusResponse></GetCnAuditStatusResponse>جذر العقدة لمستند XML الاستجابة
<GetCnAuditStatusHeader></GetCnAuditStatusHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<CnAuditStatus></CnAuditStatus>حالة التدقيق لسجل تدقيق cnnic. قد تحصل على "قيد المعالجة" أو "في انتظار cnnic" أو "فشل". في حالة الفشل، سنرسل لك بريدًا إلكترونيًا.
<FailedReason></FailedReason>إذا لم تجتز المراجعة، سيتم عرض سبب الفشل.
احصل على مثال حالة التدقيق لـ Cn
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetCnAuditStatusResponse>
<GetCnAuditStatusHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
<CnAuditStatus>pass</CnAuditStatus>
</GetCnAuditStatusHeader>
</GetCnAuditStatusResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_cn_audit_status&contact_id=testcontactid
Response (JSON format){
"GetCnAuditStatusResponse": {
"ResponseCode": "0",
"Status": "success",
"CnAuditStatus": "pass"
}
}
إنشاء أمر جهة الاتصال
إذا تم استدعاء أمر إنشاء جهة اتصال، يجب تضمين المعايير التالية:
إنشاء معلمة طلب الاتصالالشرح
إنشاء معلمة طلب الاتصال
الشرح
organization (اختياري)معلومات المنظمة
nameالاسم
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز البلد الخاص بالهاتف
faxnum (اختياري)رقم الفاكس
faxcc (اختياري)رمز الدولة للفاكس
address1العنوان 1
address2 (اختياري)العنوان 2
cityمدينة
state (اختياري)ولاية
zipالرمز البريدي
countryبلد
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<CreateContactResponse></CreateContactResponse>العقدة الجذرية لمستند الاستجابة XML
<CreateContactHeader></CreateContactHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<CreateContactContent></CreateContactContent>معرّف جهة الاتصال الجديد، يُستخدم فقط عندما يكون الحالة "success"
Create Contact ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=create_contact&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Response (XML format)
<CreateContactResponse>
<CreateContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</CreateContactHeader>
<CreateContactContent>
<ContactId>1234</ContactId>
</CreateContactContent>
</CreateContactResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=create_contact&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=America&zip=94401&country=US
Response (JSON format){
"CreateContactResponse":{
"ResponseCode":"0",
"Status":"success",
"CreateContactContent":{
"ContactId":"0"
}
}
}
تعديل أمر الاتصال
إذا تم استدعاء أمر تعديل جهة الاتصال، يجب تضمين البارامترات التالية:
تحرير معلمة طلب الاتصالالشرح
تحرير معلمة طلب الاتصال
الشرح
contact_idالمعرف الخاص بجهة الاتصال التي ترغب في تعديلها
organization (اختياري)معلومات المنظمة
nameالاسم
emailالبريد الإلكتروني
phonenumرقم الهاتف
phoneccرمز البلد الخاص بالهاتف
faxnum (اختياري)رقم الفاكس
faxcc (اختياري)رمز الدولة للفاكس
address1العنوان 1
address2 (اختياري)العنوان 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>معرف الاتصال
تعديل مثال جهة الاتصال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<EditContactResponse>
<EditContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</EditContactHeader>
<EditContactContent>
<ContactId>0</ContactId>
</EditContactContent>
</EditContactResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Response (JSON format){
"EditContactResponse": {
"ResponseCode": "0",
"Status": "success",
"EditContactContent": {
"ContactId": "0"
}
}
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=edit_contact&contact_id=0&name=Webb&
[email protected]&phonenum=8662623399&phonecc=1&address1=PO Box 345&city=San Mateo&state=U.S&zip=94401&country=US
Response (تنسيق CSV)ok,
success,
,
أمر حذف جهة الاتصال
إذا كنت تقوم بإصدار أمر حذف جهة اتصال، فيجب تضمين البارامترات التالية:
طلب حذف بيانات الاتصالالشرح
طلب حذف بيانات الاتصال
الشرح
contact_idمعرف الاتصال الذي تريد حذفه، تأكد من فصلها بفواصل.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<DeleteContactResponse></DeleteContactResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteContactHeader></DeleteContactHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال حذف جهة اتصال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_contact&contact_id=0
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteContactResponse>
<DeleteContactHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteContactHeader>
</DeleteContactResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_contact&contact_id=0
Response (JSON format){
"DeleteContactResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
قائمة الاتصالات
هذا الأمر متاح فقط بصيغة 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
Contact List ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=contact_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ContactListResponse>
<ContactListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ContactListHeader>
<ContactListContent>
<ContactList>
<Contact>
<ContactId>0</ContactId>
<Organization/>
<Name>Jack tester</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>test street</Address1>
<Address2/>
<City>Los Angeles</City>
<State>CA</State>
<ZipCode>90068</ZipCode>
<Country>US</Country>
<GtldVerified>no</GtldVerified>
</Contact>
<Contact>
<ContactId>1</ContactId>
<Organization/>
<Name>John tester</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>123.456.7890</PhoneNum>
<FaxCc>1</FaxCc>
<FaxNum>123.456.7890</FaxNum>
<Address1>high Way first</Address1>
<Address2/>
<City>San Francisco</City>
<State>CA</State>
<ZipCode>90068</ZipCode>
<Country>US</Country>
<GtldVerified>yes</GtldVerified>
</Contact>
</ContactList>
</ContactListContent>
</ContactListResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=contact_list
Response (JSON format){
"ContactListResponse": {
"ResponseCode": 0,
"Status": "success",
"ContactList": [
{
"ContactId": "0",
"Organization": "",
"Name": "Jack tester",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "test street",
"Address2": "",
"City": "Los Angeles",
"State": "CA",
"ZipCode": "90068",
"Country": "US",
"GtldVerified": "no"
},
{
"ContactId": "1",
"Organization": "",
"Name": "John tester",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "123.456.7890",
"FaxCc": "1",
"FaxNum": "123.456.7890",
"Address1": "high Way first",
"Address2": "",
"City": "San Francisco",
"State": "CA",
"ZipCode": "90068",
"Country": "US",
"GtldVerified": "yes"
}
]
}
}
أمر الحصول على جهة الاتصال
هذا الأمر متاح فقط بصيغة 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
Get Contact ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_contact&contact_id=10000
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetContactResponse>
<GetContactHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetContactHeader>
<GetContactContent>
<GetContact>
<Contact>
<ContactId>12345</ContactId>
<Organization>org</Organization>
<Name>name</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>address1</Address1>
<Address2>address2</Address2>
<City>city</City>
<State>state</State>
<ZipCode>zipcode</ZipCode>
<Country>country</Country>
<GtldVerified>no</GtldVerified>
</Contact>
</GetContact>
</GetContactContent>
</GetContactResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_contact&contact_id=10000
Response (JSON format){
"GetContactResponse": {
"ResponseCode": 0,
"Status": "success",
"GetContact": {
"ContactId": "12345",
"Organization": "org",
"Name": "name",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "address1",
"Address2": "address2",
"City": "city",
"State": "state",
"ZipCode": "zipcode",
"Country": "country",
"GtldVerified": "no"
}
}
}
تعيين أمر إعدادات الاتصال الأوروبية
إذا كانت الأوامر المطلوبة هي ضبط إعدادات الاتصال الأوروبية، فيجب تضمين البارامترات التالية:
تعيين طلب معامل إعداد الاتصال الأوروبيالشرح
تعيين طلب معامل إعداد الاتصال الأوروبي
الشرح
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>معرف الاتصال
Set Contact EU Setting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactEUSettingResponse>
<SetContactEUSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactEUSettingHeader>
<SetContactEUSettingContent>
<ContactId>0</ContactId>
</SetContactEUSettingContent>
</SetContactEUSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_eu_setting&contact_id=0&country_of_citizenship=AT
Response (JSON format){
"SetContactEUSettingResponse": {
"ResponseCode: ": "0",
"Status": "Success",
"SetContactEUSettingContent": {
"ContactId: ": "0"
}
}
}
تعيين أمر إعدادات الاتصال LV
إذا كنت تستدعي أمر إعداد مستوى جهة الاتصال، فيجب تضمين البارامترات التالية:
تعيين طلب معاملة إعداد جهة الاتصالالشرح
تعيين طلب معاملة إعداد جهة الاتصال
الشرح
contact_idالمعرف الخاص بجهة الاتصال التي ترغب في تعديلها
registration_number- بالنسبة للأفراد، يرجى إدخال رقم الهوية اللاتفية.
- بالنسبة للشركات والكيانات القانونية الأخرى، يرجى إدخال رقم التسجيل الصادر عن سجل الشركات اللاتفي.
vat_number (اختياري)رقم ضريبة القيمة المضافة للكيانات القانونية الأجنبية المسجلة داخل دول الاتحاد الأوروبي (وهذا يشمل أيضًا الشركات اللاتفية)
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetContactLvSettingResponse></SetContactLvSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetContactLvSettingHeader></SetContactLvSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<SetContactLvSettingContent></SetContactLvSettingContent>محتوى الاستجابة
<ContactId></ContactId>معرف الاتصال
تعيين مثال إعداد مستوى الاتصال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetContactLvSettingResponse>
<SetContactLvSettingHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetContactLvSettingHeader>
<SetContactLvSettingContent>
<ContactId>0</ContactId>
</SetContactLvSettingContent>
</SetContactLvSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_contact_lv_setting&contact_id=0®istration_number=test_reg_number&vat_number=test_vat_number
Response (JSON format){
"SetContactLvSettingResponse": {
"ResponseCode": 0,
"Status": "success",
"SetContactLvSettingContent": {
"ContactId: ": "0"
}
}
}
Set Contact LV Setting ExampleRequest (تنسيق 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
Response (تنسيق CSV)ok,success,0
الحصول على أمر خادم الأسماء
إذا كنت تقوم باستدعاء أمر الحصول على اسم الخادم، فيجب تضمين المعلمات التالية:
الحصول على معلمات طلب خادم الأسماءالشرح
الحصول على معلمات طلب خادم الأسماء
الشرح
domain المجال الذي تريد الحصول على معلومات خادم الأسماء الخاصة به، يمكن سحب معلومات خادم الأسماء ل مجال 1 فقط في كل طلب.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetNsResponse></GetNsResponse>العقدة الجذرية لمستند الاستجابة XML
<GetNsHeader></GetNsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<NsContent></NsContent>محتوى الاستجابة
<Host></Host>اسم المضيف للخادم
<NsName></NsName>اسم الخادم
الحصول على مثال Ns
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_ns&domain=mydomain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetNsResponse>
<GetNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetNsHeader>
<NsContent>
<Host>ns1.mydomain.com</Host>
<Host>ns2.mydomain.com</Host>
</NsContent>
</GetNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_ns&domain=mydomain.com
Response (JSON format){
"GetNsResponse": {
"ResponseCode": 0,
"Status": "success",
"NsContent": {
"Host0": "ns1.mydomain.com",
"Host1": "ns2.mydomain.com"
}
}
}
أمر إضافة خادم الأسماء
إذا تم استدعاء أمر إضافة اسم الخادم، يجب تضمين البارامترات التالية:
إضافة معلمة طلب خادم الاسمالشرح
إضافة معلمة طلب خادم الاسم
الشرح
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
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=add_ns&host=ns1.mydomain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AddNsResponse>
<AddNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</AddNsHeader>
<AddNsContent>
<Server>
<Host>ns1.mydomain.com</Host>
<ServerId>0</ServerId>
</Server>
</AddNsContent>
</AddNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=add_ns&host=ns1.mydomain.com
Response (JSON format){
"AddNsResponse": {
"ResponseCode": 0,
"Status": "success",
"AddNsContent": {
"Server": {
"Host": "ns1.mydomain.com",
"ServerId": 0
}
}
}
}
أمر تسجيل خادم الأسماء
إذا كنت تستدعي أمر تسجيل اسم الخادم، فيجب تضمين البارامترات التالية:
طلب تسجيل معاملات خادم الأسماءالشرح
طلب تسجيل معاملات خادم الأسماء
الشرح
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>معرف الخادم
Register Name Server ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Response (XML format)
<RegisterNsResponse>
<RegisterNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</RegisterNsHeader>
<RegisterNsContent>
<Server>
<Host>domain1.com</Host>
<ServerId>0</ServerId>
</Server>
</RegisterNsContent>
</RegisterNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=register_ns&host=domain1.com&ip=192.168.1.1
Response (JSON format){
"RegisterNsResponse":{
"ResponseCode":"0",
"Status":"success",
"RegisterNsContent":{
"Server":{
"Host":"ndomain1.com",
"ServerId":"0"
}
}
}
}
أمر تعيين عنوان IP لخادم الأسماء
إذا كنت تستخدم أمر تعيين عنوان IP لخادم الأسماء، يجب تضمين المعاملات التالية:
تعيين معلمة طلب عنوان IP لخادم الأسماءالشرح
تعيين معلمة طلب عنوان IP لخادم الأسماء
الشرح
server_idمعرف خادم الأسماء الذي تريد تعيينه
ip0 - ip9عنوان الآي بي الذي ترغب في تعيينه لخادم الأسماء، يمكن تعيين 9 عناوين آي بي لكل طلب ويجب فصلها بفواصل.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetNsIpResponse></SetNsIpResponse>العقدة الجذرية لمستند الاستجابة XML
<SetNsIpHeader></SetNsIpHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Name Server IP ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Response (XML format)
<SetNsIpResponse>
<SetNsIpHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetNsIpHeader>
</SetNsIpResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_ns_ip&server_id=1&ip0=192.168.1.1
Response (JSON format){
"SetNsIpResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر حذف خادم الأسماء
إذا كان الأمر المستخدم هو حذف اسم الخادم، فينبغي تضمين المعلمات التالية:
طلب حذف بيانات خادم الأسماءالشرح
طلب حذف بيانات خادم الأسماء
الشرح
server_idمعرفات خوادم الأسماء التي ترغب في حذفها، تأكد من فصلها بفواصل
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteNsHeader></DeleteNsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال حذف الأسماء
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns&server_id=0
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteNsResponse>
<DeleteNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteNsHeader>
</DeleteNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns&server_id=0
Response (JSON format){
"DeleteNsResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
حذف خادم الأسماء بواسطة أمر المجال
إذا كنت تقوم بحذف اسم الخادم عبر أمر المجال، فينبغي تضمين البارامترات التالية:
حذف خادم الأسماء بناءً على طلب المجالالشرح
حذف خادم الأسماء بناءً على طلب المجال
الشرح
server_domainاسم خادم الأسماء. مثال: ns1.testnameserver.com
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<DeleteNsResponse></DeleteNsResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteNsHeader></DeleteNsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Delete Name Server By Domain ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Response (XML format)
<DeleteNsResponse>
<DeleteNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteNsHeader>
</DeleteNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_ns_by_domain&server_domain=ns1.testnameserver.com
Response (JSON format){
"DeleteNsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
قائمة أوامر الخادم
هذا الأمر متاح فقط بصيغة 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>عنوان آي بي للخادم
Server List ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=server_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ServerListResponse>
<ServerListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</ServerListHeader>
<ServerListContent>
<NameServerList>
<List>
<Server>
<ServerId>0</ServerId>
<ServerName>ns1.com</ServerName>
</Server>
<Server>
<ServerId>1</ServerId>
<ServerName>domain1.com</ServerName>
<ServerIp>192.168.1.1</ServerIp>
<ServerIp>1.1.1.1</ServerIp>
</Server>
</List>
</NameServerList>
</ServerListContent>
</ServerListResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=server_list
Response (JSON format){
"ServerListResponse": {
"ResponseCode": 0,
"Status": "success",
"ServerList": [
{
"ServerId": "0",
"ServerName": "ns1.com"
},
{
"ServerId": "1",
"ServerName": "domain1.com",
"ServerIps": [
{
"Ip": "192.168.1.1"
},
{
"Ip": "1.1.1.1"
}
]
}
]
}
}
الحصول على أوامر إعدادات خادم أسماء المجال
إذا كنت تستدعي أمر إعدادات خوادم أسماء المجال، فيجب تضمين المعاملات التالية:
احصل على إعدادات خادم أسماء المجال لطلب البارامترالشرح
احصل على إعدادات خادم أسماء المجال لطلب البارامتر
الشرح
domain المجال الذي ترغب في الحصول على إعدادات خادم الأسماء الخاصة به، يمكن سحب إعدادات خادم الأسماء ل مجال 1 واحد فقط في كل طلب.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetDnsResponse></GetDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<GetDnsHeader></GetDnsHeader>رأس الاستجابة
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetDnsContent></GetDnsContent>محتوى الاستجابة
<NameServerSettings></NameServerSettings>إعدادات خادم اسم المجال
<Type></Type>نوع خادم اسم المجال
Get Domain Nameserver Settings ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_dns&domain=mydomain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetDnsResponse>
<GetDnsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetDnsHeader>
<GetDnsContent>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
</GetDnsContent>
</GetDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_dns&domain=mydomain.com
Response (JSON format){
"GetDnsResponse": {
"ResponseCode": 0,
"Status": "success",
"GetDns": {
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
}
}
}
}
معلومات الحساب
هذا الأمر متاح فقط بصيغة 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>المعلومات الافتراضية لنظام الويس
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرّف الاتصال
<DefaultAdmin></DefaultAdmin>المسؤول الافتراضي
<DefaultTechnical></DefaultTechnical>الافتراضية التقنية
<DefaultBilling></DefaultBilling>الفوترة الافتراضية
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع الإعلانات أم لا
Account Information ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=account_info
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<AccountInfoResponse>
<AccountInfoHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</AccountInfoHeader>
<AccountInfoContent>
<AccountInfo>
<Username>testname</Username>
<ForumName>test forum name</ForumName>
<AvatarUrl>test avatar url</AvatarUrl>
<Contact>
<Organization/>
<Name>testname test</Name>
<Email>[email protected]</Email>
<PhoneCc>1</PhoneCc>
<PhoneNum>555.555.5233</PhoneNum>
<FaxCc/>
<FaxNum/>
<Address1>1 test road</Address1>
<Address2/>
<City>Los Angeles</City>
<State>CA</State>
<ZipCode>90000</ZipCode>
<Country>US</Country>
</Contact>
<CustomerSince>1364888735253</CustomerSince>
<AccountLock>on</AccountLock>
<TotalSpending>$0.00</TotalSpending>
<PriceLevel>Regular Pricing</PriceLevel>
<AccountBalance>$70.02</AccountBalance>
<CustomTimeZone>PST</CustomTimeZone>
<DefaultSettings>
<DefaultWhois>
<DefaultRegistrant>
<ContactId>0</ContactId>
</DefaultRegistrant>
<DefaultAdmin>
<ContactId>0</ContactId>
</DefaultAdmin>
<DefaultTechnical>
<ContactId>0</ContactId>
</DefaultTechnical>
<DefaultBilling>
<ContactId>0</ContactId>
</DefaultBilling>
</DefaultWhois>
<DefaultNameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>yes</WithAds>
</DefaultNameServerSettings>
</DefaultSettings>
</AccountInfo>
</AccountInfoContent>
</AccountInfoResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=account_info
Response (JSON format){
"AccountInfoResponse": {
"ResponseCode": 0,
"Status": "success",
"AccountInfo": {
"Username": "testname",
"ForumName": "test forum name",
"AvatarUrl": "test avatar url",
"Contact": {
"Organization": "",
"Name": "testname test",
"Email": "[email protected]",
"PhoneCc": "1",
"PhoneNum": "555.555.5233",
"FaxCc": "",
"FaxNum": "",
"Address1": "1 test road",
"Address2": "",
"City": "Los Angeles",
"State": "CA",
"ZipCode": "90000",
"Country": "US"
},
"CustomerSince": "1364888735253",
"AccountLock": "on",
"TotalSpending": "$0.00",
"PriceLevel": "Regular Pricing",
"AccountBalance": "$70.02",
"CustomTimeZone": "PST",
"DefaultSettings": {
"DefaultWhois": {
"DefaultRegistrant": {
"ContactId": "0"
},
"DefaultAdmin": {
"ContactId": "0"
},
"DefaultTechnical": {
"ContactId": "0"
},
"DefaultBilling": {
"ContactId": "0"
}
},
"DefaultNameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "yes"
}
}
}
}
}
أمر الحصول على رصيد الحساب
هذا الأمر متاح فقط بتنسيق XML و JSON:
طلب الحصول على معلمات رصيد الحسابالشرح
طلب الحصول على معلمات رصيد الحساب
الشرح
N/Aلا توجد معلمات إضافية مطلوبة
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetAccountBalanceResponse></GetAccountBalanceResponse>جذر العقدة لمستند XML الاستجابة
<GetAccountBalanceHeader></GetAccountBalanceHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAccountBalanceContent></GetAccountBalanceContent>محتوى الاستجابة
<Balance></Balance>رصيد الحساب
Get Account Balance ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_account_balance
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetAccountBalanceResponse>
<GetAccountBalanceHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAccountBalanceHeader>
<GetAccountBalanceContent>
<BalanceList>
<Balance>
<Currency>USD</Currency>
<Amount>300.00</Amount>
</Balance>
</BalanceList>
</GetAccountBalanceContent>
</GetAccountBalanceResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_account_balance
Response (JSON format){
"GetAccountBalanceResponse": {
"ResponseCode": 0,
"Status": "success",
"BalanceList": [
{
"Currency": "USD",
"Amount": "300.00"
}
]
}
}
تعيين الواجهة الافتراضية لمعلومات المجال
إذا كنت تستخدم أمر 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"
Set Default Whois ExampleRequest (XML format)
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
Response (XML format)
<SetDefaultWhoisResponse>
<SetDefaultWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultWhoisHeader>
</SetDefaultWhoisResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_whois®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format){
"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
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultNsResponse>
<SetDefaultNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultNsHeader>
<SetDefaultNsContent>
<Servers>
<Server>
<ServerName>ns1.hosts.com</ServerName>
<ServerId>0</ServerId>
</Server>
<Server>
<ServerName>ns2.hosts.com</ServerName>
<ServerId>1</ServerId>
</Server>
</Servers>
</SetDefaultNsContent>
</SetDefaultNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_ns&ns0=ns1.hosts.com&ns1=ns2.host.com
Response (JSON format){
"SetDefaultNsResponse": {
"ResponseCode": 0,
"Status": "success",
"SetDefaultNsContent": {
"Servers": [
{
"ServerName": "ns1.hosts.com",
"ServerId": "0"
},
{
"ServerName": "ns2.hosts.com",
"ServerId": "1"
}
]
}
}
}
تعيين أمر انتظار افتراضي
إذا تم استدعاء أمر تعيين موقف الانتظار الافتراضي، فيجب تضمين البارامترات التالية:
تعيين إعدادات طلب ركن المجال الافتراضيةالشرح
تعيين إعدادات طلب ركن المجال الافتراضية
الشرح
with_ads (اختياري)إذا كنت لا ترغب في إعلانات من طرف ثالث، يمكنك استخدام هذه الباراميتر حيث أن القيمة الافتراضية هي "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultParkingResponse></SetDefaultParkingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultParkingHeader></SetDefaultParkingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Parking ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
Response (XML format)
<SetDefaultParkingResponse>
<SetDefaultParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultParkingHeader>
</SetDefaultParkingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_parking&folder_id=0&with_ads=no
Response (JSON format){
"SetDefaultParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر التوجيه الافتراضي
إذا تم استدعاء أمر تعيين التوجيه الافتراضي، يجب تضمين المعاملات التالية:
تعيين إعدادات طلب التوجيه الافتراضيالشرح
تعيين إعدادات طلب التوجيه الافتراضي
الشرح
forward_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه المجال الخاص بك التي تريدها، القيمة الافتراضية هي "temporary", إذا كنت ترغب في التوجيه الدائم، استخدم هذا المعامل مع "no"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultForwardingResponse></SetDefaultForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultForwardingHeader></SetDefaultForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Forwarding ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Response (XML format)
<SetDefaultForwardingResponse>
<SetDefaultForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultForwardingHeader>
</SetDefaultForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_forwarding&forward_url=http://mydomain.com
Response (JSON format){
"SetDefaultForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر التخفي الافتراضي
إذا كان الاتصال يضبط الأمر الافتراضي الخفي، يجب تضمين المعايير التالية:
تعيين معلمة طلب الإخفاء الافتراضيةالشرح
تعيين معلمة طلب الإخفاء الافتراضية
الشرح
stealth_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (اختياري)عنوان الصفحة
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultStealthResponse></SetDefaultStealthResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultStealthHeader></SetDefaultStealthHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Stealth ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (XML format)
<SetDefaultStealthResponse>
<SetDefaultStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultStealthHeader>
</SetDefaultStealthResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_stealth&stealth_title=obama's shop&stealth_url=http://www.obamashop.com
Response (JSON format){
"SetDefaultStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر الاستضافة الافتراضي
إذا تم استدعاء أمر تعيين الاستضافة الافتراضية، فيجب تضمين البارامترات التالية:
تعيين معامل طلب الاستضافة الافتراضيالشرح
تعيين معامل طلب الاستضافة الافتراضي
الشرح
hosting_typeنوع الاستضافة الافتراضية التي تريدها، يمكنك الاختيار في "advanced" و "basic"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultHostingResponse></SetDefaultHostingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultHostingHeader></SetDefaultHostingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default Hosting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_hosting&hosting_type=advanced
Response (XML format)
<SetDefaultHostingResponse>
<SetDefaultHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultHostingHeader>
</SetDefaultHostingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_hosting&hosting_type=advanced
Response (JSON format){
"SetDefaultHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر DNS الافتراضي
إذا كنت تقوم بتعيين أمر DNS الافتراضي، يجب تضمين البارامترات التالية:
هذا الأمر قديم وغير موصى به، يرجى استخدام أمر تعيين DNS2 الافتراضي بدلاً من ذلك.
تعيين معلمة طلب DNS الافتراضيةالشرح
تعيين معلمة طلب DNS الافتراضية
الشرح
main_record_typeالنوع الرئيسي للسجل
main_recordحدد سجل DNS ل مجالك
main_txt (اختياري)حدد سجل TXT ل مجالك. إذا كان نوع السجل الرئيسي الخاص بك هو aaaa وقمت بتحديد main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا، يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2، يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (اختياري)سجلات المجال الفرعي
sub_record_type0 - sub_record_type99 (اختياري)نوع سجلات المجال الفرعي
sub_record0 - sub_record99 (اختياري)عنوان بروتوكول الإنترنت أو الجهاز المستهدف
mx_host0 - mx_host2 (اختياري)حدد مضيف البريد الإلكتروني ل مجالك، distance0 هي الأولوية القصوى.
mx_distance0 - mx_distance2 (اختياري)Distance0 هو الأولوية القصوى
ttl (اختياري)وقت العيش
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultDnsResponse></SetDefaultDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultDnsHeader></SetDefaultDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default DNS ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<SetDefaultDnsResponse>
<SetDefaultDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format){
"SetDefaultDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر DNS2 الافتراضي
إذا كنت تقوم بتعيين أمر DNS الافتراضي، يجب تضمين البارامترات التالية:
تعيين إعداد طلب DNS2 الافتراضيالشرح
تعيين إعداد طلب DNS2 الافتراضي
الشرح
main_record_type0 - main_record_type19النوع الرئيسي للسجل
main_record0 - main_record19حدد سجل نظام أسماء المجالات ل مجالك
main_recordx0 - main_recordx19إليك الترجمة المتخصصة في مجال المجالات:
المسافة القصوى، نوع الإعادة التوجيه، عنوان إعادة التوجيه المخفي أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون main_record هو "a", "aaaa", "cname", "forward", "txt", "mx", "stealth", "email".
subdomain0 - subdomain99 (اختياري)سجلات المجال الفرعي
sub_record_type0 - sub_record_type99 (اختياري)نوع سجلات المجال الفرعي
sub_record0 - sub_record99 (اختياري)عنوان IP الفرعي أو الخادم المستهدف
sub_recordx0 - subdo_recordx99المسافة القصوى، نوع التوجيه، عنوان التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون نوع السجل الفرعي هو "a", "aaaa", "cname", "forward", "txt", "srv", "mx", "stealth", "email"
ttl (اختياري)وقت العيش
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultDnsResponse></SetDefaultDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultDnsHeader></SetDefaultDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Default DNS2 ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (XML format)
<SetDefaultDnsResponse>
<SetDefaultDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultDnsHeader>
</SetDefaultDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_dns2&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (JSON format){
"SetDefaultDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر توجيه البريد الإلكتروني الافتراضي
إذا تم استدعاء أمر تعيين التوجيه الافتراضي للبريد الإلكتروني، يجب تضمين البارامترات التالية:
تعيين إعدادات طلب توجيه البريد الإلكتروني الافتراضيالشرح
تعيين إعدادات طلب توجيه البريد الإلكتروني الافتراضي
الشرح
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"
Set Default Email Forward ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&
[email protected] Response (XML format)
<SetDefaultEmailForwardingResponse>
<SetDefaultEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultEmailForwardingHeader>
</SetDefaultEmailForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_email_forward&forward_type=forward&username0=test&
[email protected] Response (JSON format){
"SetDefaultEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر الإعداد الافتراضي الواضح
إذا كنت تستدعي أمر إعادة تعيين الإعدادات الافتراضية، فيجب تضمين البارامترات التالية:
تعيين طلب معامل الإعداد الافتراضي الواضحالشرح
تعيين طلب معامل الإعداد الافتراضي الواضح
الشرح
serviceالخدمة التي ترغب في مسحها، يمكن أن تكون التوجيه، التخفي، إعادة توجيه البريد الإلكتروني، نظام أسماء المجالات، وخوادم الأسماء.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetClearDefaultSettingResponse></SetClearDefaultSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearDefaultSettingHeader></SetClearDefaultSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Clear Default Setting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_default_setting&service=nameservers
Response (XML format)
<SetClearDefaultSettingResponse>
<SetClearDefaultSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearDefaultSettingHeader>
</SetClearDefaultSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_default_setting&service=nameservers
Response (JSON format){
"SetClearDefaultSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر تعيين خيار التجديد الافتراضي
إذا كنت تستدعي الأمر الافتراضي لخيار التجديد، يجب أن تشتمل على المعايير التالية:
تعيين معامل طلب خيار التجديد الافتراضيالشرح
تعيين معامل طلب خيار التجديد الافتراضي
الشرح
renew_optionيمكن أن يكون "donot", "auto", "reset"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetDefaultRenewOptionResponse></SetDefaultRenewOptionResponse>العقدة الجذرية لمستند الاستجابة XML
<SetDefaultRenewOptionHeader></SetDefaultRenewOptionHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال تعيين خيار التجديد الافتراضي
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_default_renew_option&renew_option=auto
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetDefaultRenewOptionResponse>
<SetDefaultRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetDefaultRenewOptionHeader>
</SetDefaultRenewOptionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_default_renew_option&renew_option=auto
Response (JSON format){
"SetDefaultRenewOptionResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
أمر إنشاء مجلد
إذا تم استدعاء أمر إنشاء مجلد، يجب تضمين البارامترات التالية:
إنشاء معلمة طلب مجلدالشرح
إنشاء معلمة طلب مجلد
الشرح
folder_nameاسم المجلد الذي تريد إنشاءه
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<FolderCreateResponse></FolderCreateResponse>العقدة الجذرية لمستند الاستجابة XML
<FolderCreateHeader></FolderCreateHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<FolderCreateContent></FolderCreateContent>محتوى الاستجابة
<FolderName></FolderName>اسم المجلد
<FolderId></FolderId>معرف المجلد الجديد
Create Folder ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=create_folder&folder_name=new
Response (XML format)
<FolderCreateResponse>
<FolderCreateHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</FolderCreateHeader>
<FolderCreateContent>
<FolderName>new</FolderName>
<FolderId>1</FolderId>
</FolderCreateContent>
</FolderCreateResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=create_folder&folder_name=new
Response (JSON format){
"FolderCreateResponse":{
"ResponseCode":"0",
"Status":"success",
"FolderCreateContent":{
"FolderName":"new",
"FolderId":"1"
}
}
}
أمر حذف المجلد
إذا تم استدعاء أمر Whois، فيجب تضمين المعاملات التالية:
طلب حذف مجلدالشرح
طلب حذف مجلد
الشرح
folder_idالمعرفات الخاصة بالمجلدات التي ترغب في حذفها، تأكد من أنها مفصولة بفواصل.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<DeleteFolderResponse></DeleteFolderResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteFolderHeader></DeleteFolderHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
مثال حذف مجلد
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_folder&folder_id=0,1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<DeleteFolderResponse>
<DeleteFolderHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteFolderHeader>
</DeleteFolderResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_folder&folder_id=0,1
Response (JSON format){
"DeleteFolderResponse": {
"SuccessCode": 0,
"Status": "success"
}
}
تعيين أمر معرفة معلومات المجلد
إذا كنت تستخدم أمر "معلومات المستخدم" لتحديد مجلد، فيجب تضمين البارامترات التالية:
تعيين معلمة طلب البحث في بيانات المجلدالشرح
تعيين معلمة طلب البحث في بيانات المجلد
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه
registrant_contactمعلومات المسجل الخاصة ب المجال
admin_contactمعلومات مسؤول المجال
technical_contactمعلومات فنية حول المجال
billing_contactمعلومات الفوترة الخاصة ب المجال
enable (اختياري)إذا كنت ترغب في تطبيق إعدادات الويز هذه على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات Whois لجميع المجالات الموجودة في هذا المجلد، يمكنك استخدام هذه الباراميتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderWhoisResponse></SetFolderWhoisResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderWhoisHeader></SetFolderWhoisHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Whois ExampleRequest (XML format)
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
Response (XML format)
<SetFolderWhoisResponse>
<SetFolderWhoisHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderWhoisHeader>
</SetFolderWhoisResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_whois&folder_id=0®istrant_contact=0&admin_contact=0&technical_contact=0&billing_contact=0
Response (JSON format){
"SetFolderWhoisResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر اسم خوادم المجلد
إذا كنت تستخدم أمر تعيين اسم مجلد الخوادم، فيجب تضمين البارامترات التالية:
تعيين معلمة طلب خوادم اسم المجلدالشرح
تعيين معلمة طلب خوادم اسم المجلد
الشرح
fold_idالمعرف الخاص بالمجلد الذي تريد تعيينه، يمكن تعيين مجلد 1 واحد فقط لكل طلب
ns0 - ns12لتعيين خوادم الأسماء الخاصة ب مجالك للاستخدام، يمكنك تحديد ما يصل إلى 13 من خوادم الأسماء، ولكن يجب أن تكون موجودة بالفعل في حسابك
enable (اختياري)إذا كنت ترغب في تطبيق إعدادات خوادم الأسماء هذه على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه العبارة مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات خادم الأسماء لجميع المجالات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "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
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderNsResponse>
<SetFolderNsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderNsHeader>
<SetFolderNsContent>
<Servers>
<Server>
<ServerName>ns1.hosts.com</ServerName>
<ServerId>0</ServerId>
</Server>
<Server>
<ServerName>ns2.hosts.com</ServerName>
<ServerId>1</ServerId>
</Server>
</Servers>
</SetFolderNsContent>
</SetFolderNsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_ns&folder_id=0&ns0=ns1.hosts.com&ns1=ns2.host.com&enable=yes&sync=yes
Response (JSON format){
"SetFolderNsResponse": {
"ResponseCode": 0,
"Status": "success",
"SetFolderNsContent": {
"Servers": [
{
"ServerName": "ns1.hosts.com",
"ServerId": "0"
},
{
"ServerName": "ns2.hosts.com",
"ServerId": "1"
}
]
}
}
}
تعيين أمر ركن المجلد
إذا تم استدعاء أمر وضع مجلد الانتظار، فيجب تضمين البارامترات الآتية:
تعيين معامل طلب ركن المجلدالشرح
تعيين معامل طلب ركن المجلد
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه، يمكن تعيين مجلد 1 واحد فقط لكل طلب
with_ads (اختياري)إذا كنت لا ترغب في إعلانات من طرف ثالث، يمكنك استخدام هذه الباراميتر حيث أن القيمة الافتراضية هي "yes"
enable (اختياري)إذا أردت تطبيق هذا الإعداد للمواقف على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات إيقاف جميع المجالات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderParkingResponse></SetFolderParkingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderParkingHeader></SetFolderParkingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Parking ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Response (XML format)
<SetFolderParkingResponse>
<SetFolderParkingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderParkingHeader>
</SetFolderParkingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_parking&folder_id=0&with_ads=no
Response (JSON format){
"SetFolderParkingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر توجيه المجلد
إذا تم استدعاء أمر توجيه مجلد الإعداد، فيجب تضمين البارامترات التالية:
تعيين معامل طلب توجيه المجلدالشرح
تعيين معامل طلب توجيه المجلد
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه
forward_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
is_temp (اختياري)حالة توجيه المجال الخاص بك التي تريدها، القيمة الافتراضية هي "temporary", إذا كنت ترغب في التوجيه الدائم، استخدم هذا المعامل مع "no"
enable (اختياري)إذا كنت ترغب في تطبيق هذا الإعداد للتوجيه إلى المجلدات المستقبلية التي ت انتقال إليها المجالات، يمكنك استخدام هذه الباراميتر مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات التوجيه لجميع المجالات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderForwardingResponse></SetFolderForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderForwardingHeader></SetFolderForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Forwarding ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Response (XML format)
<SetFolderForwardingResponse>
<SetFolderForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderForwardingHeader>
</SetFolderForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_forwarding&folder_id=0&forward_url=http://mydomain.com&sync=yes
Response (JSON format){
"SetFolderForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر إخفاء المجلد
إذا كنت تستدعي أمر إعداد مجلد الخفاء، يجب تضمين البارامترات التالية:
تعيين بارامتر طلب إخفاء المجلدالشرح
تعيين بارامتر طلب إخفاء المجلد
الشرح
folder_idالمعرّف الخاص بالمجلد الذي ترغب في تعيينه
stealth_urlالرابط الذي تريد توجيه مجالك إليه. يرجى ملاحظة أنه يجب ترميز البارامتر حتى يتم تفسير استدعاء API بشكل صحيح.
stealth_title (اختياري)عنوان الصفحة
enable (اختياري)إذا كنت ترغب في تطبيق هذا الإعداد الخفي على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات الخفاء لجميع المجالات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderStealthResponse></SetFolderStealthResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderStealthHeader></SetFolderStealthHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Stealth ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Response (XML format)
<SetFolderStealthResponse>
<SetFolderStealthHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderStealthHeader>
</SetFolderStealthResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_stealth&folder_id=0&stealth_title=obama's shop&stealth_url=http://www.obamashop.com&sync=yes
Response (JSON format){
"SetFolderStealthResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تحديد أمر استضافة المجلد
إذا كنت تقوم بتنفيذ أمر تعيين مجلد الاستضافة، فيجب تضمين البارامترات التالية:
تعيين معلمة طلب استضافة المجلدالشرح
تعيين معلمة طلب استضافة المجلد
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه
hosting_typeنوع الاستضافة التي ترغب بها، يمكنك اختياره في "advanced" و "basic"
enable (اختياري)إذا كنت ترغب في تطبيق إعدادات الاستضافة هذه على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
even (اختياري)إذا كنت ترغب في مزامنة إعدادات الاستضافة لجميع المجالات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderHostingResponse></SetFolderHostingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderHostingHeader></SetFolderHostingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Hosting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Response (XML format)
<SetFolderHostingResponse>
<SetFolderHostingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderHostingHeader>
</SetFolderHostingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_hosting&folder_id=0&hosting_type=advanced&sync=yes
Response (JSON format){
"SetFolderHostingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر DNS للمجلد
إذا تم استدعاء أمر تعيين مجلد DNS، فيجب تضمين البارامترات التالية:
(هذا الأمر قديم ولا يُنصح باستخدامه، يرجى استخدام أمر تعيين DNS2 للمجلد بدلاً من ذلك)
تعيين معلمة طلب DNS للمجلدالشرح
تعيين معلمة طلب DNS للمجلد
الشرح
folder_idمعرف المجلد الذي ترغب في ضبطه
main_record_typeالنوع الرئيسي للسجل
main_recordحدد سجل DNS ل مجالك
main_recordحدد سجل DNS ل مجالك
with_ads (اختياري)حدد سجل TXT ل مجالك. إذا كان نوع السجل الرئيسي الخاص بك هو aaaa وقمت بتحديد main_record2، يمكنك تعيين ما يصل إلى 3 main_txts، وإلا، يمكنك تعيين ما يصل إلى 4 main_txts.
main_record2السجل الرئيسي 2، يُستخدم فقط عندما يكون "main_record_type" هو "aaaa". يجب أن تكون قيمته بتنسيق ipv4.
subdomain0 - subdomain99 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type99 (اختياري)نوع سجلات المجال الفرعي
sub_record0 - sub_record99 (اختياري)عنوان بروتوكول الإنترنت أو الجهاز المستهدف
mx_host0 - mx_host2 (اختياري)حدد مضيف البريد الإلكتروني ل مجالك، distance0 هي الأولوية القصوى.
mx_distance0 - mx_distance2 (اختياري)Distance0 هو ذو الأولوية القصوى
ttl (اختياري)وقت العيش
enable (اختياري)إذا كنت ترغب في تطبيق إعداد DNS هذا على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات خادم DNS هذا لجميع المجالات الموجودة في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderDnsHeader></SetFolderDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder DNS ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (XML format)
<SetFolderDnsResponse>
<SetFolderDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderDnsHeader>
</SetFolderDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns&folder_id=0&main_record_type=aaaa&main_record=0:0:0:0:0:0:0:1
Response (JSON format){
"SetFolderDnsResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر DNS2 للمجلد
إذا تم استدعاء أمر تعيين مجلد DNS2، يجب تضمين البارامترات التالية:
تعيين معامل طلب DNS2 للمجلدالشرح
تعيين معامل طلب DNS2 للمجلد
الشرح
folder_idمعرف المجلد الذي ترغب في ضبطه
main_record_type0 - main_record_type19النوع الرئيسي للسجل يجب أن يكون "a"، "aaaa"، "cname"، "forward"، "txt"، "mx"، "stealth"، "email".
main_record0 - main_record19حدد سجل نظام أسماء المجالات ل مجالك
main_recordx0 - main_recordx19مسافة Mx، نوع الإعادة، عنوان إعادة السرية أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون main_record_type هو إعادة، mx، سرية، بريد.
subdomain0 - subdomain99 (اختياري)Subdomain records (اختياري)
sub_record_type0 - sub_record_type99 (اختياري)نوع سجلات المجال الفرعي يجب أن يكون A، AAAA، CNAME، توجيه، TXT، SRV، MX، خفي، البريد الإلكتروني.
sub_record0 - sub_record99 (اختياري)عنوان بروتوكول الإنترنت أو الجهاز المستهدف
sub_recordx0 - sub_recordx99 (اختياري)مسافة MX، نوع التوجيه، عنوان التوجيه الخفي أو الاسم المستعار للبريد الإلكتروني، ضروري عندما يكون نوع السجل الفرعي هو توجيه، MX، خفي، بريد إلكتروني.
ttl (اختياري)وقت العيش
enable (اختياري)إذا كنت ترغب في تطبيق إعداد DNS هذا على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه المعلمة مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة إعدادات خادم DNS هذا لجميع المجالات الموجودة في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderDnsResponse></SetFolderDnsResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderDnsHeader></SetFolderDnsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
تعيين مثال DNS2 للمجلد
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetFolderDnsResponse>
<SetFolderDnsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderDnsHeader>
</SetFolderDnsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_dns2&folder_id=0&main_record_type0=aaaa&main_record0=0:0:0:0:0:0:0:1
Response (JSON format){
"SetFolderDnsResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
تعيين أمر تحويل البريد الإلكتروني للمجلد
إذا كان الأمر يتعلق بتعيين مجلد لتوجيه رسائل البريد الإلكتروني، فيجب تضمين البارامترات التالية:
تعيين معامل طلب توجيه البريد الإلكتروني للمجلدالشرح
تعيين معامل طلب توجيه البريد الإلكتروني للمجلد
الشرح
domain المجال الذي ترغب في تعيينه، يمكن تعيين 100 مجالات لكل طلب، تأكد من أنها مفصولة بفواصل.
folder_idمعرف المجلد الذي ترغب في تعيينه
forward_typeنوع الإعادة، يمكن أن يكون "donot": عدم إعادة توجيه البريد الإلكتروني، "mx": تسليم البريد الإلكتروني إلى مضيف بريد آخر (سجل MX)، "forward": تسليم البريد الإلكتروني إلى مضيف بريد آخر
username0 - username9اسم المستخدم، يُستخدم فقط عندما يكون "forward_type" هو "forward"
exist_email0 - exist_email9عنوان البريد الإلكتروني الحالي، يُستخدم فقط عندما يكون "forward_type" هو "forward"
mx_host0 - mx_host2مضيف البريد الإلكتروني، يُستخدم فقط عندما يكون "forward_type" هو "mx"
mx_distance0 - mx_distance2Distance0 هي الأولوية القصوى، تُستخدم فقط عندما يكون "forward_type" "mx"
enable (اختياري)إذا كنت ترغب في تطبيق هذا الإعداد على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه الباراميتر مع "yes"
sync (اختياري)إذا كنت ترغب في مزامنة هذا الإعداد لجميع المجالات الموجودة في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderEmailForwardingResponse></SetFolderEmailForwardingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderEmailForwardingHeader></SetFolderEmailForwardingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Email Forward ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&
[email protected] Response (XML format)
<SetFolderEmailForwardingResponse>
<SetFolderEmailForwardingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderEmailForwardingHeader>
</SetFolderEmailForwardingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_email_forward&folder_id=0&forward_type=forward&username0=test&
[email protected] Response (JSON format){
"SetFolderEmailForwardingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر إعدادات المجلد الواضح
إذا تم استدعاء أمر إعداد مجلد مسح الضبط، يجب تضمين البارامترات التالية:
تعيين طلب إعداد مجلد واضحالشرح
تعيين طلب إعداد مجلد واضح
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه
serviceالخدمة التي ترغب في مسحها، يمكن أن تكون التوجيه، التخفي، إعادة توجيه البريد الإلكتروني، نظام أسماء المجالات، وخوادم الأسماء.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetClearFolderSettingResponse></SetClearFolderSettingResponse>العقدة الجذرية لمستند الاستجابة XML
<SetClearFolderSettingHeader></SetClearFolderSettingHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Clear Folder Setting ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Response (XML format)
<SetClearFolderSettingResponse>
<SetClearFolderSettingHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetClearFolderSettingHeader>
</SetClearFolderSettingResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_clear_folder_setting&folder_id=0&service=nameservers
Response (JSON format){
"SetClearFolderSettingResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر تسمية المجلد
إذا تم استدعاء أمر تسمية المجلد، فيجب تضمين المعاملات التالية:
تعيين معامل طلب اسم المجلدالشرح
تعيين معامل طلب اسم المجلد
الشرح
folder_idمعرف المجلد الذي تريد ضبطه
folder_nameاسم المجلد الجديد
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetFolderNameResponse></SetFolderNameResponse>العقدة الجذرية لمستند الاستجابة XML
<SetFolderNameHeader></SetFolderNameHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Set Folder Name ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
Response (XML format)
<SetFolderNameResponse>
<SetFolderNameHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderNameHeader>
</SetFolderNameResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_name&folder_id=0&folder_name=new
Response (JSON format){
"SetFolderNameResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
تعيين أمر تجديد مجلد
إذا كنت تستخدم أمر تجديد خيار مجلد الضبط، فيجب تضمين البارامترات التالية:
طلب تعيين معلمة خيار تجديد المجلدالشرح
طلب تعيين معلمة خيار تجديد المجلد
الشرح
folder_idالمعرف الخاص بالمجلد الذي تريد تعيينه، يمكن تعيين مجلد 1 واحد فقط لكل طلب
renew_optionخيار التجديد الذي تريد تعيينه للمجلد؛ يمكن أن يكون "donot"، "auto" أو "reset".
enable (اختياري)إذا كنت ترغب في تطبيق إعداد التجديد هذا على المجالات المستقبلية التي ت انتقالها إلى هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
sync (اختياري)إذا كنت تريد مزامنة إعدادات التجديد لجميع المجالات في هذا المجلد، يمكنك استخدام هذه البارامتر مع "yes"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<Response></Response>العقدة الجذرية لمستند الاستجابة XML
<ResponseHeader></ResponseHeader>رأس الاستجابة
<ResponseCode></ResponseCode>رمز الاستجابة، "0" للنجاح، "-1" للفشل
<Error></Error>معلومات الخطأ، يتم استخدامها فقط عندما يكون رمز الاستجابة هو "-1"
Set Folder Renew Option ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Response (XML format)
<SetFolderRenewOptionResponse>
<SetFolderRenewOptionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetFolderRenewOptionHeader>
</SetFolderRenewOptionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_folder_renew_option&folder_id=0&renew_option=auto
Response (JSON format){
"SetFolderRenewOptionResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
قائمة مجلد الأوامر
هذا الأمر متاح فقط بصيغة XML و JSON:
طلب معلمات قائمة المجلداتالشرح
طلب معلمات قائمة المجلدات
الشرح
N/Aلا توجد معلمات إضافية مطلوبة
<FolderListResponse></FolderListResponse>العقدة الجذرية لمستند الاستجابة XML
<FolderListHeader></FolderListHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<FolderListContent></FolderListContent>محتوى الاستجابة
<FolderList></FolderList>قائمة المجلدات
<List></List>
<Folder></Folder>
<FolderId></FolderId>معرف المجلد
<FolderName></FolderName>اسم المجلد
<DefaultWhois></DefaultWhois>المعلومات الافتراضية لنظام الويس
<DefaultWhoisEnableStatus></DefaultWhoisEnableStatus>الحالة الافتراضية لتفعيل الويز
<DefaultRegistrant></DefaultRegistrant>المسجل الافتراضي
<ContactId></ContactId>معرّف جهة الاتصال
<DefaultAdmin></DefaultAdmin>المسؤول الافتراضي
<DefaultTechnical></DefaultTechnical>معلومات فنية افتراضية
<DefaultBilling></DefaultBilling>معلومات الفوترة الافتراضية
<DefaultNameServerEnableStatus></DefaultNameServerEnableStatus>حالة تفعيل خادم الاسم الافتراضي
<NameServerSettings></NameServerSettings>إعدادات خادم الأسماء
<Type></Type>نوع خادم الأسماء
<WithAds></WithAds>مع الإعلانات أم لا
<DefaultRenewOption></DefaultRenewOption>خيار التجديد الافتراضي
<DefaultRenewOptionEnableStatus></DefaultRenewOptionEnableStatus>الحالة الافتراضية لتفعيل خيار التجديد
<RenewOption></RenewOption>خيار التجديد
<DefaultTransferLock></DefaultTransferLock>قفل انتقال افتراضي
<DefaultTransferLockEnableStatus></DefaultTransferLockEnableStatus>حالة تفعيل قفل ال انتقال الافتراضي
<LockStatus></LockStatus>حالة القفل
Folder List ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=folder_list
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<FolderListResponse>
<FolderListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</FolderListHeader>
<FolderListContent>
<FolderList>
<List>
<Folder>
<FolderId>0</FolderId>
<FolderName>new</FolderName>
<DefaultWhois>
<DefaultWhoisEnableStatus>disable</DefaultWhoisEnableStatus>
<DefaultRegistrant>
<ContactId>0</ContactId>
</DefaultRegistrant>
<DefaultAdmin>
<ContactId>0</ContactId>
</DefaultAdmin>
<DefaultTechnical>
<ContactId>0</ContactId>
</DefaultTechnical>
<DefaultBilling>
<ContactId>0</ContactId>
</DefaultBilling>
</DefaultWhois>
<DefaultNameServers>
<DefaultNameServerEnableStatus>disable</DefaultNameServerEnableStatus>
<NameServerSettings>
<Type>Dynadot Parking</Type>
<WithAds>Yes</WithAds>
</NameServerSettings>
</DefaultNameServers>
<DefaultRenewOption>
<DefaultRenewOptionEnableStatus>disable</DefaultRenewOptionEnableStatus>
<RenewOption>no renew option</RenewOption>
</DefaultRenewOption>
<DefaultTransferLock>
<DefaultTransferLockEnableStatus>disable</DefaultTransferLockEnableStatus>
<LockStatus>locked</LockStatus>
</DefaultTransferLock>
</Folder>
</List>
</FolderList>
</FolderListContent>
</FolderListResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=folder_list
Response (JSON format){
"FolderListResponse": {
"ResponseCode": 0,
"Status": "success",
"FolderList": [
{
"FolderId": "0",
"FolderName": "new",
"DefaultWhois": {
"DefaultWhoisEnableStatus": "disable",
"DefaultRegistrant": {
"ContactId": "0"
},
"DefaultAdmin": {
"ContactId": "0"
},
"DefaultTechnical": {
"ContactId": "0"
},
"DefaultBilling": {
"ContactId": "0"
}
},
"DefaultNameServers": {
"DefaultTransferLockEnableStatus": "disable",
"NameServerSettings": {
"Type": "Dynadot Parking",
"WithAds": "Yes"
}
},
"DefaultRenewOption": {
"DefaultRenewOptionEnableStatus": "disable",
"RenewOption": "no renew option"
},
"DefaultTransferLock": {
"DefaultTransferLockEnableStatus": "disable",
"LockStatus": "locked"
}
}
]
}
}
أضف أمر طلب الشراء المعلق
إذا كان الأمر يتعلق بإضافة طلب شراء مؤجل، فيجب تضمين البارامترات التالية:
إضافة طلب حجز مسبق للمعلماتالشرح
إضافة طلب حجز مسبق للمعلمات
الشرح
domain المجالات التي ترغب في إضافتها والموافقة على الدفع مقابلها في حالة قيام داينادوت بالتقاطها، يمكن إضافة 100 مجالات لكل طلب، يجب فصلها بفواصل.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<AddBackorderRequestResponse></AddBackorderRequestResponse>العقدة الجذرية لمستند الاستجابة XML
<AddBackorderRequestHeader></AddBackorderRequestHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Add Backorder Request ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Response (XML format)
<AddBackorderRequestResponse>
<AddBackorderRequestHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</AddBackorderRequestHeader>
</AddBackorderRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=add_backorder_request&domain=droppingdomain.com,domaindropping.net,domaindrop.org
Response (JSON format){
"AddBackorderRequestResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
أمر حذف طلب الشراء المؤجل
إذا كنت تستدعي أمر طلب حذف الطلب المعلق، يجب أن تتضمن البارامترات التالية:
طلب حذف طلب الشراء المعلقالشرح
طلب حذف طلب الشراء المعلق
الشرح
domain المجالات التي ترغب في إزالتها من قائمة طلبات الحجز المسبق الخاصة بك، يمكن إزالة 100 مجالات لكل طلب، يجب فصلها بفواصل
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<DeleteBackorderRequestResponse></DeleteBackorderRequestResponse>العقدة الجذرية لمستند الاستجابة XML
<DeleteBackorderRequestHeader></DeleteBackorderRequestHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Delete Backorder Request ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
Response (XML format)
<DeleteBackorderRequestResponse>
<DeleteBackorderRequestHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</DeleteBackorderRequestHeader>
</DeleteBackorderRequestResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=delete_backorder_request&domain=domaindropp.com
Response (JSON format){
"DeleteBackorderRequestResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
قائمة أوامر طلب الشراء المسبق
سيؤدي استدعاء أمر قائمة طلبات الشراء المؤجلة إلى إرجاع قائمة بطلبات الشراء المؤجلة للحساب المحدد. عند استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
قائمة طلب الطلبات المسبقة لل مجالاتالشرح
قائمة طلب الطلبات المسبقة لل مجالات
الشرح
start_dateتاريخ بدء المزاد الذي ترغب في طلبه، بتنسيق سنة-شهر-يوم، مثل 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>حالة عملية التقاط المجالات
قائمة طلبات الحجز المسبق كمثال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BackorderRequestListResponse>
<BackorderRequestListHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</BackorderRequestListHeader>
<BackorderRequestListContent>
<BackorderRequestList>
<BackorderRequest>
<DomainName>testdrop.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop3.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop4.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
<BackorderRequest>
<DomainName>testdrop5.com</DomainName>
<CutoffTime>1403914140000</CutoffTime>
<BackorderRequestStatus>Active</BackorderRequestStatus>
</BackorderRequest>
</BackorderRequestList>
</BackorderRequestListContent>
</BackorderRequestListResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (JSON format){
"BackorderRequestListResponse": {
"ResponseCode": 0,
"Status": "success",
"BackorderRequestList": [
{
"DomainName": "testdrop.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop3.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop4.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
},
{
"DomainName": "testdrop5.com",
"CutoffTime": "1403914140000",
"BackorderRequestStatus": "Active"
}
]
}
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=backorder_request_list&startDate=2015-01-01&endDate=2015-5-20
Response (تنسيق CSV)ok,success,Domain,CutoffTime,BackorderRequestStatus,testdrop.com,1403914140000,Active,testdrop3.com,1403914140000,Active,testdrop4.com,1403914140000,Active,testdrop5.com,1403914140000,Active
أمر الحصول على المزادات المفتوحة
استدعاء أمر الحصول على المزادات المفتوحة سيُعيد قائمة بالمزادات الجارية. عند استدعاء هذا الأمر، يجب تضمين المعايير التالية:
طلب الحصول على معلمات المزادات المفتوحةالشرح
طلب الحصول على معلمات المزادات المفتوحة
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
typeنوع المزاد الذي تريد رؤيته، يجب أن يكون "expired", "user", "backorder", أو "registry_expired", "registrar", إذا كنت ترغب في الحصول على أكثر من نوع مزاد، يمكنك استخدام "," لفصل كل نوع مزاد
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetOpenAuctionsResponse></GetOpenAuctionsResponse>علامة استجابة الحصول على المزادات المفتوحة، إنها العقدة الجذرية لوثيقة الاستجابة XML
<GetOpenAuctionsHeader></GetOpenAuctionsHeader>الحصول على عنوان المزادات المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetOpenAuctionsContent></GetOpenAuctionsContent>علامة الحصول على محتوى المزادات المفتوحة، تُستخدم فقط عندما يكون الوضع "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم المجال المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار المجال
<Links></Links>روابط الدومين الواردة
<Age></Age>عمر المجال
Get Open Auctions ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_auctions¤cy=usd&type=expired
Response (XML format)
<GetOpenAuctionsResponse>
<GetOpenAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenAuctionsHeader>
<GetOpenAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
<Revenue>72</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>-1</Links>
<Age>1</Age>
</Auction>
.
.
.
</GetOpenAuctionsContent>
</GetOpenAuctionsResponse>
طلب (تنسيق csv)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_auctions¤cy=usd&type=expired
الاستجابة
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp,Revenue,RevenueCurrency,Visitors,Links,Age
10001,domain.com,92.99,USD,0,2015/04/28 18:04 UTC,1430244248274,0.64,USD,-1,-1,1
10002,xn--wkccg.com,77.99,USD,0,2015/05/01 06:04 UTC,1430460248338,86,USD,435,-1,1
10003,domain2.com,11.25,USD,0,2015/05/05 06:04 UTC,1430805846946,91,USD,358,-1,1
.
.
.
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_open_auctions¤cy=usd&type=expired
Response (JSON format){
"status": "success",
"auction_list": [
{
"auction_id": 11,
"domain": "domain.com",
"utf_name": "domain.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "124.00",
"bids": 4,
"bidders": 2,
"time_left": "1 day, 23 hours",
"start_time": "2022/03/28 02:20 PST",
"start_time_stamp": 1648459234033,
"end_time": "2022/04/04 02:20 PST",
"end_time_stamp": 1649064034033,
"visitors": 223,
"links": "-",
"age": 0,
"dyna_appraisal": "-"
},
{
"auction_id": 12,
"domain": "domain0.com",
"utf_name": "domain0.com",
"is_idn": false,
"auction_type": "expired",
"currency": "USD",
"current_bid_price": "44.99",
"bids": 1,
"bidders": 1,
"time_left": "2 days, 23 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"visitors": 245,
"links": "-",
"age": 0,
"dyna_appraisal": "-"
}
...
]
}
الحصول على تفاصيل مزاد الأوامر
استدعاء أمر الحصول على تفاصيل المزاد سيعيد تفاصيل المزاد المحدد. هذا الأمر متوفر فقط بصيغة XML و JSON. عند استدعاء هذا الأمر، يجب تضمين المعايير التالية:
الحصول على تفاصيل طلب المزادالشرح
الحصول على تفاصيل طلب المزاد
الشرح
domainيجب أن يستخدم اسم المجال للمزاد العلني، والاسم المجالي الدولي، نظام البونيكود، مثل xn--wkccg.com. يمكنك الحصول على أكثر من مزاد واحد، ويجب فصل كل مجال بواسطة،
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetAuctionDetailsResponse></GetAuctionDetailsResponse>تسمية استجابة تفاصيل المزاد، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>تفاصيل رأس مزاد الطلبات المعلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>علامة الحصول على محتوى تفاصيل المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionStatusId></AuctionStatusId>حالة معرف المزاد: '0' للجاري، '1' للإلغاء بواسطة المستخدم، '2' للإلغاء بواسطة الإدارة، '3' للإلغاء بسبب التجديد، '4' للمكتمل، '5' للإلغاء بسبب ال انتقال بعيدًا
<AuctionStatus></AuctionStatus>حالة المزاد
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو أعلى عرض
<YourCurrentBid></YourCurrentBid>سعر المزايدة الحالي الخاص بك للمزاد المحدد. إذا لم تقم بوضع مزايدة، سيكون '-1'
<YourProxyBid></YourProxyBid>عرضك الافتراضي للمزاد المحدد. إذا لم تكن قد قدمت عرضًا، سيكون {و}
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم المجال المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<IsPremium></IsPremium>سواء كان مجالًا مميزًا
<RenewalPrice></RenewalPrice>سعر التجديد
Get Auction Details ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetAuctionDetailsResponse>
<GetAuctionDetailsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionDetailsHeader>
<GetAuctionDetailsContent>
<Auction>
<AuctionStatusId>0</AuctionStatusId>
<AuctionStatus>1</AuctionStatus>
<AuctionId>0</AuctionId>
<Domain>test.biz</Domain>
<BidPrice>46.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>1970/01/01 00:00 UTC</EndTime>
<EndTimestamp>0</EndTimestamp>
<Revenue>1</Revenue>
<RevenueCurrency>USD</RevenueCurrency>
<Visitors>-1</Visitors>
<Links>1</Links>
<Age>10</Age>
<isPremium>false</isPremium>
<RenewalPrice>-0.1</RenewalPrice>
<UserIsHighBid>false</UserIsHighBid>
<YourCurrentBid>-1</YourCurrentBid>
<YourProxyBid>-1</YourProxyBid>
</Auction>
</GetAuctionDetailsContent>
</GetAuctionDetailsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_auction_details&domain=domain0.com¤cy=usd
Response (JSON format){
"status": "success",
"size": 1,
"auction_details": [
{
"auction_json": {
"auction_id": 0,
"domain": "test.biz",
"utf_name": "test.biz",
"is_idn": false,
"auction_type": "expired",
"current_bid_price": "46.99",
"accepted_bid_price": "46.99",
"currency": "USD",
"is_high_bidder": false,
"bids": 0,
"bidders": 0,
"auction_status_id": 0,
"time_left": "1",
"start_time": "1",
"start_time_stamp": 0,
"end_time": "",
"end_time_stamp": 0,
"revenue": "1",
"visitors": -1,
"links": "1",
"age": 10,
"estibot_appraisal": "",
"bidder_name": "",
"bid_price": "",
"timestamp": 0,
"bid_status": "",
"is_proxy_auto_bid": false,
"auction_ended": false,
"customer_bided": false,
"customer_bid": "1",
"customer_proxy_bid": "1",
"is_premium": false,
"renewal_price": "-0.1"
},
"bid_history": []
}
]
}
الحصول على أوامر مزايدات المزاد
استدعاء أمر الحصول على عروض المزايدة في المزاد سيتيح لك الحصول على قائمة عروضك التي شاركت فيها. عند استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
طلب الحصول على معلمات عروض المزادالشرح
طلب الحصول على معلمات عروض المزاد
الشرح
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetAuctionBidsResponse></GetAuctionBidsResponse>علامة استجابة عروض المزاد، إنها العقدة الجذرية لمستند الاستجابة XML
<GetAuctionBidsHeader></GetAuctionBidsHeader>الحصول على عنوان مزايدات المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAuctionBidsContent></GetAuctionBidsContent>علامة محتوى عروض المزاد، تُستخدم فقط عندما يكون الحالة "success"
<BidList></BidList>قائمة المزايدات
<Bid></Bid>عنصر المزايدة
<BidId></BidId>معرّف العطاء
<AuctionId></AuctionId>معرف المزاد
<AccountId></AccountId>معرف الحساب
<Domain></Domain>اسم المجال المعروض للمزاد
<DomainUtf></DomainUtf>اسم مجال utf للمزاد
<AuctionType></AuctionType>نوع المزاد
<IsIdn></IsIdn>إذا كان هذا المجال هو اسم مجال معرّب
<CurrentBid></CurrentBid>السعر الحالي للمزايدة في المزاد
<YourStatus></YourStatus>حالة عرضك في المزاد
<ProxyBid></ProxyBid>سعر العطاء بالوكالة الخاص بك للمزاد
<ActiveBidders></ActiveBidders>عدد المزايدين الذين يشاركون في هذا المزاد
<TimeLeft></TimeLeft>الوقت المتبقي للمزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>وقت انتهاء المزاد
Get Auction Bids ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_auction_bids&currency=usd
Response (XML format)
<GetAuctionBidsResponse>
<GetAuctionBidsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetAuctionBidsHeader>
<GetAuctionBidsContent>
<BidList>
<Bid>
<BidId>0</BidId>
<AuctionId>11</AuctionId>
<AccountId>1</AccountId>
<Domain>domain.com</Domain>
<DomainUtf>domain.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$124.00</CurrentBid>
<YourStatus>Out Bid</YourStatus>
<ProxyBid>$119.00</ProxyBid>
<ActiveBidders>2</ActiveBidders>
<TimeLeft>1 day, 6 hours</TimeLeft>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Bid>
<Bid>
<BidId>9</BidId>
<AuctionId>12</AuctionId>
<AccountId>1</AccountId>
<Domain>domain0.com</Domain>
<DomainUtf>domain0.com</DomainUtf>
<AuctionType>expired</AuctionType>
<IsIdn>false</IsIdn>
<CurrentBid>$44.99</CurrentBid>
<YourStatus>High Bidder</YourStatus>
<ProxyBid>$121.00</ProxyBid>
<ActiveBidders>1</ActiveBidders>
<TimeLeft>2 days, 6 hours</TimeLeft>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Bid>
</BidList>
</GetAuctionBidsContent>
</GetAuctionBidsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_auction_bids&currency=usd
Response (JSON format){
"status": "success",
"auction_bids": [
{
"bid_id": 0,
"auction_id": 11,
"account_id": "1",
"domain": "domain.com",
"domain_utf": "domain.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "1 day, 23 hours",
"end_time": "2022/04/04 02:20:34 PST",
"end_time_stamp": 1649064034033
},
{
"bid_id": 2,
"auction_id": 12,
"account_id": "1",
"domain": "domain0.com",
"domain_utf": "domain0.com",
"auction_type": "expired",
"is_idn": false,
"current_bid": "$44.99",
"your_status": "High Bidder",
"proxy_bid": "$119.00",
"active_bidders": 1,
"time_left": "2 days, 23 hours",
"end_time": "2022/04/05 02:20:34 PST",
"end_time_stamp": 1649150434049
}
...
]
}
أمر وضع عطاء المزاد
استدعاء أمر مزايدة المزاد سيضع مزايدة للمزاد المحدد. عند استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
طلب معلمات المزايدة في المزادالشرح
طلب معلمات المزايدة في المزاد
الشرح
domainاسم المجال للمزاد، IDN (اسم المجال المعرب) يجب أن يستخدم البونيكود، مثل xn--wkccg.com
bid_amountمقدار عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها من خلال معامل العملة أدناه
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<PlaceAuctionBidResponse></PlaceAuctionBidResponse>علامة رد مزايدة مكان المزاد، إنها العقدة الجذرية لوثيقة الاستجابة XML
<PlaceAuctionBidHeader></PlaceAuctionBidHeader>عنوان المزايدة في المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Domain ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (XML format)
<PlaceAuctionBidResponse>
<PlaceAuctionBidHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</PlaceAuctionBidHeader>
</PlaceAuctionBidResponse>
طلب (تنسيق csv)
https://api.dynadot.com/api3.html?key=mykey&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
الاستجابة
ok,success
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=place_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (JSON format){
"status": "success",
"auction_details": {
"auction_json": {
"auction_id": 12,
"domain": "example.com",
"utf_name": "example.com",
"is_idn": false,
"auction_type": "expired",
"current_bid_price": "44.99",
"accepted_bid_price": "45.99",
"currency": "USD",
"is_high_bidder": true,
"bids": 3,
"bidders": 2,
"time_left": "2 days, 22 hours",
"start_time": "2022/03/29 02:20 PST",
"start_time_stamp": 1648545634049,
"end_time": "2022/04/05 02:20 PST",
"end_time_stamp": 1649150434049,
"revenue": "$26.50",
"visitors": 245,
"links": "-",
"age": 0,
"dyna_appraisal": "-",
"auction_ended": false,
"customer_bided": true,
"customer_bid": "44.99",
"customer_proxy_bid": "$121.00"
},
"bid_history": [
{
"bidder_name": "You",
"bid_price": "44.99",
"currency": "USD",
"timestamp": 1648892255084,
"bid_status": "High Bidder",
"is_proxy_auto_bid": false
}
... ]
}
}
أمر الحصول على المزادات المغلقة
تسفر عملية استدعاء أمر الحصول على المزادات المغلقة عن قائمة بالمزادات المغلقة للحساب المحدد. إذا تم استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
طلب الحصول على معلمات المزادات المغلقةالشرح
طلب الحصول على معلمات المزادات المغلقة
الشرح
start_dateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
end_dateتاريخ انتهاء المزاد، yyyy-mm-dd، مثل 2015-05-05
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetClosedAuctionsResponse></GetClosedAuctionsResponse>علامة استجابة الدخول للمزادات المغلقة، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetClosedAuctionsHeader></GetClosedAuctionsHeader>احصل على عنوان المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetClosedAuctionsContent></GetClosedAuctionsContent>علامة محتوى المزادات المغلقة، تُستخدم فقط عندما يكون الحالة هي "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم المجال المعروض للمزاد
<AuctionStatusId></AuctionStatusId>حالة معرّف المزاد، '0' للجاري، و'1' للإغلاق بواسطة المستخدم، و'2' للإغلاق بواسطة الإدارة، و'3' للإغلاق بواسطة التجديد، و'4' للإغلاق بواسطة انتهاء الوقت، و'5' للإغلاق بواسطة ال انتقال بعيدًا.
<AuctionStatus></AuctionStatus>حالة المزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<AuctionWonStatus></AuctionWonStatus>إذا فاز المستخدم في هذا المزاد
<YourHighBid></YourHighBid>عرضك المرتفع لهذا المزاد
<YourProxyBid></YourProxyBid>عرضك البديل لهذا المزاد
مثال الحصول على المزادات المغلقة
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedAuctionsResponse>
<GetClosedAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetClosedAuctionsHeader>
<GetClosedAuctionsContent>
<Auction>
<AuctionId>2</AuctionId>
<Domain>testdomain1.test</Domain>
<AuctionStatusId>4</AuctionStatusId>
<AuctionStatus>Closed by Timeout</AuctionStatus>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>89.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
</Auction>
<Auction>
<AuctionId>3</AuctionId>
<Domain>testdomain2.test</Domain>
<AuctionStatusId>4</AuctionStatusId>
<AuctionStatus>Closed by Timeout</AuctionStatus>
<BidPrice>28.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>28.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
</Auction>
</GetClosedAuctionsContent>
</GetClosedAuctionsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (JSON format){
"GetClosedAuctionsResponse": {
"ResponseCode": 0,
"Status": "success",
"Auctions": [
{
"AuctionId": "2",
"Domain": "testdomain1.test",
"AuctionStatusId": "4",
"AuctionStatus": "Closed by Timeout",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"AuctionWonStatus": "won",
"YourHighBid": "89.99",
"YourProxyBid": "1000.0"
},
{
"AuctionId": "3",
"Domain": "testdomain2.test",
"AuctionStatusId": "4",
"AuctionStatus": "Closed by Timeout",
"BidPrice": "28.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"AuctionWonStatus": "won",
"YourHighBid": "28.99",
"YourProxyBid": "1000.0"
}
]
}
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (تنسيق CSV)ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
الحصول على أوامر مزادات الطلبات المفتوحة المعلقة(مهجور، يُرجى استخدام أمر get_open_auctions)
استدعاء أمر الحصول على مزادات الطلبات المعلقة المفتوحة سيعيد قائمة بمزادات الطلبات المعلقة الجارية. عند استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
طلب الحصول على معلمات مزادات الطلب المفتوح المعلقةالشرح
طلب الحصول على معلمات مزادات الطلب المفتوح المعلقة
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetOpenBackorderAuctionsResponse></GetOpenBackorderAuctionsResponse>علامة استجابة مزادات الطلب المسبق المفتوحة، إنها العقدة الجذرية لمستند الاستجابة XML
<GetOpenBackorderAuctionsHeader></GetOpenBackorderAuctionsHeader>الحصول على رأس مزادات الطلبات المفتوحة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetOpenBackorderAuctionsContent></GetOpenBackorderAuctionsContent>علامة محتوى مزادات الطلبات المسبقة المفتوحة، تُستخدم فقط عندما يكون الوضع "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم المجال المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
Get Open Backorder Auctions ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_open_backorder_auctions¤cy=usd
Response (XML format)
<GetOpenBackorderAuctionsResponse>
<GetOpenBackorderAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetOpenBackorderAuctionsHeader>
<GetOpenBackorderAuctionsContent>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
</Auction>
<Auction>
<AuctionId>0</AuctionId>
<Domain>domain.com</Domain>
<BidPrice>63.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 05:46 UTC</EndTime>
<EndTimestamp>1430199960354</EndTimestamp>
</Auction>
.
.
.
</GetOpenBackorderAuctionsContent>
</GetOpenBackorderAuctionsResponse>
طلب (تنسيق csv)
https://api.dynadot.com/api3.html?key=mykey&command=get_open_backorder_auctions¤cy=usd
الاستجابة
ok,
success,
AuctionId,Domain,BidPrice,BidPriceCurrency,Bids,EndTime,EndTimestamp
10000,backorder0.com,6.35,USD,0,2017/08/29 17:53 UTC,1504029194453
10001,backorder1.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
10002,backorder2.com,1.0,USD,0,2017/08/29 17:53 UTC,1504029194453
.
.
.
أمر الحصول على تفاصيل مزاد الطلبات المسبقة
استدعاء أمر تفاصيل مزاد الطلب المسبق سيعيد تفاصيل المزاد المحدد. هذا الأمر متاح فقط بتنسيق XML و JSON. إذا تم استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
الحصول على تفاصيل طلب المزادالشرح
الحصول على تفاصيل طلب المزاد
الشرح
domainاسم المجال لمزاد الطلب المسبق، الاسم الدولي لل مجال (IDN) يجب أن يستخدم البيونيكود، مثل xn--wkccg.com
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetBackorderAuctionDetailsResponse></GetBackorderAuctionDetailsResponse>تسمية استجابة تفاصيل المزاد، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetAuctionDetailsHeader></GetAuctionDetailsHeader>الحصول على تفاصيل مزاد العنوان
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetAuctionDetailsContent></GetAuctionDetailsContent>علامة الحصول على محتوى تفاصيل المزاد، تُستخدم فقط عندما يكون الحالة "success"
<AuctionStatusId></AuctionStatusId>حالة معرّف المزاد، '0' للجاري، و'1' للإغلاق بواسطة المستخدم، و'2' للإغلاق بواسطة الإدارة، و'3' للإغلاق بواسطة التجديد، و'4' للإغلاق بواسطة انتهاء الوقت، و'5' للإغلاق بواسطة ال انتقال بعيدًا.
<AuctionStatus></AuctionStatus>حالة المزاد
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم المجال المعروض للمزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
<EndTime></EndTime>وقت انتهاء المزاد
<EndTimestamp></EndTimestamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في يناير 1, 1970)
<Revenue></Revenue>إيرادات المزاد
<RevenueCurrency></RevenueCurrency>عملة الإيرادات
<Visitors></Visitors>زوار المجال
<Links></Links>روابط الدومين الواردة
<Age></Age>عمر المجال
<UserIsHighBid></UserIsHighBid>إذا كان المستخدم هو أعلى عرض
<YourCurrentBid></YourCurrentBid>سعر المزايدة الحالي الخاص بك للمزاد المحدد. إذا لم تقم بوضع مزايدة، سيكون '-1'
<YourProxyBid></YourProxyBid>عرضك الافتراضي للمزاد المحدد. إذا لم تكن قد قدمت عرضًا، سيكون {و}
Get Backorder Auction Details ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetBackorderAuctionDetailsResponse>
<GetBackorderAuctionDetailsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetBackorderAuctionDetailsHeader>
<GetBackorderAuctionDetailsContent>
<AuctionStatusId>0</AuctionStatusId>
<AuctionStatus>In Progress</AuctionStatus>
<UserIsHighBid>no</UserIsHighBid>
<YourCurrentBid>-1</YourCurrentBid>
<YourProxyBid>-1</YourProxyBid>
<Auction>
<AuctionId>10001</AuctionId>
<Domain>example.com</Domain>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>0</Bids>
<EndTime>2015/04/28 18:16 UTC</EndTime>
<EndTimestamp>1430244969779</EndTimestamp>
</Auction>
</GetBackorderAuctionDetailsContent>
</GetBackorderAuctionDetailsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_backorder_auction_details&domain=example.com¤cy=usd
Response (JSON format){
"GetBackorderAuctionDetailsResponse": {
"ResponseCode": 0,
"Status": "success",
"GetBackorderAuctionDetails": {
"AuctionStatusId": "0",
"AuctionStatus": "In Progress",
"UserIsHighBid": "no",
"YourCurrentBid": "-1",
"YourProxyBid": "-1",
"Auction": {
"AuctionId": "10001",
"Domain": "example.com",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "0",
"EndTime": "2015/04/28 18:16 UTC",
"EndTimestamp": "1430244969779"
}
}
}
}
أمر المزايدة في مزاد الطلبات الخلفية
استدعاء أمر مزايدة المزاد العكسي سيقوم بوضع مزايدة للمزاد العكسي المحدد. إذا تم استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
طلب معلمة المزايدة في مزاد الطلبات المسبقةالشرح
طلب معلمة المزايدة في مزاد الطلبات المسبقة
الشرح
domainاسم المجال للمزاد، IDN (اسم المجال المعرب) يجب أن يستخدم البونيكود، مثل xn--wkccg.com
bid_amountمقدار عرضك للمزاد، العملة الافتراضية هي الدولار الأمريكي، يمكنك أيضًا تحديدها من خلال معامل العملة أدناه
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<PlaceBakcorderAuctionBidResponse></PlaceBakcorderAuctionBidResponse>علامة رد مزايدة مكان المزاد، إنها العقدة الجذرية لوثيقة الاستجابة XML
<PlaceBackorderAuctionBidHeader></PlaceBackorderAuctionBidHeader>عنوان المزايدة في المزاد
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
Place Backorder Auction Bid ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (XML format)
<PlaceBakcorderAuctionBidResponse>
<PlaceBackorderAuctionBidHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</PlaceBackorderAuctionBidHeader>
</PlaceBakcorderAuctionBidResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (JSON format){
"PlaceBakcorderAuctionBidResponse":{
"ResponseCode":"0",
"Status":"success"
}
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=place_backorder_auction_bid&domain=example.com&bid_amount=99.9¤cy=usd
Response (تنسيق CSV)ok,success
أمر الحصول على مزادات الطلبات المعلقة المغلقة
استدعاء أمر الحصول على مزادات الطلبات المعلقة المغلقة سيعيد قائمة بمزادات الطلبات المعلقة المغلقة للحساب المحدد. عند استدعاء هذا الأمر، يجب تضمين المعايير التالية:
الحصول على معلمة طلب المزادات المغلقة لأوامر الشراء المسبقةالشرح
الحصول على معلمة طلب المزادات المغلقة لأوامر الشراء المسبقة
الشرح
start_dateتاريخ بدء المزاد، yyyy-mm-dd، مثل 2015-05-05
end_dateتاريخ انتهاء المزاد، yyyy-mm-dd، مثل 2015-05-05
currency (اختياري)عملة عرضك السعري يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetClosedBackorderAuctionsResponse></GetClosedBackorderAuctionsResponse>علامة استجابة الدخول للمزادات المغلقة، وهي العقدة الجذرية لوثيقة الاستجابة XML
<GetClosedBackorderAuctionsHeader></GetClosedBackorderAuctionsHeader>احصل على عنوان المزادات المغلقة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetClosedBackorderAuctionsContent></GetClosedBackorderAuctionsContent>علامة محتوى المزادات المغلقة، تُستخدم فقط عندما يكون الحالة هي "success"
<Auction></Auction>علامة عنصر المزاد، تُستخدم فقط عندما يكون الحالة "success"
<YourHighBid></YourHighBid>عرضك المرتفع لهذا المزاد
<YourProxyBid></YourProxyBid>عرضك البديل لهذا المزاد
<AuctionId></AuctionId>معرف المزاد
<Domain></Domain>اسم المجال المعروض للمزاد
<AuctionStatusId></AuctionStatusId>حالة معرّف المزاد، '0' للجاري، و'1' للإغلاق بواسطة المستخدم، و'2' للإغلاق بواسطة الإدارة، و'3' للإغلاق بواسطة التجديد، و'4' للإغلاق بواسطة انتهاء الوقت، و'5' للإغلاق بواسطة ال انتقال بعيدًا.
<AuctionStatus></AuctionStatus>حالة المزاد
<BidPrice></BidPrice>السعر الحالي للمزايدة في المزاد
<BidPriceCurrency></BidPriceCurrency>عملة سعر المزايدة
<Bids></Bids>عدد عروض المزاد
مثال على المزادات المغلقة للطلبات المسبقة
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetClosedBackorderAuctionsResponse>
<GetClosedBackorderAuctionsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetClosedBackorderAuctionsHeader>
<GetClosedBackorderAuctionsContent>
<Auction>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>89.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
<AuctionId>2</AuctionId>
<Domain>testdomain1.test</Domain>
<BidPrice>89.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<EndTime>2022/04/04 02:20:34 PST</EndTime>
<EndTimestamp>1649064034033</EndTimestamp>
</Auction>
<Auction>
<AuctionWonStatus>won</AuctionWonStatus>
<YourHighBid>28.99</YourHighBid>
<YourProxyBid>1000.0</YourProxyBid>
<AuctionId>3</AuctionId>
<Domain>testdomain2.test</Domain>
<BidPrice>28.99</BidPrice>
<BidPriceCurrency>USD</BidPriceCurrency>
<Bids>1</Bids>
<EndTime>2022/04/05 02:20:34 PST</EndTime>
<EndTimestamp>1649150434049</EndTimestamp>
</Auction>
</GetClosedBackorderAuctionsContent>
</GetClosedBackorderAuctionsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (JSON format){
"GetClosedBackorderAuctionsResponse": {
"ResponseCode": 0,
"Status": "success",
"Auctions": [
{
"AuctionWonStatus": "won",
"YourHighBid": "89.99",
"YourProxyBid": "1000.0",
"AuctionId": "2",
"Domain": "testdomain1.test",
"BidPrice": "89.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"EndTime": "2022/04/04 02:20:34 PST",
"EndTimestamp": "1649064034033"
},
{
"AuctionWonStatus": "won",
"YourHighBid": "28.99",
"YourProxyBid": "1000.0",
"AuctionId": "3",
"Domain": "testdomain2.test",
"BidPrice": "28.99",
"BidPriceCurrency": "USD",
"Bids": "1",
"EndTime": "2022/04/05 02:20:34 PST",
"EndTimestamp": "1649150434049"
}
]
}
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=get_closed_backorder_auctions&startDate=2000-01-02&endDate=2015-5-15
Response (تنسيق CSV)ok,success,AuctionId,Domain,AuctionStatusId,AuctionStatus,BidPrice,BidPriceCurrency,Bids,AuctionWonStatus,YourHighBid,YourProxyBid,2,testdomain1.test,4,Closed by Timeout,89.99,USD,1,won,89.99,1000.0,3,testdomain2.test,4,Closed by Timeout,28.99,USD,1,won,28.99,1000.0
احصل على أوامر مجالات إغلاق المنتهية الصلاحية
استدعاء أمر الحصول على مجالات الإغلاق المنتهية سيتيح الحصول على مجالات الإغلاق المنتهية. هذا الأمر متاح فقط بتنسيق XML و JSON. إذا تم استدعاء هذا الأمر، يجب تضمين المعاملات التالية:
طلب معلمة المجالات المنتهية الصلاحية المغلقةالشرح
طلب معلمة المجالات المنتهية الصلاحية المغلقة
الشرح
currency(optional)العملة الخاصة بنتيجة العائد يجب أن تكون دولار أمريكي أو يورو أو يوان صيني، والعملة الافتراضية هي الدولار الأمريكي.
domain(optional)إضافة هذه البارامتر إذا كنت ترغب في الاستعلام عن مجال قريب من الإغلاق
count_per_page (optional)كم عدد الكيانات المعروضة في كل صفحة؟
page_index (optional)أي كيانات الصفحة تريد عرضها?
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetExpiredCloseoutDomainsResponse></GetExpiredCloseoutDomainsResponse>علامة استجابة الحصول على مجالات انتهاء صلاحية قريبة، إنها العقدة الجذرية لمستند الاستجابة XML
<GetExpiredCloseoutDomainsHeader></GetExpiredCloseoutDomainsHeader>الحصول على مجالات الإغلاق المنتهية الصلاحية
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
<GetExpiredCloseoutDomainsContent></GetExpiredCloseoutDomainsContent>وسم المحتوى، يُستخدم فقط عندما يكون الحال هو النجاح
<CloseoutItem></CloseoutItem>عنصر إغلاق
<DomainName></DomainName>اسم المجال
<DomainNameUtf></DomainNameUtf>اسم المجال بتنسيق utf
<CurrentPrice></CurrentPrice>السعر الحالي
<isIdn></isIdn>سواء كان الاسم المجال بنظام الاسم الدولي
<EndTimeStamp></EndTimeStamp>تاريخ انتهاء المزاد بتوقيت يونكس (بالمللي ثانية منذ منتصف الليل بتوقيت UTC في 1 يناير 1970)
<RenewalPrice></RenewalPrice>سعر التجديد
<ExpiredRevenue></ExpiredRevenue>إيرادات التصفية
<DynaAppraisal></DynaAppraisal>تقييم دينا
<InboundLinks></InboundLinks>روابط الدومين الواردة
<MonthlyVisitors></MonthlyVisitors>زوار المجال
<Currency></Currency>عملة
Get Expired Closeout Domains ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetExpiredCloseoutDomainsResponse>
<GetExpiredCloseoutDomainsHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetExpiredCloseoutDomainsHeader>
<GetExpiredCloseoutDomainsContent>
<CloseoutItem>
<DomainName>test.biz</DomainName>
<DomainNameUtf>test.biz</DomainNameUtf>
<CurrentPrice>9.91</CurrentPrice>
<IsIDN>false</IsIDN>
<EndTimeStamp>0</EndTimeStamp>
<RenewalPrice>9.99</RenewalPrice>
<ExpiredRevenue>9.90</ExpiredRevenue>
<EstibotAppraisal>1223</EstibotAppraisal>
<InboundLinks>-1</InboundLinks>
<MonthlyVisitors>-1</MonthlyVisitors>
<Currency>usd</Currency>
</CloseoutItem>
</GetExpiredCloseoutDomainsContent>
</GetExpiredCloseoutDomainsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_expired_closeout_domains¤cy=usd
Response (JSON format){
"GetExpiredCloseoutDomainsResponse": {
"ResponseCode": 0,
"Status": "success",
"Size": 1,
"CloseoutDomains": [
{
"closeoutItem": {
"domainName": "test.biz",
"domainNameUtf": "test.biz",
"currentPrice": "9.91",
"isIdn": false,
"endTimeStamp": 0,
"renewalPrice": "9.99",
"expiredRevenue": "9.90",
"estibotAppraisal": "1223",
"inboundLinks": -1,
"monthlyVisitors": -1,
"currency": "usd"
}
}
]
}
}
شراء أمر مجال منتهي الصلاحية المغلق
استدعاء أمر شراء المجال المنتهي الصلاحية سيقوم بشراء اسم المجال المحدد. هذا الأمر متاح فقط بصيغتي XML و JSON. عند استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
شراء طلب معاملة مجال منتهي الصلاحيةالشرح
شراء طلب معاملة مجال منتهي الصلاحية
الشرح
domain المجال الذي ترغب في شرائه، يمكن إدخال مجال واحد فقط لكل طلب
currency(optional)العملة الخاصة بنتيجة العائد يجب أن تكون دولار أمريكي أو يورو أو يوان صيني، والعملة الافتراضية هي الدولار الأمريكي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<BuyExpiredCloseoutDomainResponse></BuyExpiredCloseoutDomainResponse>تصنيف استجابة شراء مجال مغلق منتهي الصلاحية، إنه العقدة الجذرية لوثيقة الاستجابة XML
<BuyExpiredCloseoutDomainHeader></BuyExpiredCloseoutDomainHeader>شراء مجال منتهي الصلاحية المغلق
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Buy Expired Closeout Domain ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BuyExpiredCloseoutDomainResponse>
<BuyExpiredCloseoutDomainHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</BuyExpiredCloseoutDomainHeader>
</BuyExpiredCloseoutDomainResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=buy_expired_closeout_domain¤cy=USD&domain=domain.com
Response (JSON format){
"BuyExpiredCloseoutDomainResponse": {
"ResponseCode": "0",
"Status": "success"
}
}
أمر الحصول على القوائم
إذا تم استدعاء أمر الحصول على القوائم، يجب تضمين المعايير التالية:
الحصول على معايير طلب القوائمالشرح
الحصول على معايير طلب القوائم
الشرح
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
exclude_pending_sale (اختياري)إذا كنت لا تريد الحصول على قوائم الإقفال المعلقة للبيع، فيجب أن يكون "yes", الافتراضي هو "no"
show_other_registrar (اختياري)إذا كنت ترغب في الحصول على قوائم مسجلين آخرين، ينبغي أن يكون "yes", الافتراضي هو "no"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetListingsResponse></GetListingsResponse>جذر العقدة لمستند XML الاستجابة
<GetListingsHeader></GetListingsHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetListingsContent></GetListingsContent>محتوى القائمة
<Listing></Listing>محتوى عنصر القائمة
<ListingId></ListingId>رقم القائمة
<Domain></Domain>اسم المجال
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر
Get Listings ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]¤cy=usd&command=get_listings
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsResponse>
<GetListingsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetListingsHeader>
<GetListingsContent>
<Listing>
<ListingId>id1</ListingId>
<Domain>domain_name1</Domain>
<Price>1</Price>
<InboundLinks>1</InboundLinks>
<Age>1</Age>
<PendingSaleLocked>No</PendingSaleLocked>
</Listing>
<Listing>
<ListingId>id2</ListingId>
<Domain>domain_name2</Domain>
<Price>2</Price>
<InboundLinks>2</InboundLinks>
<Age>2</Age>
<PendingSaleLocked>No</PendingSaleLocked>
</Listing>
</GetListingsContent>
</GetListingsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]¤cy=usd&command=get_listings
Response (JSON format){
"GetListingsResponse": {
"ResponseCode": 0,
"Status": "success",
"Listing": [
{
"ListingId": "id1",
"Domain": "domain_name1",
"Price": "1",
"InboundLinks": "1",
"Age": "1",
"PendingSaleLocked": "No"
},
{
"ListingId": "id2",
"Domain": "domain_name2",
"Price": "2",
"InboundLinks": "2",
"Age": "2",
"PendingSaleLocked": "No"
}
]
}
}
أمر الحصول على عنصر القائمة
إذا كنت تستدعي أمر الحصول على قائمة العناصر، يجب تضمين البارامترات التالية:
الحصول على بارامتر طلب عنصر القائمةالشرح
الحصول على بارامتر طلب عنصر القائمة
الشرح
domainاسم المجال الذي ترغب في الحصول على تفاصيله، يمكن إدخال مجال 1 فقط لكل طلب
currency (اختياري)عملة نتيجة العائد يجب أن تكون "usd", "eur", أو "cny",، العملة الافتراضية هي الدولار الأمريكي
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<GetListingItemResponse></GetListingItemResponse>جذر العقدة لمستند XML الاستجابة
<GetListingItemHeader></GetListingItemHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<GetListingsItemContent></GetListingsItemContent>محتوى القائمة
<Listing></Listing>محتوى عنصر القائمة
<ListingId></ListingId>رقم القائمة
<Domain></Domain>اسم المجال
<Price></Price>السعر
<InBoundLinks></InBoundLinks>عدد الروابط الواردة
<Age></Age>العمر
Get Listing Item ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=get_listing_item¤cy=usd&domain=domain_name
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetListingsItemResponse>
<GetListingsItemHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</GetListingsItemHeader>
<GetListingsItemContent>
<Listing>
<ListingId>id</ListingId>
<Domain>domain_name</Domain>
<Price>0</Price>
<InboundLinks>0</InboundLinks>
<Age>0</Age>
<PendingSaleLocked>No</PendingSaleLocked>
</Listing>
</GetListingsItemContent>
</GetListingsItemResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=get_listing_item¤cy=usd&domain=domain_name
Response (JSON format){
"GetListingsItemResponse": {
"ResponseCode": 0,
"Status": "success",
"Listing": {
"ListingId": "id",
"Domain": "domain_name",
"Price": "0",
"InboundLinks": "0",
"Age": "0",
"PendingSaleLocked": "No"
}
}
}
أمر الشراء الفوري
إذا كنت تستخدم أمر الشراء الفوري، يجب تضمين البارامترات التالية:
طلب شراء الآنالشرح
طلب شراء الآن
الشرح
domain المجال الذي ترغب في شرائه، يمكن إدخال مجال 1 واحد فقط لكل طلب
currency (اختياري)عملة نتيجة العائد، يجب أن تكون "usd", "eur", أو "cny", إذا لم يتم إدخال عملة، سيتم تطبيق عملة الحساب الافتراضية.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<BuyItNowResponse></BuyItNowResponse>جذر العقدة لمستند XML الاستجابة
<BuyItNowHeader></BuyItNowHeader>رأس الاستجابة
<SuccessCode></SuccessCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ عن الطلب، تُستخدم فقط عندما يكون الحالة هي "error"
<Message></Message>يجب أن يُنشأ طلب المجال فقط عندما يكون الحالة ناجحة.
اشترِه الآن كمثال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=buy_it_now&domain=domain¤cy=currency
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<BuyItNowResponse>
<BuyItNowHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</BuyItNowHeader>
</BuyItNowResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=buy_it_now&domain=domain¤cy=currency
Response (JSON format){
"BuyItNowResponse": {
"ResponseCode": 0,
"Status": "success"
}
}
أمر تحديد البيع
هذا الأمر يدعم التعدد الخيوط.
استدعاء أمر تعيين للبيع سيقوم بإدراج مجالك للبيع في سوق المجالات. هذا الأمر متاح فقط بصيغة XML و JSON. إذا تم استدعاء هذا الأمر، يجب تضمين المعايير التالية:
تعيين معلمات طلب البيعالشرح
تعيين معلمات طلب البيع
الشرح
domains المجال الذي ترغب في إدراجه للبيع في سوق المجالات، يمكن إدخال مجال واحد فقط لكل طلب
for_sale_typeيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك:
> سوق:
قم بإدراج مجالك للبيع في سوق المجالات. سيتم تعيين قوائم المجالات الجديدة إلى الفئة والفئة الفرعية والسعر المدخل أدناه. إذا تم تحديد سعر فعلي، سيكون المجال متاحًا للشراء الفوري ويتم دفعه إلى المشتري.
لمزيد من المعلومات حول عملية بيع المجال >
> غير معروض للبيع:
إلغاء الإدراج
listing_type (optional)يمكنك اختيار قيمة من القائمة التالية لتمثيل نوع مبيعاتك من خلال السوق (يجب تحديده إذا كان نوع البيع المطروح هو السوق):
> شراء الآن
تحديد سعر ثابت سيجعل المجال متاحًا للشراء الفوري ويدفعه إلى المشتري.
ملاحظة: بالنسبة لل مجال في فترة السماح بالإضافة، إذا تمت عملية بيع، فقد لا يتم حذف السماح بها بعد ذلك. لمزيد من المعلومات عن حذف السماح
> تقديم عرض
يمكنك اختيار تحديد سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ للعرض.
ملاحظة: بالنسبة لل مجال في فترة السماح بالإضافة، إذا تمت عملية بيع، فقد لا يتم حذف السماح بها بعد ذلك. لمزيد من المعلومات عن حذف السماح
> شراء الآن وتقديم عرض
تحديد سعر ثابت سيضع المجال متاحًا للشراء الفوري ويدفعه إلى المشتري.
يمكنك اختيار تحديد سعر عرض أدنى أو تركه فارغًا للسماح بأي مبلغ للعرض.
ملاحظة: بالنسبة لل مجال في فترة السماح بالإضافة، إذا تمت عملية بيع، فقد لا يتم حذف السماح بها بعد ذلك. لمزيد من المعلومات عن حذف السماح
price (optional)السعر الذي ترغب في بيع مجالك به (إلزامي إذا كان نوع البيع هو السوق)
minimum_offer (optional)العرض الأدنى الذي ستقبله مقابل مجالك. (مطلوب في حال كان نوع البيع هو السوق)
installment (optional)هل يُسمح بالدفع بالتقسيط؟ إذا كنت تريد تفعيل الدفع بالتقسيط، قم بضبطه على نعم.
maximum_installments (optional)الحد الأقصى لعدد الأقساط المسموح به يستخدم فقط عندما تكون الأقساط صحيحة
يمكنك اختيار قيمة من 2 إلى 12 لتمثيل الحد الأقصى للأشهر لدفع الأقساط
category (optional)اختر فئة ل مجالك، يمكنك الرجوع إلى جدول مقارنة الفئات والفئات الفرعية أدناه للتعبئة الاختيارية.
Sub-category (optional)اختر تصنيفاً فرعياً ل مجالك، يمكنك الرجوع إلى جدول مقارنة التصنيف والتصنيف الفرعي أدناه للإختيار. لاحظ: يجب أن تكون قيمة المعامل الخاص بك هي الرقم المقابل للتصنيف الفرعي.
Description (optional)وصف مجالك
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetForSaleResponse></SetForSaleResponse>عقدة الجذر للاستجابة
<SetForSaleHeader></SetForSaleHeader>ترويسة مجموعة للبيع
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
مجموعة للبيع كمثال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetForSaleResponse>
<SetForSaleHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</SetForSaleHeader>
</SetForSaleResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=set_for_sale&domains=test.com&for_sale_type=marketplace&listing_type=buy_now&price=1000&installment=Yes&category=health&sub_category=fitness&maximum_installments=4&for_sale_type=marketplace&description=testdescription
Response (JSON format){
"SetForSaleResponse": {
"ResponseCode: ": "0",
"Status": "Success"
}
}
تعيين أمر تأكيد Afternic
يؤدي استدعاء أمر تأكيد تعيين Afternic إلى تحديد الموافقة أو عدم الموافقة على ال انتقال السريع في Afternic. هذا الأمر متوفر فقط بصيغة XML و JSON. عند استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
تعيين معلمة طلب تأكيد إجراء في أفترنيكالشرح
تعيين معلمة طلب تأكيد إجراء في أفترنيك
الشرح
domain المجال الذي ترغب في تعيينه يؤكد Afternic إجراء ال انتقال السريع، ولا يمكن إدخال سوى مجال واحد لكل طلب.
actionالإجراء الذي تريد تعيينه بعد التأكيد من أفترنيك يجب أن يكون "confirm_afternic"، أو "delete_from_afternic".
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetAfternicConfirmActionResponse></SetAfternicConfirmActionResponse>علامة تعيين تأكيد الإجراء في Afternic، هي العقدة الجذرية لوثيقة الرد XML
<SetAfternicConfirmActionHeader></SetAfternicConfirmActionHeader>تعيين رأس تأكيد الإجراء في Afternic
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Set Afternic Confirm Action ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetAfternicConfirmActionResponse>
<SetAfternicConfirmActionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetAfternicConfirmActionHeader>
</SetAfternicConfirmActionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_afternic_confirm_action&domain=domain.com&action=confirm_afternic
Response (JSON format){
"SetAfternicConfirmActionResponse": {
"ResponseCode": "0",
"Status": "success"
}
}
تعيين أمر تأكيد سيدو
استدعاء أمر تأكيد الإعداد في سيدو سيعين المجال للموافقة أو عدم الموافقة على التحويل السريع في سيدو. هذا الأمر متاح فقط بصيغة XML و JSON. إذا تم استدعاء هذا الأمر، يجب أن تشمل البارامترات التالية:
تعيين معامل طلب تأكيد العمل في سيدوالشرح
تعيين معامل طلب تأكيد العمل في سيدو
الشرح
domain المجال الذي ترغ بتعيينه يتطلب من Sedo تأكيد إجراء التحويل السريع، يمكن إدخال مجال واحد فقط لكل طلب
actionالإجراء الذي تريد تعيينه يجب أن يتطابق مع تأكيد سيدو، ويجب أن يكون "confirm_sedo"، أو "delete_from_sedo"
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<SetSedoConfirmActionResponse></SetSedoConfirmActionResponse>علامة تأكيد إجراء تعيين سيدو، إنها العقدة الجذرية لمستند الاستجابة XML
<SetSedoConfirmActionHeader></SetSedoConfirmActionHeader>تعيين رأس تأكيد العمل لدى Sedo
<ResponseCode></ResponseCode>إذا كانت العملية ناجحة، "0" للنجاح، "-1" للفشل
<Status></Status>حالة الطلب
<Error></Error>معلومات الخطأ حول الطلب، تُستخدم فقط عندما يكون الحال هو "error"
Set Sedo Confirm Action ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<SetSedoConfirmActionResponse>
<SetSedoConfirmActionHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</SetSedoConfirmActionHeader>
</SetSedoConfirmActionResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=set_sedo_confirm_action&domain=domain.com&action=confirm_sedo
Response (JSON format){
"SetSedoConfirmActionResponse": {
"ResponseCode": "0",
"Status": "success"
}
}
أمر قائمة الطلبات
استدعاء أمر قائمة الطلبات سيحصل على قائمة الطلبات. هذا الأمر متاح فقط بصيغة XML و JSON. إذا تم استدعاء هذا الأمر، يجب تضمين البارامترات التالية:
طلب قائمة الطلباتالشرح
طلب قائمة الطلبات
الشرح
search_byيمكنك اختيار قيمة من القائمة التالية لتمثيل نوع بحثك: date_range، domain، order_id
start_dateتاريخ بدء استعلامك بالتنسيق yyyy/MM/dd
end_dateتاريخ انتهاء استعلامك بالصيغة yyyy/MM/dd
payment_methodيمكنك اختيار قيم متعددة من القائمة التالية لتمثيل طريقة الدفع الخاصة بك:
لا يوجد رصيد
رصيد الحساب
بطاقة ائتمان
حوالة مالية
باي بال
موني بوكرز
تحويل بنكي
علي باي
بطاقة ائتمان باي فلو (لا يتم استخدامها بعد الآن)
وي تشات باي
نقود إلكترونية
تحويل بنكي
آبل باي
حساب جاري
بيع
يونيون باي
حساب باي بال
ميركادو باجو
بايونير
ولكن يرجى استخدام الفاصلة لفصل القيم المتعددة، على سبيل المثال: رصيد الحساب، بطاقة ائتمان
نتيجة علامة 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>يحتوي على حالة الطلب
مثال على قائمة الطلبات
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<OrderListResponse>
<OrderListHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</OrderListHeader>
<OrderListContent>
<OrderList>
<Order>
<OrderId>123456</OrderId>
<SubmittedDate>1734800350565</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>1734800350565</SubmittedDate>
<Currency>EUR</Currency>
<PaymentMethod>Paypal</PaymentMethod>
<TotalCost>$100.00</TotalCost>
<TotalPaid>$100.00</TotalPaid>
<Status>Submitted</Status>
</Order>
</OrderList>
</OrderListContent>
</OrderListResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=order_list&search_by=date_range&start_date=2024/01/01&end_date=2024/01/31&payment_method=account_balance,credit_card
Response (JSON format){
"OrderListResponse": {
"ResponseCode": 0,
"Status": "success",
"OrderList": [
{
"OrderId": "123456",
"SubmittedDate": "2024/12/21",
"Currency": "USD",
"PaymentMethod": "Account Balance",
"TotalCost": "$8.00",
"TotalPaid": "$8.00",
"Status": "Problem",
"ItemList": [
{
"ItemType": "Domain Registration",
"Name": "test.com",
"Duration": 1,
"Cost": "2.99",
"Status": "Completed"
},
{
"ItemType": "Domain Renewal",
"Name": "test1.ac",
"Duration": 1,
"Cost": "3.99",
"Status": "Completed"
},
{
"ItemType": "Domain Transfer",
"Name": "test2.de",
"Duration": 1,
"Cost": "4.99",
"Status": "Completed"
},
{
"ItemType": "Domain Registration",
"Name": "test3.gg",
"Duration": 1,
"Cost": "5.99",
"Status": "Completed"
},
{
"ItemType": "Domain Renewal",
"Name": "test4.uk",
"Duration": 1,
"Cost": "6.99",
"Status": "Completed"
},
{
"ItemType": "Domain Transfer",
"Name": "test5.net",
"Duration": 1,
"Cost": "7.99",
"Status": "Completed"
}
]
},
{
"OrderId": "123457",
"SubmittedDate": "2024/12/21",
"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>حالة الطلب (تسوق، تم الإرسال، انتظار الدفع، قيد المعالجة، تم الإنجاز، يوجد مشكلة، تم الحذف، تم الإلغاء)
<ItemTypeName></ItemTypeName>نوع العنصر
<ItemName></ItemName>اسم العنصر
<ItemStatus></ItemStatus>حالة العنصر (مكتمل، ملغى، بمشكلة)
Get Order Status ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=MY_API_KEY&command=get_order_status&order_id=0
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<GetOrderStatusResponse>
<GetOrderStatusHeader>
<ResponseCode>0</ResponseCode>
<Status>success</Status>
</GetOrderStatusHeader>
<GetOrderStatusContent>
<OrderId>0</OrderId>
<OrderStatus>Completed</OrderStatus>
<Item>
<ItemTypeName>domain transfer away</ItemTypeName>
<ItemName>&</ItemName>
<ItemStatus>transfer.com</ItemStatus>
</Item>
<Item>
<ItemTypeName>domain</ItemTypeName>
<ItemName>&</ItemName>
<ItemStatus>register.com</ItemStatus>
</Item>
</GetOrderStatusContent>
</GetOrderStatusResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=MY_API_KEY&command=get_order_status&order_id=0
Response (JSON format){
"GetOrderStatusResponse": {
"ResponseCode": 0,
"Status": "success",
"OrderStatus": {
"OrderId": 0,
"OrderStatus": "Completed",
"ItemList": [
{
"ItemTypeName": "domain transfer away",
"ItemName": "transfer.com",
"ItemStatus": "Completed"
},
{
"ItemTypeName": "domain",
"ItemName": "register.com",
"ItemStatus": "Completed"
}
]
}
}
}
هل تعالج الأمر
استدعاء أمر is_processing سيخبرك ما إذا كان من الآمن تقديم طلب جديد
معالجة معامل الطلبالشرح
معالجة معامل الطلب
الشرح
لا حاجة لأي معامل إضافي.
نتيجة علامة XMLالشرح
نتيجة علامة XML
الشرح
<Response></Response>علامة استجابة جاري المعالجة
<ResponseHeader></ResponseHeader>علامة رأس المعالجة الجارية
<ResponseMsg></ResponseMsg>علامة رسالة استجابة is_processing. يجب أن تكون "yes"(يوجد عملية معالجة في النظام. يجب ألا ترسل طلبًا آخر.) أو "no"(لا توجد أي عملية معالجة لحسابك. يمكنك تقديم طلب جديد بأمان.)
Is-Processing ExampleRequest (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=is_processing
Response (XML format)
<Response>
<ResponseHeader>
<ResponseCode>0</ResponseCode>
<ResponseMsg>yes</ResponseMsg>
</ResponseHeader>
</Response>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=is_processing
Response (JSON format){
"Response":{
"ResponseCode":"0",
"ResponseMsg":"no"
}
}
Request (تنسيق CSV)https://api.dynadot.com/api3.html?key=[API Key]&command=is_processing
Response (تنسيق CSV)ok,yes
أمر عرض القسائم
استدعاء أمر قائمة الكوبونات سيحصل على جميع الكوبونات. هذا الأمر متاح فقط بصيغة 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>تاريخ انتهاء صلاحية القسيمة
قائمة كوبونات المثال
Request (XML format)
https://api.dynadot.com/api3.xml?key=[API Key]&command=list_coupons&coupon_type=renewal
Response (XML format)
<?xml version="1.0" encoding="UTF-8"?>
<ListCouponsResponse>
<ListCouponsHeader>
<SuccessCode>0</SuccessCode>
<Status>success</Status>
</ListCouponsHeader>
<ListCouponsContent>
<Coupons>
<Coupon>
<Code>DOMAINRENEW1</Code>
<Description>Domain Renew Coupon</Description>
<CouponType>Hosting/SSL Coupons</CouponType>
<DiscountType>PERCENTAGE_OFF</DiscountType>
<DiscountInfo>
<Percentage>10%</Percentage>
</DiscountInfo>
<Restriction>
<PriceLevels>Any</PriceLevels>
<IdnRestriction>None</IdnRestriction>
<DomainDurationMin>1</DomainDurationMin>
<DomainDurationMax>1</DomainDurationMax>
<Tlds>
<Tld>.com</Tld>
<Tld>.net</Tld>
<Tld>.org</Tld>
</Tlds>
<Currencies>
<Currency>US Dollar USD ($)</Currency>
</Currencies>
</Restriction>
<StartDate>1476811260000</StartDate>
<EndDate>1483257540000</EndDate>
</Coupon>
</Coupons>
</ListCouponsContent>
</ListCouponsResponse>
Request (JSON format)https://api.dynadot.com/api3.json?key=[API Key]&command=list_coupons&coupon_type=renewal
Response (JSON format){
"ListCouponsResponse": {
"ResponseCode": 0,
"Status": "success",
"Coupons": [
{
"Code": "DOMAINRENEW1",
"Description": "Domain Renew Coupon",
"CouponType": "Hosting/SSL Coupons",
"DiscountType": "PERCENTAGE_OFF",
"DiscountInfo": {
"Percentage": "10%"
},
"Restriction": {
"PriceLevels": "Any",
"IdnRestriction": "None",
"DomainDurationMin": "1",
"DomainDurationMax": "1",
"Tlds": [
".com",
".net",
".org"
],
"Currencies": [
"US Dollar USD ($)"
]
},
"StartDate": "1476811260000",
"EndDate": "1483257540000"
}
]
}
}