API للنطاقات

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

هل تريد المزيد من الميزات؟ اطلع على API المتقدمة للنطاقات!

البدء مع API للنطاقات

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

https://api.dynadot.com/api2.html

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

معلمة الطلب
الشرح
keyمفتاحك للوصول إلى API، يوجد على لوحة التحكم في حسابك
commandالأوامر المدعومة حاليا هي 'search' (بحث) و'register' (تسجيل)

يتم إرسال النطاقات في صورة ملف نصي مقسوم بفواصل. السطر الأول هو نتيجة الأمر. يضم هذا السطر 2 حقول.

حقل النتيجة
الشرح
1نتيجة طلب هذا الـ API :
ok - نجح الأمر
error - لم يكن الأمر ناجحاً
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'

السطر الثاني فارغ. الأسطر التالية هي نتيجة الأمر، كنتائج البحث على سبيل المثال.

أمر البحث

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

معلمة طلب البحث
الشرح
domain0 - domain99Der Domainname, nach dem Sie suchen, reguläres Konto kann 1 Domain pro Befehl angeben, Bulk- und Super-Bulk-Konto können bis zu 100 Domains angeben
language0 - language99 (اختياري)وسم لغة النطاق، لا يستخدم سوى لأسماء النطاقات المدوّلة
show_price (اختياري)إذا ما أردت إظهار السعر بعملة حسابك، قم بضبطه على رقم "1"
currency (اختياري)You can decide the currency type and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on.If you missed this parameter,we will use the account default currency to try to apply payment

سيكون هناك سطر 1 لنتيجة كل نطاق يتم إرساله. سيضم كل سطر 5 حقول.

حقل نتيجة البحث
الشرح
1معلمة النطاق، domain0 على سبيل المثال
2اسم النطاق الذي تم البحث عنه، mydomain.com على سبيل المثال
3اللغة، إن كانت محددة، spa على سبيل المثال
4نتيجة البحث :
yes - النطاق متاح
no - النطاق غير متوفر
offline - السجل المركزي لهذا النطاق غير متصل حالياً
system_busy - جميع الاتصالات مشغولة
error - كان هناك خطأ في بناء الجملة أو خطأ سجل أثناء معالجة هذا النطاق
5مزيد من المعلومات حول النتيجة / السعر، تستخدم فقط عندما تكون النتيجة "خطأ" أو خيار "show_price" ضبط على "1" في الطلب

مثال للبحث

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=search&domain0=mydomain.com&domain1=mydomain.net&show_price=1&currency=USD

الاستجابة

ok, domain0,mydomain.com,,no, domain1,mydomain.net,,yes,10.99 in USD

أمر التسجيل

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

معلمة طلب التسجيل
الشرح
domainاسم النطاق الذي تريد تسجيله، لا يمكن تسجيل أكثر من 1 نطاق/نطاقات في كل طلب
languageوسم اللغة الخاصة بالنطاق المطلوب، غير ضروري سوى في حال كان النطاق مدوّلا
durationعدد السنين التي تود تسجيل النطاق خلالها
option0 ( إذا لزم الأمر )اسم مسجل .BE
option1 ( إذا لزم الأمر )اسم منظمة مسجل .BE (اختياري)
premium (اختياري)Wenn Sie eine Premium-Domain eintragen lassen wollen, setzen Sie sie auf "1" (optional)
currency (اختياري)You can decide the currency type and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on.If you missed this parameter,we will use the account default currency to try to apply payment
coupon (اختياري)The coupon code you want to apply to this command

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 3 حقول.

حقل نتيجة التسجيل
الشرح
1نتيجة طلب التسجيل:
success - تم تسجيل النطاق بنجاح
not_available - النطاق غير متوفر
insufficient_funds - رصيد الحساب لا يكفي لمعالجة هذا التسجيل
offline - السجل المركزي لهذا النطاق غير متصل حالياً
system_busy - جميع الاتصالات مشغولة
error - كان هناك خطأ في بناء الجملة أو خطأ سجل أثناء معالجة هذا الطلب
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'
3تاريخ انتهاء الصلاحية بتوقيت unix (عدد المللي ثانية من منتصف ليل UTC يناير 1، 1970)، يستخدم فقط عندما تكون النتيجة هي "نجاح التسجيل".

مثال للتسجيل

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=register&domain=mydomain.com&duration=1&currency=USD

الاستجابة

ok, success,,1180897681932

أمر الحذف

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

معلمة طلب الحذف
الشرح
domainاسم النطاق الذي تريد حذفه، لا يمكن حذف أكثر من 1 نطاق/نطاقات في كل طلب

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 2 حقول.

