الأسئلة الشائعة حول API

الأسئلة الشائعة حول NiceNIC Domain API v2

ابحث عن إجابات عملية حول الوصول إلى API، واختبار Sandbox، والمصادقة، والتسعير، وعمليات النطاق، ومعالجة الاستجابات، والتكامل في بيئة الإنتاج.

يتوفر 28 سؤالاً

بدء الاستخدام

ابدأ بالوصول والأسعار وبيانات الاعتماد.

6 أسئلة
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 الذي يرسل الطلب.

افتح إعدادات API ←

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 للمصادقة.

نصيحة أمنية: احتفظ بـ API Secret على جانب الخادم. لا تَكشف عنه في JavaScript من جانب المتصفح، أو المستودعات العامة، أو تطبيقات العملاء، أو أي مواقع أخرى متاحة للعموم.

افتح إعدادات API ←

بيئة الاختبار والمصادقة

اتصل بشكل آمن واختبر قبل الإنتاج.

5 أسئلة
07 هل توفر NiceNIC Domain API v2 بيئة اختبار (API Sandbox)؟

نعم، توفر NiceNIC بيئة اختبار API للمطورين لاختبار عمليات التكامل قبل ربطها بواجهة 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 خادم مصرح به.

اقرأ توثيق المصادقة عبر API ←

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 تمثل عملية نطاق مكتملة.

عمليات النطاقات والتسعير

افهم سير العمل المدعوم وسلوك الشراء.

6 أسئلة
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 وخوادم الأسماء الفرعية؟
خوادم الأسماءتحدد المكان الذي يتم فيه تفويض DNS الموثوق للنطاق.
سجلات DNSتدير السجلات داخل منطقة DNS عند استخدام خدمات DNS من NiceNIC.
خوادم الأسماء الفرعيةتنشئ سجلات مضيف/ربط مثل ns1.example.com.

هذه عمليات منفصلة ولا ينبغي التعامل معها كبدائل قابلة للتبديل.

الاستجابات والأخطاء

تعامل بشكل صحيح مع حالات النجاح والحالات المعلقة والفشل.

4 أسئلة
18 ماذا تعني رموز استجابة API؟
الكودالمعنى
0نجاح
201قيد الانتظار
400خطأ في المعامل
401غير مصرح به
404لا توجد سجلات ذات صلة
500خطأ داخلي في الخادم

عند تحديد حالة طلب API، استخدم دائمًا الرمز والرسالة المُعاد إرجاعهما.

عرض رموز استجابة API ←

19 ماذا يعني الرمز 201؟

استجابة 201 تعني أن العملية قد تم قبولها للمعالجة ولكنها لم تصل بالضرورة إلى حالتها النهائية.

مهم: لا تتعامل مع الاستجابة المعلقة على أنها نجاح نهائي. حافظ على الحالة المعلقة حتى يتم تأكيد النتيجة النهائية لعملية النطاق.
20 ماذا يحدث عندما يُرجع تسجيل نطاق الرمز 201؟

بالنسبة لتسجيل النطاق، تشير استجابة 201 إلى أنه تم إرسال الطلب وهو بانتظار المعالجة النهائية من السجل.

لا تخبر العميل النهائي بأن النطاق نشط حتى يؤكد نظامك النتيجة النهائية. اتبع توثيق نقطة نهاية التسجيل للحصول على أحدث قواعد معالجة الطلبات المعلقة واسترداد الأموال.

21 ماذا تعني استجابة النقل المعلق؟

النقل المعلق يعني أن طلب النقل قد تم قبوله للمعالجة، وليس أن النطاق قد أكمل نقله إلى NiceNIC بالفعل.

قد يعتمد اكتمال النقل على معالجة السجل والسجل المسجل بالإضافة إلى حالة النقل الحالية للنطاق. أبقِ النقل في حالة معلقة حتى يتم تأكيد الاكتمال.

المحفظة والامتثال والتكامل

إدارة المحافظ وربط الأنظمة الحالية.

3 أسئلة
22 هل يمكنني استرجاع وتصفية محفظة النطاقات الخاصة بي عبر API؟

نعم. يدعم API قائمة النطاقات استرجاع المحفظة مع خيارات الترقيم الصفحي والفرز والتصفية.

