الأسئلة الشائعة حول NiceNIC Domain API v2
ابحث عن إجابات عملية حول الوصول إلى API، واختبار Sandbox، والمصادقة، والتسعير، وعمليات النطاق، ومعالجة الاستجابات، والتكامل في بيئة الإنتاج.
بدء الاستخدام
ابدأ بالوصول والأسعار وبيانات الاعتماد.
01 ما هي NiceNIC Domain API v2؟
API نطاقات NiceNIC الإصدار 2 هو API يعتمد على HTTPS وJSON لأتمتة إدارة النطاقات من خلال حسابك في NiceNIC.
تدعم سير العمل الأساسي بما في ذلك التحقق من توفر النطاقات، والتسجيل، والتجديد، والتحويل، والاستعلام عن المحفظة، وتحديثات خوادم الأسماء وبيانات الاتصال، والأسعار، وسجلات DNS، وخوادم الأسماء الفرعية، ومعلومات الحساب، والعمليات المتعلقة بالامتثال.
استخدم واجهة API عندما تريد ربط خدمات نطاقات NiceNIC مباشرة بموقع ويب أو منصة استضافة أو نظام فوترة أو أداة داخلية أو أي تطبيق آخر.
02 من يمكنه استخدام NiceNIC Domain API v2؟
يمكن لأي حساب NiceNIC نشط استخدام Domain API v2. يتوفر الوصول إلى API لكل من حسابات السوق وحسابات الموزعين.
لست بحاجة لأن تصبح موزعًا فقط للحصول على الوصول إلى API. لا يزال نوع الحساب مهمًا للأ Pricing: عمليات API المدفوعة تستخدم التسعير المخصص لحساب NiceNIC الذي يرسل الطلب.
03 هل NiceNIC Domain API v2 مجانية؟
نعم، الوصول إلى API مجاني بحد ذاته. لا توجد رسوم منفصلة لتفعيل الوصول إلى API أو لإرسال طلبات API المدعومة.
يتم احتساب العمليات المدفوعة مثل تسجيل النطاقات وتجديدها ونقلها وفقًا لتسعير حسابك والقواعد المطبقة على النطاقات.
04 هل أحتاج إلى حساب موزّع (Reseller Account) لاستخدام API؟
لا. الوصول إلى API وتسعير الموزّعين أمران منفصلان.
يمكنك استخدام Domain API v2 مع حساب NiceNIC Market Account العادي. قم بالترقية إلى حساب موزّع فقط عندما يكون تسعير الموزّعين أو مزايا الموزّعين الأخرى مفيدًا لحجم أعمالك.
05 ما الفرق بين API v2 و NiceNIC API الأقدم؟
يستخدم Domain API v2 بنية NiceNIC API الحالية مع طلبات HTTPS، واستجابات JSON، والمصادقة المستندة إلى الترويسة، ووثائق منظمة حول سير عمل النطاقات والحسابات الفردية.
إذا كنت تحتفظ بتكامل مبني على NiceNIC API أقدم، فراجع معاملات API v2 ومعالجة الاستجابات قبل نقل حركة الإنتاج، ولا تفترض أن الإصدارين قابلان للتبادل.
06 كيف أحصل على بيانات اعتماد API الخاصة بي؟
سجّل الدخول إلى حسابك في NiceNIC وافتح API Settings. تستخدم طلبات API v2 اسم المستخدم الخاص بك في NiceNIC و API Secret للمصادقة.
بيئة الاختبار والمصادقة
اتصل بشكل آمن واختبر قبل الإنتاج.
07 هل توفر NiceNIC Domain API v2 بيئة اختبار (API Sandbox)؟
نعم، توفر NiceNIC بيئة اختبار API للمطورين لاختبار عمليات التكامل قبل ربطها بواجهة API الإنتاجية.
استخدم بيئة الاختبار للتحقق من المصادقة، وتنسيق الطلبات، وتحليل الاستجابات، ومعالجة الأخطاء، وسير عمل تطبيقك قبل تفعيل عمليات النطاق المباشرة للعملاء.
08 ما الفرق بين بيئة الاختبار وواجهة API الإنتاجية؟
بيئة اختبار API مخصصة للتطوير واختبار التكامل، بينما تُستخدم واجهة API الإنتاجية لعمليات النطاق المباشرة والطلبات المدفوعة المرتبطة بحساب NiceNIC الخاص بك.
نوصي بالتحقق من المصادقة، ومعالجة الطلبات، ومعالجة الاستجابات، ومنطق الأخطاء في بيئة الاختبار قبل تفعيل عمليات الإنتاج الموجهة للعملاء.
09 كيف تعمل مصادقة API؟
أرسل طلبات API عبر HTTPS وأدرج اسم المستخدم الخاص بك في NiceNIC وسرّ API في ترويسة Authorization.
Host: api.nicenic.net
Authorization: username:api_secret
Content-Type: application/json
إذا تم تفعيل قيود عنوان IP لحسابك، يجب أن تأتي الطلبات أيضًا من عنوان IP خادم مصرح به.
10 ما نقطة النهاية التي يستخدمها Domain API v2؟
نقطة النهاية الأساسية لـ API الإنتاجي هي:
https://api.nicenic.net/v2/
يتم تحديد إجراءات API باستخدام المعاملات الموثقة لكل نقطة نهاية، مثل category وaction. اتبع دائمًا توثيق نقطة النهاية المخصصة للمعاملات المطلوبة والاختيارية لعملية محددة.
11 ما تنسيق الاستجابة وترميز الأحرف الذي يستخدمه API v2؟
استجابات API v2 تستخدم JSON، ومعاملات الطلب تستخدم UTF-8.
{
"code": 0,
"msg": "success",
"data": {}
}
يجب على تطبيقك فحص code وmsg المُعادين بدلاً من افتراض أن كل استجابة HTTP تمثل عملية نطاق مكتملة.
عمليات النطاقات والتسعير
افهم سير العمل المدعوم وسلوك الشراء.
12 ما الذي يمكنني فعله باستخدام NiceNIC Domain API v2؟
من خلال واجهات برمجة التطبيقات (APIs) الموثقة حاليًا، يمكنك أتمتة سير العمل بما في ذلك فحوصات توفر النطاقات، والتسجيل، والتجديد، والنقل، وإدراج المحفظة وتفاصيل النطاق، وتحديثات خوادم الأسماء وبيانات الاتصال الخاصة بالنطاق، وتسعير النطاقات، وسجلات DNS، وخوادم الأسماء الفرعية، ومعلومات الحساب، ومراقبة إساءة الاستخدام والامتثال.
يتم توثيق سير العمل الإضافية بشكل منفصل في قائمة التنقل الخاصة بـ API.
13 ما الذي يجب أن أختبره قبل تفعيل عمليات التسجيل أو النقل الفعلية؟
ابدأ بعمليات القراءة منخفضة المخاطر مثل التحقق من توفر النطاق، وأسعار النطاقات، ورصيد الحساب، وقائمة النطاقات.
ثم تأكد من المصادقة، وتحليل الاستجابات، ومعالجة الأخطاء، ومعالجة الطلبات المعلقة قبل تفعيل عمليات التسجيل أو التجديد أو النقل الفعلية.
14 هل يمكنني التحقق من عدة نطاقات في طلب API واحد؟
نعم. تدعم نقطة نهاية التحقق من توفر النطاق أسماء نطاقات متعددة مفصولة بفواصل.
example.com,example.net,example.org
لا تفترض أن كل عملية في API تدعم نفس صيغة الإدخال متعدد النطاقات. يجب أن يتبع التسجيل والتجديد والنقل توثيق نقطة النهاية الخاص بكل منها.
15 كيف يمكنني الاستعلام عن أسعار التسجيل والتجديد والنقل؟
استخدم نقطة نهاية Get Domain Pricing. تتضمن أنواع التسعير الموثقة register وrenew وtransfer وall.
يمكن أن تتضمن استجابات التسجيل أيضًا قيمة is_premium تشير إلى ما إذا كان التسجيل المطلوب مميزًا.
نظرًا لأن طلبات API تستخدم تسعيرًا على مستوى الحساب، فاستعلم عن الأسعار الحالية قبل إرسال طلبات العملاء المدفوعة بدلاً من الاعتماد على الأسعار المخزنة مؤقتًا لفترة غير محدودة.
16 هل يمكن تسجيل أو تجديد كل نطاق TLD لمدة 1-10 سنوات؟
لا. على الرغم من أن توثيق API يدعم فترات تصل إلى 1-10 سنوات للنطاقات المؤهلة، إلا أن نطاقات TLD الفردية قد يكون لها قواعد سجل مختلفة.
يمكن أن تختلف فترات التسجيل وفترات التجديد وأهلية النقل ومتطلبات جهات الاتصال ومتطلبات التحقق حسب الامتداد. يجب أن يتبع تطبيقك القواعد الحالية لنطاق TLD المعني.
17 ما الفرق بين خوادم الأسماء وسجلات DNS وخوادم الأسماء الفرعية؟
ns1.example.com.هذه عمليات منفصلة ولا ينبغي التعامل معها كبدائل قابلة للتبديل.
الاستجابات والأخطاء
تعامل بشكل صحيح مع حالات النجاح والحالات المعلقة والفشل.
18 ماذا تعني رموز استجابة API؟
| الكود | المعنى |
|---|---|
0 | نجاح |
201 | قيد الانتظار |
400 | خطأ في المعامل |
401 | غير مصرح به |
404 | لا توجد سجلات ذات صلة |
500 | خطأ داخلي في الخادم |
عند تحديد حالة طلب API، استخدم دائمًا الرمز والرسالة المُعاد إرجاعهما.
19 ماذا يعني الرمز 201؟
استجابة 201 تعني أن العملية قد تم قبولها للمعالجة ولكنها لم تصل بالضرورة إلى حالتها النهائية.
20 ماذا يحدث عندما يُرجع تسجيل نطاق الرمز 201؟
بالنسبة لتسجيل النطاق، تشير استجابة 201 إلى أنه تم إرسال الطلب وهو بانتظار المعالجة النهائية من السجل.
لا تخبر العميل النهائي بأن النطاق نشط حتى يؤكد نظامك النتيجة النهائية. اتبع توثيق نقطة نهاية التسجيل للحصول على أحدث قواعد معالجة الطلبات المعلقة واسترداد الأموال.
21 ماذا تعني استجابة النقل المعلق؟
النقل المعلق يعني أن طلب النقل قد تم قبوله للمعالجة، وليس أن النطاق قد أكمل نقله إلى NiceNIC بالفعل.
قد يعتمد اكتمال النقل على معالجة السجل والسجل المسجل بالإضافة إلى حالة النقل الحالية للنطاق. أبقِ النقل في حالة معلقة حتى يتم تأكيد الاكتمال.
المحفظة والامتثال والتكامل
إدارة المحافظ وربط الأنظمة الحالية.
22 هل يمكنني استرجاع وتصفية محفظة النطاقات الخاصة بي عبر API؟
نعم. يدعم API قائمة النطاقات استرجاع المحفظة مع خيارات الترقيم الصفحي والفرز والتصفية.
استخدم الحصول على تفاصيل النطاق عندما تحتاج إلى معلومات مفصلة عن نطاق فردي، مثل معلومات التسجيل، ومعلومات الانتهاء، وخوادم الأسماء، وبيانات جهات اتصال النطاق.
23 ما الذي يمكن أن يقدمه API لإساءة الاستخدام والامتثال؟
يتضمن NiceNIC Domain API v2 عمليات إساءة الاستخدام والامتثال المصممة للمنصات والموزعين الذين يديرون محافظ نطاقات العملاء.
يمكنك تحديد النطاقات المرتبطة بتقارير إساءة الاستخدام واسترجاع معلومات امتثال قابلة للقراءة آليًا للنطاقات الفردية. اعتمادًا على الحالة، قد يتضمن الرد حالة النطاق، والتأثير الحالي، والإجراء الموصى به، ومعلومات الإيقاف، ومعلومات الشكوى، وعناوين URL المُبلَّغ عنها.
هذا يجعل من الممكن إظهار حالة الامتثال مباشرة داخل بوابة العملاء أو النظام التشغيلي الخاص بك.
24 هل يمكنني استخدام NiceNIC Domain API v2 مع WHMCS؟
نعم. توفر NiceNIC تكاملًا مسجِّلًا مع WHMCS للشركات التي تستخدم بالفعل WHMCS للفوترة والتزويد.
استخدم Domain API v2 المباشر عند بناء تطبيقك أو سير العمل الخاص بك. استخدم تكامل WHMCS عندما تريد دمج عمليات النطاق في بيئة WHMCS موجودة.
التطوير والدعم
ابنِ بأمان واعرف ما يجب إرساله عندما تحتاج إلى مساعدة.
25 ما هي لغات البرمجة التي يمكنني استخدامها؟
يمكن لأي لغة برمجة أو بيئة تشغيل من جانب الخادم قادرة على إرسال طلبات HTTPS وتحليل JSON التكامل مع Domain API v2.
تشمل الخيارات الشائعة PHP وPython وNode.js وJava. احتفظ ببيانات اعتماد API على جانب الخادم ولا تكشف أبدًا عن API Secret الخاص بك في JavaScript من جانب المتصفح أو في رمز عميل قابل للتنزيل.
26 هل توجد حدود لمعدل استخدام API؟
قد يتم تطبيق تحديد معدل الاستخدام لحماية استقرار API وأمان المنصة.
إذا كان من المتوقع أن يولد تكامل الإنتاج لديك حجم طلبات مرتفعًا ومستمرًا، فاتصل بـ NiceNIC قبل الإطلاق لمراجعة نمط الاستخدام المتوقع.
27 ما الذي يجب أن أدرجه عند الاتصال بالدعم بخصوص مشكلة في API؟
قم بتضمين الطابع الزمني للطلب، وفئة API والإجراء، واسم النطاق عند الاقتضاء، ومعاملات الطلب غير الحساسة، ورمز الاستجابة والرسالة المرتجعة، وما إذا كان الطلب قد جاء من Sandbox أو Production.
28 أين يمكنني العثور على معاملات الطلب الكاملة وأمثلة التعليمات البرمجية؟
استخدم تنقل API في الوثائق. تحتوي كل عملية على صفحة خاصة بها للمعاملات المدعومة وأمثلة الطلبات وأمثلة الاستجابات والسلوك الخاص بالعملية.
يشرح قسم الأسئلة الشائعة السلوك العام لواجهة برمجة التطبيقات (API)؛ ويجب اعتبار توثيق كل نقطة نهاية على حدة المصدر الموثوق لتنسيق الطلب الدقيق.
هل أنت مستعد لبدء البناء؟
اختبر تكاملك في بيئة اختبار API، ثم اربط حسابك في NiceNIC عندما تكون مستعدًا للانتقال إلى الإنتاج.
هل تحتاج إلى أسعار الموزعين لحجم نطاقات أعلى؟
قارن خطط الموزّعين ←






