أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
الانتقال إلى
مستندات Apigee X. info
بصفتك موفّر واجهة برمجة تطبيقات، أنت بحاجة إلى طريقة لعرض واجهات برمجة التطبيقات، وتثقيف المطوّرين بشأنها، وتسجيلهم، والسماح لهم بتسجيل التطبيقات. توفر لك Apigee Edge بوابة خدمات المطوّرين التي يمكنك استخدامها لإنشاء موقع ويب مخصص وإطلاقه لتوفير هذه الخدمات لمجتمع المطوّرين. لمزيد من المعلومات حول بوابات المطوّرين، يُرجى الاطّلاع على مقالة ما هي بوابة المطوّرين؟
تصف الأقسام التالية المفاهيم الرئيسية التي يجب فهمها قبل تحديد المشاكل وحلّها في بوابة مخصّصة للمطوّرين.
آلية عمل SmartDocs
يمكن استيراد مواصفات OpenAPI (JSON أو YAML) أو WADL التي تصف واجهة برمجة التطبيقات إلى SmartDocs واستخدامها لنشر مستندات مرجع واجهة برمجة التطبيقات على البوابة. تظهر مستندات مرجع واجهة برمجة التطبيقات تلقائيًا ضمن علامة التبويب "واجهات برمجة التطبيقات" على البوابة. يكتشف المطوّرون مستندات واجهة برمجة التطبيقات من خلال البوابة ويمكنهم تقديم طلبات مباشرة إلى واجهة برمجة التطبيقات. بما أنّ طلبات واجهة برمجة التطبيقات تنشأ من متصفّح، يجب إتاحة ميزة "مشاركة الموارد مع نطاقات خارجية" (CORS) لضمان نجاحها. توفر ميزة CORS الخادم الوكيل "smartdocs" على Edge (في مؤسسة "VALIDATE") الذي يعمل كخادم وكيل لجميع طلبات SmartDocs إلى نقطة النهاية المقصودة. يتم إنشاء الخادم الوكيل "smartdocs" عند تثبيت SmartDocs.
على سبيل المثال:
يظهر عنوان URL للخادم الوكيل smartdocs كخاصية قابلة للإعداد في "الإعدادات" -> SmartDocs -> عنوان URL للخادم الوكيل SmartDocs. قد تحتاج إلى تعديل عنوان URL هذا إذا كانت واجهة برمجة التطبيقات على شبكة خاصة وكانت الطلبات المباشرة لواجهة برمجة التطبيقات باستخدام SmartDocs من البوابة غير ناجحة.
كيفية تواصل بوابة المطوّرين مع Edge
تخزّن بوابة مخصّصة للمطوّرين معظم المعلومات التي تعرضها وتسترجعها من Edge، بما في ذلك Smartdocs والمطوّرون والمنتجات وتطبيقات المطوّرين. يمكن ضبط معلومات مؤسسة Edge وبيانات اعتماد مشرف المطوّرين باستخدام أمر القائمة "الإعدادات" -> "بوابة المطوّرين".
لمزيد من المعلومات، يُرجى الاطّلاع على مقالة التواصل بين البوابة وEdge.