استخدم الحصول على تفاصيل النطاق عندما تحتاج إلى معلومات مفصلة عن نطاق فردي، مثل معلومات التسجيل، ومعلومات الانتهاء، وخوادم الأسماء، وبيانات جهات اتصال النطاق.

23 ما الذي يمكن أن يقدمه API لإساءة الاستخدام والامتثال؟

يتضمن NiceNIC Domain API v2 عمليات إساءة الاستخدام والامتثال المصممة للمنصات والموزعين الذين يديرون محافظ نطاقات العملاء.

يمكنك تحديد النطاقات المرتبطة بتقارير إساءة الاستخدام واسترجاع معلومات امتثال قابلة للقراءة آليًا للنطاقات الفردية. اعتمادًا على الحالة، قد يتضمن الرد حالة النطاق، والتأثير الحالي، والإجراء الموصى به، ومعلومات الإيقاف، ومعلومات الشكوى، وعناوين URL المُبلَّغ عنها.

هذا يجعل من الممكن إظهار حالة الامتثال مباشرة داخل بوابة العملاء أو النظام التشغيلي الخاص بك.

24 هل يمكنني استخدام NiceNIC Domain API v2 مع WHMCS؟

نعم. توفر NiceNIC تكاملًا مسجِّلًا مع WHMCS للشركات التي تستخدم بالفعل WHMCS للفوترة والتزويد.

استخدم Domain API v2 المباشر عند بناء تطبيقك أو سير العمل الخاص بك. استخدم تكامل WHMCS عندما تريد دمج عمليات النطاق في بيئة WHMCS موجودة.

عرض تكامل WHMCS →

التطوير والدعم

ابنِ بأمان واعرف ما يجب إرساله عندما تحتاج إلى مساعدة.

4 أسئلة
25 ما هي لغات البرمجة التي يمكنني استخدامها؟

يمكن لأي لغة برمجة أو بيئة تشغيل من جانب الخادم قادرة على إرسال طلبات HTTPS وتحليل JSON التكامل مع Domain API v2.

تشمل الخيارات الشائعة PHP وPython وNode.js وJava. احتفظ ببيانات اعتماد API على جانب الخادم ولا تكشف أبدًا عن API Secret الخاص بك في JavaScript من جانب المتصفح أو في رمز عميل قابل للتنزيل.

26 هل توجد حدود لمعدل استخدام API؟

قد يتم تطبيق تحديد معدل الاستخدام لحماية استقرار API وأمان المنصة.

إذا كان من المتوقع أن يولد تكامل الإنتاج لديك حجم طلبات مرتفعًا ومستمرًا، فاتصل بـ NiceNIC قبل الإطلاق لمراجعة نمط الاستخدام المتوقع.

27 ما الذي يجب أن أدرجه عند الاتصال بالدعم بخصوص مشكلة في API؟

قم بتضمين الطابع الزمني للطلب، وفئة API والإجراء، واسم النطاق عند الاقتضاء، ومعاملات الطلب غير الحساسة، ورمز الاستجابة والرسالة المرتجعة، وما إذا كان الطلب قد جاء من Sandbox أو Production.

لا تدرج أبدًا API Secret الكامل في تذكرة دعم عادية.

إرسال تذكرة ←

28 أين يمكنني العثور على معاملات الطلب الكاملة وأمثلة التعليمات البرمجية؟

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

يشرح قسم الأسئلة الشائعة السلوك العام لواجهة برمجة التطبيقات (API)؛ ويجب اعتبار توثيق كل نقطة نهاية على حدة المصدر الموثوق لتنسيق الطلب الدقيق.

افتح توثيق واجهة برمجة التطبيقات (API) ←

لم يتم العثور على أسئلة مطابقة جرّب كلمة رئيسية أقصر مثل "منطقة الاختبار" أو "التسعير" أو "التحويل" أو "201".

هل أنت مستعد لبدء البناء؟

اختبر تكاملك في بيئة اختبار API، ثم اربط حسابك في NiceNIC عندما تكون مستعدًا للانتقال إلى الإنتاج.

حقوق النشر © 2006–2026 NICENIC INTERNATIONAL GROUP CO., LIMITED. جميع الحقوق محفوظة.