حقل نتيجة الحذف
الشرح
1نتيجة طلب الحذف:
success - تم حذف النطاق بنجاح
grace_expired - انتهت فترة السماح مسبقاً
too_soon - لا يمكن حذف نطاق خلال الساعة الأولى بعد التسجيل
offline - السجل المركزي لهذا النطاق غير متصل حاليا
error - كان هناك خطأ في بناء الجملة أو خطأ سجل أثناء معالجة هذا الطلب error - كان هناك خطأ في بناء الجملة أو خطأ سجل أثناء معالجة هذا الطلب
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'

مثال للحذف

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=delete&domain=mydomain.com

الاستجابة

ok, success,

أمر التجديد

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

معلمة طلب التجديد
الشرح
domainاسم النطاق الذي تريد تجديده، لا يمكن تجديد أكثر من 1 نطاق/نطاقات في كل طلب
durationعدد سنوات تجديد النطاق
year (اختياري)سنة انتهاء صلاحية تسجيل النطاق
currency (اختياري)You can decide the currency type and this parameter supported are "USD","CNY", "GBP","EUR","INR","CAD" and so on.If you missed this parameter,we will use the account default currency to try to apply payment

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 3 حقول.

معلمة طلب التجديد
الشرح
1نتيجة طلب التجديد:
success - تم تجديد النطاق بنجاح
insufficient_funds - رصيد الحساب لا يكفي لمعالجة هذا التجديد
offline - السجل المركزي لهذا النطاق غير متصل حاليا
error - كان هناك خطأ في تركيب الجملة أو خطأ سجل أثناء معالجة هذا الطلب
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'
3تاريخ انتهاء الصلاحية بتوقيت unix (عدد المللي ثانية من منتصف ليل UTC يناير 1، 1970)، يستخدم فقط عندما تكون النتيجة هي "نجاح التسجيل".

مثال للتجديد

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=renew&domain=mydomain.com&duration=1&currency=USD

الاستجابة

ok, success,,1180897681932

أمر الحصول على خوادم الأسماء

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

عامل طلب الحصول على خوادم الأسماء
الشرح
domainالنطاق الذي تود الحصول على بيانات خادم الاسم الخاص به، لا يمكن الحصول إلا على بيانات خاصة بعدد 1 اسم نطاق لكل طلب.

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 2 حقول.

حقل نتيجة الحصول على خوادم الأسماء
الشرح
1نتيجة طلب الحصول على خوادم الاسماء:
success - تم إعادة خوادم الاسماء بنجاح
offline - السجل المركزي لهذا النطاق غير متصل حاليا
error - كان هناك خطأ في بناء الجملة أو خطأ في السجل أثناء معالجة هذا الطلب
2المعلومات المفصلة الخاصة بخوادم الأسماء(ns0 - ns12) أو مزيد من المعلومات حول النتيجة في حال كانت 'error'
3مزيد من المعلومات حول تعيين خوادم الأسماء، لا يستخدم سوى عندما تكون النتيجة 'success'

مثال للحصول على خوادم الأسماء

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=get_ns&domain=mydomain.com

الاستجابة

ok, success,ns1.dynadot.com,ns2.dynadot.com,,,,,,,,,,,,Dynadot Forwarding

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

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

معلمة طلب تعيين خوادم الأسماء
الشرح
domainاسم النطاق المطلوب تحديثه، لا يمكن تحديد إلا عدد 1 نطاق لكل طلب
ns0 - ns12خوادم الاسم المطلوب تحديدها ليستخدمها نطاقك، يمكنك تحديد عدد يصل إلى 13 خوادم اسم، ولكن يجب أن يكونوا موجودين في حسابك بالفعل.

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 2 حقول.

تعيين حقل نتائج خوادم الأسماء
الشرح
1نتيجة طلب تعيين خوادم الأسماء :
success - تم تعيين خوادم الاسماء بنجاح
offline - السجل المركزي لهذا النطاق غير متصل حاليا
error - كان هناك خطأ في بناء جملة أو خطأ سجل أثناء معالجة هذا الطلب
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'

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

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_ns&domain=mydomain.com&ns0=ns1.hostns.com&ns1=ns2.hostns.com

الاستجابة

ok, success,

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

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

معلمة طلب تعيين خيارات التجديد
الشرح
domainاسم النطاق المطلوب تحديثه، لا يمكن تحديد إلا عدد 1 نطاق لكل طلب
renew-optionreset - يعيد تعيين خيار تجديد النطاق ليكون "لا يوجد خيار تجديد"
donot - يعين خيار تجديد النطاق ليكون "عدم التجديد"
auto - يعين خيار تجديد النطاق ليكون "التجديد التلقائي"

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 2 حقول.

حقل نتيجة تعيين خيارات التجديد
الشرح
1نتيجة طلب تعيين خيارات التجديد نتيجة تعيين خيارات التجديد المحددة :
success - تم تعيين خيارات التجديد بنجاح
error - كان هناك خطأ في بناء الجملة لمعالجة هذا الطلب
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'

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

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_renew_option&domain=mydomain.com&renew-option=donot

الاستجابة

ok, success,

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

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

معامل طلب تعيين مجلد
الشرح
domainاسم النطاق المطلوب تحديثه، لا يمكن تحديد إلا عدد 1 نطاق لكل طلب
folderاسم المجلد الذي تريد نقل نطاقك إليه
استخدم "Default" كاسم المجلد إذا كنت تريد نقل النطاق إلى المجلد الافتراضي
اسم المجلد حساس لحالة الأحرف، على سبيل المثال، "Folder1" و "folder1" اسمان مختلفان للمجلدات

سيكون هناك سطر 1 لنتيجة كل طلب يتم إرساله. سيضم كل سطر 2 حقول.

معلمة طلب تعيين مجلد
الشرح
1نتيجة طلب تعيين المجلد :
success - تم تعيين المجلد بنجاح
error - كان هناك خطأ في بناء الجملة لمعالجة هذا الطلب
2معلومات إضافية حول النتيجة، لا يستخدم سوى عندما تكون النتيجة 'error'

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

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=set_folder&domain=mydomain.com&folder=folder1

الاستجابة

ok, success,

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

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

معامل طلب Is-Processing
الشرح
لا حاجة لثوابت إضافية

سيكون هناك سطر 1 لنتيجة كل نطاق يتم إرساله. سيضم كل سطر 1 حقول.

حقل نتيجة Is-Processing
الشرح
1نتيجة الطلب is_processing :
yes - هناك طلب قيد المعالجة، في حالة عدم إرسال طلب جديد
no - لا يتم معالجة أي طلب. من الآمن إرسال طلب جديد.

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

الطلب

https://api.dynadot.com/api2.html?key=8S7I2s6Qd8g&command=is_processing

الاستجابة

ok, yes,

اللغات

Afrikaans:afr Chinese:chi Arabic:ara Persian:per Russian:rus Japanese:jpn Spanish:spa Hebrew:heb Korean:kor Bulgarian:bul Chinese-Simplified:zh-cn French:fre Hungarian:hun Turkish:tur Danish:dan Thai:tha German:ger Hindi:hin Greek:gre Icelandic:ice Portuguese:por Swedish:swe Polish:pol Ukrainian:ukr Chinese-Traditional:zh-tw Bosnian:bos Czech:cze Norwegian:nor Finnish:fin Italian:ita Cyrillic:cyrl Belarusian:bel Georgian:geo Vietnamese:vie Latvian:lav Bengali:ben Albanian:alb Romanian:rum Serbian:scc Tamil:tam Panjabi:pan Slovak:slo Armenian:arm Irish:gle Catalan:cat Urdu:urd Slovenian:slv Gujarati:guj Lithuanian:lit Macedonian:mac Khmer:khm Telugu:tel Dutch:dut Kazakh:kaz Malayalam:mal Welsh:wel Tibetan:tib Estonian:est Indic:inc Mongolian:mon Gaelic:gla Bodo:brx Uzbek:uzb Somali:som Javanese:jav Pushto:pus Swahili:swa Aragonese:arg Assamese:asm Sanskrit:san Chechen:che Kirghiz:kir Luxembourgish:ltz Maltese:mlt Kashmiri:kas Yiddish:yid Burmese:bur Nepali:nep Carib:car Coptic:cop Malay:may Syriac:syr Oriya:ori Samoan:smo Asturian:ast Avestan:ave Awadhi:awa Azerbaijani:aze Balinese:ban Baluchi:bal Basa:bas Bashkir:bak Basque:baq Bhojpuri:bho Chuvash:chv Corsican:cos Croatian:scr Divehi:div Dogri:doi Faroese:fao Fijian:fij Frisian:fry Gondi:gon Indonesian:ind Ingush:inh Kurdish:kur Lao:lao Maori:mao Moldavian:mol Ossetian:oss Rajasthani:raj Sardinian:srd Sindhi:snd Sinhalese:sin Tajik:tgk Latin:latn Konkani:knn Maithili:mai Marathi:mar Punjabi:pun Faroese:fao Emoji:zyyy